跳至內容

管理工作區記憶

本指南說明如何使用工作區的知識儲存庫。

開始之前要知道的重點是:記憶介面是檢閱介面,而不是撰寫介面。 事實與政策由代理寫入——經由 propose_fact 和 propose_policy,並以 supersede_fact 和 supersede_policy 取代它們。remember 會寫入一個以對話為界的熱層項目,consolidate_memory 之後可能把它提升為事實。已記錄的會議決定會收集到 decisions 領域;已完成的代理執行則不會有收集。你在這裏要做的是讀取它們寫下的內容、修正它、停用它,或刪除它。

記憶位於 設定 → 工作區 → 記憶(/workspaces/<id>/settings/memory)。它不是側邊欄頂層的目的地。

這個頁面正好有三個分頁。事實與政策會顯示即時數目;圖譜則不會:

  • 事實——工作區內的每一則事實,並顯示尚未被替代者的數目
  • 政策——按領域分組的規範性規則,並顯示啟用中的數目
  • 知識圖譜——領域、主題、事實與政策的互動畫布

領域不是你建立的東西。當代理寫入第一則事實或政策時,領域才會存在;介面中任何地方都沒有建立領域的控制項。

  1. 開啟事實分頁。
  2. 使用搜尋框縮小清單範圍。它只是對每則事實的領域、主題與內容進行純子字串篩選——沒有關鍵字索引,沒有排名。
  3. 使用範圍篩選顯示所有範圍、只顯示全工作區的事實,或某個程式庫的事實。
  4. 使用排序切換按近期程度或信心排序。
  5. 點擊一則事實的編輯控制項。

編輯對話框可讓你變更:

  • 領域——在領域之間移動事實
  • 主題——它的簡短標籤
  • 內容——知識文字
  • 信心——以 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(預設)。混合會融合四道聲部:詞彙、語意、時間與圖譜

因此代理與記憶頁面不會以相同方式為同一個查詢排名。當你想確認代理實際能回憶起甚麼時,直接問該代理。

事實會在寫入時嵌入,而且只有在已安裝裝置上的嵌入模型時才會這樣做。在 設定 → 伺服器 → 診斷與私隱 → 語意搜尋 下檢查它的狀態。如果你想要語意召回,請在代理開始寫入記憶之前安裝模型。