管理工作區記憶
本指南說明如何使用工作區的知識儲存庫。
開始之前要知道的重點是:記憶介面是檢閱介面,而不是撰寫介面。 事實與政策由代理寫入——經由 propose_fact 和 propose_policy,並以 supersede_fact 和 supersede_policy 取代它們。remember 會寫入一個以對話為界的熱層項目,consolidate_memory 之後可能把它提升為事實。已記錄的會議決定會收集到 decisions 領域;已完成的代理執行則不會有收集。你在這裏要做的是讀取它們寫下的內容、修正它、停用它,或刪除它。
記憶位於 設定 → 工作區 → 記憶(/workspaces/<id>/settings/memory)。它不是側邊欄頂層的目的地。
三個分頁
標題為「三個分頁」的章節這個頁面正好有三個分頁。事實與政策會顯示即時數目;圖譜則不會:
- 事實——工作區內的每一則事實,並顯示尚未被替代者的數目
- 政策——按領域分組的規範性規則,並顯示啟用中的數目
- 知識圖譜——領域、主題、事實與政策的互動畫布
領域不是你建立的東西。當代理寫入第一則事實或政策時,領域才會存在;介面中任何地方都沒有建立領域的控制項。
檢閱並修正一則事實
標題為「檢閱並修正一則事實」的章節- 開啟事實分頁。
- 使用搜尋框縮小清單範圍。它只是對每則事實的領域、主題與內容進行純子字串篩選——沒有關鍵字索引,沒有排名。
- 使用範圍篩選顯示所有範圍、只顯示全工作區的事實,或某個程式庫的事實。
- 使用排序切換按近期程度或信心排序。
- 點擊一則事實的編輯控制項。
編輯對話框可讓你變更:
- 領域——在領域之間移動事實
- 主題——它的簡短標籤
- 內容——知識文字
- 信心——以 5% 為級距的滑桿
儲存即可寫回。沒有新增事實按鈕;對話框只會在既有的資料列上開啟。
查看已替代的事實
標題為「查看已替代的事實」的章節事實分頁有一個顯示已替代開關。已替代的事實預設會隱藏,並由該開關顯示;稽核軌跡就在那裏——替代永遠不會刪除。
刪除一則事實
標題為「刪除一則事實」的章節使用一則事實的刪除控制項並確認。這是真正的刪除,不是替代:把它用於根本不該記錄的事實,而讓代理取代那些_內容_已有變更的事實。
管理政策
標題為「管理政策」的章節政策分頁按領域把啟用中的政策分組,並把停用中的降級到末尾的一節。就每條政策,你可以:
- 編輯它
- 刪除它
- 停用 / 啟用它——可逆的選項,通常也是正確的選擇。只有啟用中的政策才會到達代理提示。
與事實一樣,沒有建立控制項。
探索知識圖譜
標題為「探索知識圖譜」的章節知識圖譜分頁把領域、主題、事實與政策鋪陳為可導覽的節點畫布——平移、縮放、拖曳節點。點按節點會開啟它的詳情面板,從那裏可進入同樣的編輯對話框。這是查看哪些領域確實有內容的最快方法。
編輯代理的工作記憶
標題為「編輯代理的工作記憶」的章節工作記憶是每個代理私有的記事板,在派發時注入其提示。代理會自己用 record_observation 和 update_my_notes 寫入它,但你可以直接讀取和編輯它:
設定 → 工作區 → 代理 → 選擇代理 → 記憶分頁。
存取授權
標題為「存取授權」的章節記憶存取授權按領域把代理的角色對應到權限(none、read、write)。用 memory_access_grant.* 操作寫入它們。
關於它們如何解析,有兩點要理解:
- 讀取採取失效開放。 當 (role, domain) 配對沒有授權資料列時,有效權限是
read。唯一在沒有write時會拋出的寫入是propose_policy。事實寫入不受授權限制。 - 授權以代理的角色為鍵。 提案工具會把缺少的
agent_role預設為general。為另一個角色寫入的授權不會約束那些代理;general授權則會。
搜尋在各處並不相同
標題為「搜尋在各處並不相同」的章節有三種不同的東西都叫做「記憶搜尋」,而它們並不一致:
| 位置 | 作用 |
|---|---|
| 事實分頁的搜尋框 | 對用戶端已載入的事實進行子字串篩選 |
memory_fact.search RPC 操作 |
僅 FTS5 關鍵字搜尋——精簡用戶端無法附上查詢嵌入,因此混合搜尋留在主機內部 |
代理端的 search_memory 工具 |
keyword、semantic 或 hybrid(預設)。混合會融合四道聲部:詞彙、語意、時間與圖譜 |
因此代理與記憶頁面不會以相同方式為同一個查詢排名。當你想確認代理實際能回憶起甚麼時,直接問該代理。
事實會在寫入時嵌入,而且只有在已安裝裝置上的嵌入模型時才會這樣做。在 設定 → 伺服器 → 診斷與私隱 → 語意搜尋 下檢查它的狀態。如果你想要語意召回,請在代理開始寫入記憶之前安裝模型。