Memories
Memories是關於你系統的已確認發現,由代理和你儲存,讓下一次調查從你已知的事情開始。筆記則是Polylane自己的每日總結。
它做什麼
一則記憶是一份帶有標題與標籤的markdown文件,記錄一個發現:一個已確認的故障模式、一個反覆出現的模式,或一個有證據支持的營運事實。代理在調查時會搜尋記憶,所以找到過一次的根本原因不會被重新發現。代理不會儲存使用者偏好、推測性的結論,或在拓樸中已經可見的設定。
記憶如何建立
當調查確認了一個根本原因或反覆出現的模式時,代理會用saveMemory儲存它,記錄發現、證據、受影響的資源與它來自的對話串。指令碼可以透過POST /v1/memories做同樣的事。
要自己寫一則,開啟Settings > Memories並選擇New memory,然後加入markdown內容、標籤與選填的標題。在對話串中,用白話請求即可:「Save a memory: checkout-api integration tests fail intermittently because the payment vendor's sandbox times out under parallel load, confirmed from pipeline logs showing 504 responses.」
記憶如何進入對話串
Polylane為每則記憶建立索引,可依語意與關鍵字搜尋。代理每次調查問題時都會搜尋工作區記憶並帶入相符的段落。你也可以把一則記憶附加到對話串,它的內容會直接進入對話。
儲存一次之後,這個發現能讓下一個調查checkout-api測試失敗的代理在深入挖掘前先排除已知的故障模式。用同樣的方式撰寫記憶:寫出服務、故障模式、證據與受影響的資源。當現實改變時,在記憶頁面使用Edit、Archive或Delete。
筆記
Polylane每天一次把當天的對話串活動總結成一則每日筆記,並且只在當天揭露了一個月後仍會成立的事實時,才更新唯一的一則工作區筆記。筆記來自與工作區共享或公開的對話串;沒有對話串活動的日子不會產生筆記。每個新對話串的簡報都包含工作區筆記與最近三則每日筆記,兩種筆記你都可以編輯、複製、下載或刪除。
| 種類 | 由誰撰寫 | 說明 | 何時查閱 |
|---|---|---|---|
| 記憶 | 代理或人,一次一個發現 | 具體、有證據支持、帶有標籤與來源的事實 | 一個發現應該跨調查留存 |
| 工作區筆記 | Polylane,每日,可編輯 | 關於工作區的長期事實:架構、工具、慣例、負責人 | 你想看看代理被告知了哪些關於工作區的事 |
| 每日筆記 | Polylane,每天一則,可編輯 | 以天為單位的模式與值得注意的訊號,而不是逐條流水帳 | 你想要一份當天活動樣貌的記錄 |