Claude Managed Agent 可透過記憶儲存庫在工作階段之間保留筆記,但筆記可能重複或過時。Anthropic 的 Dreams 研究預覽 可以讀取一份儲存庫及過往工作階段,寫入另一份提議的儲存庫。本指南向具備所需存取權的開發者說明如何執行 一次手動 Dream,檢查保留了什麼,僅將接受的記憶附加至後續工作階段。
這是文件型流程,已於 2026 年 10 月 20 日核對 Anthropic 現行 Managed Agents 指南。BIG CHANGE 沒有執行 Dream、檢查真實輸出、測試帳號存取或測量費用與改進。流程結束於一份經檢閱儲存庫供一個後續工作階段使用;不設定週期執行、評分或向其他代理自動共用記憶。
關鍵變化
- 改變了什麼: Dream 可將既有儲存庫及 1–100 個所選工作階段的文字紀錄綜整為新儲存庫,不改動輸入。
- 為何重要: 獨立輸出讓擁有者有機會在另一工作階段讀取前,將新筆記或濃縮筆記與原始證據比較。
- 需要留意: Dreams 需要獨立研究預覽權限。工作完成產生的是候選儲存庫,不是核准的事實或偏好。
開始前的準備
你需要 Claude Console 帳號及 API 金鑰、配備代理工具集的現有 Managed Agent、環境,以及 快速入門所述的 Managed Agents 測試權限。也需要 獨立的 Dreams 研究預覽權限。只有 Managed Agents 測試權限不代表具備這項資格。送出要求前,透過 Dreams 存取途徑 確認。
選擇一份既有記憶儲存庫及 1–100 個真實、相關、已完成且獲准共同處理內容的工作階段。如果有紀錄但沒有儲存庫, 記憶指南 說明如何建立空白儲存庫。使用限定範圍的名稱和描述。代理需要文件所述工具集才能讀寫附加儲存庫。建立輸入工作階段時就附加,執行中的工作階段不能事後新增。需要儲存記憶時才使用 read_write 。預設是 read_write,所以僅可查閱的內容應指定 read_only 。核對傳回資源的 mount_path ,不要猜測。
與資料負責人檢閱擬用輸入。工作階段可能有客戶材料、私有專案細節或不可信文字。Anthropic 警告,攻擊者控制的提示或工具結果可能污染可寫儲存庫並影響後續工作階段。決定誰可檢查 Dream 輸出,以及哪些事實可持續保留。保存人能查閱的來源工作階段、先前記憶內容與檢閱決策紀錄。
在相容 Bash 的 shell 執行範例,cURL 須支援 --fail-with-body ,另需 Python 3 進行修正和最終工作階段檢查。PowerShell 的引號與環境變數語法不同,需要調整命令。安裝 Anthropic Python SDK 的命令為 pip install anthropic ,詳見 快速入門 。透過慣用的機密管理方式設定並 匯出 ANTHROPIC_API_KEY ,讓 cURL 和 Python SDK 都能使用。將 store_id、 session_a、 session_b、 agent_id 和 environment_id 設定為你 自己的 工作區傳回的識別碼。範例使用兩個工作階段;請使用 1 至 100 個真實識別碼。不要把金鑰放入共用記錄或草稿。測試版標頭必須準確:直接 記憶儲存庫 呼叫只用 agent-memory-2026-07-22 ;工作階段呼叫使用 managed-agents-2026-04-01;Dream 呼叫同時使用 managed-agents-2026-04-01 和 dreaming-2026-04-21。現行專門記憶指南表示,在儲存庫要求中合併前兩個標頭會傳回 HTTP 400。Anthropic SDK 會自動設定合適標頭。
執行並追蹤一次 Dream
- 先讀輸入儲存庫與所選工作階段,記錄真實識別碼以及與任務有關的記憶路徑和內容。設定窄範圍整理目的,例如保留有文件依據的專案慣例、移除已取代筆記。執行完成前保持儲存庫與工作階段可用。期間若輸入儲存庫封存或刪除,或輸入工作階段刪除,Dream 可能失敗。
- 以既有儲存庫和工作階段建立 Dream。本例文件使用的模型是
claude-opus-5-5; Anthropic 也列出其他支援的預覽模型。選用的instructions可引導整體綜整,最多 4096 個字元,不是精確編輯某條記憶中一句話的可靠方式。
curl -sS --fail-with-body https://api.anthropic.com/v1/dreams \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: managed-agents-2026-04-01,dreaming-2026-04-21" \
-H "content-type: application/json" \
--data '{
"inputs": [
{"type": "memory_store", "memory_store_id": "'"$store_id"'"},
{"type": "sessions", "session_ids": ["'"$session_a"'", "'"$session_b"'"]}
],
"model": "claude-opus-5-5",
"instructions": "Preserve documented project conventions; drop superseded or one-off notes."
}'- 將傳回的
drm_...識別碼保存為dream_id。回應pending表示工作已建立並排入佇列。輪詢 同一識別碼 ,直到狀態為completed、failed或canceled:
curl -sS --fail-with-body "https://api.anthropic.com/v1/dreams/$dream_id" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: managed-agents-2026-04-01,dreaming-2026-04-21"讀取回應中的 status、 outputs、 usage 和 error 。 outputs 在 Dream 等待或剛開始執行時可能是空的,這本身不是再次提交工作的理由。Anthropic 稱執行可能花數分鐘到數小時,按所選模型標準 API 權杖價格計費。 usage 欄位回報權杖數,但最終費用取決於實際用量及價格。本指南沒有實測費用或完成時間。
檢查並修正獨立儲存庫
- 當
status達到completed後,取得memory_store_id,它來自memory_store項目,位於outputs,並設定為output_store_id。使用 記憶 測試版標頭列出此儲存庫的記憶,再個別取得要檢查的內容。遍歷全部清單頁,檢查完整內容,包括路徑和雜湊。也可在 Console 檢閱儲存庫。
curl -sS --fail-with-body "https://api.anthropic.com/v1/memory_stores/$output_store_id/memories?path_prefix=/" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: agent-memory-2026-07-22"
curl -sS --fail-with-body "https://api.anthropic.com/v1/memory_stores/$output_store_id/memories/$mem_id" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: agent-memory-2026-07-22"- 將每個保留或綜整的論述與相關來源工作階段及舊儲存庫比較。檢查實際依據、是否屬於正確使用者或專案,以及較新的指令是否矛盾。找出機密、個人資料及不可信材料夾帶的指令。對重要記憶逐項記錄保留、修正或捨棄決策。Dream 不會改動 輸入儲存庫,也不改來源工作階段;只有經檢閱輸出才能繼續使用。
定點修正時,先取得輸出記憶目前的 content_sha256。將真實的 mem_id、剛讀取的雜湊及修正內容,透過 文件所述的記憶更新方式提交。雜湊不符表示有其他寫入:重新讀取、解決差異,再用新雜湊重試。下列語法呈現此先決條件。以 corrected_content 透過 JSON 編碼器輸入檢閱後的修正;範例使用 Python 3 安全跳脫內容。
python3 -c 'import json,os; print(json.dumps({"content": os.environ["corrected_content"], "precondition": {"type": "content_sha256", "content_sha256": os.environ["mem_sha"]}}))' > correction.json
curl -sS --fail-with-body -X POST "https://api.anthropic.com/v1/memory_stores/$output_store_id/memories/$mem_id" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: agent-memory-2026-07-22" \
-H "content-type: application/json" \
--data-binary @correction.json編碼前設定並匯出 corrected_content 和 mem_sha ,檢查 correction.json,讓檔案與記憶位於相同私有資料界線。回讀後依保留政策刪除本機副本。重新讀取每條改動記憶。儲存庫最多有 10,000 條記憶,每條最多 100 kB。到上限後新記憶寫入失敗,既有記憶仍可讀寫。依賴新增寫入前,縮小範圍或安全清理擁擠儲存庫。
只將接受的記憶附加至後續工作階段
- 輸出通過檢閱後,以該儲存庫建立 新的 工作階段。本例附加權限為
read_only,適用於不應更動已檢閱紀錄的檢查。代理以後需要新增記憶時,有意授予read_write,並檢閱後續寫入。
curl -sS --fail-with-body https://api.anthropic.com/v1/sessions \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: managed-agents-2026-04-01" \
-H "content-type: application/json" \
--data '{
"agent": "'"$agent_id"'",
"environment_id": "'"$environment_id"'",
"resources": [
{"type": "memory_store", "memory_store_id": "'"$output_store_id"'", "access": "read_only"}
]
}'檢查新工作階段傳回的資源,確認目標儲存庫識別碼及實際 mount_path。將傳回的工作階段識別碼保存為 new_session_id 並匯出 shell 變數供 Python 讀取。針對已保留且來源驗證過的事實寫一個自然語言問題,設定並匯出為 memory_question。Anthropic 的 快速入門訊息流程 會開啟事件串流、傳送 user.message、輸出 agent.message 文字,並在 session.status_idle停止。用此文件介面傳送問題和讀取答案:
python3 - <<'PY'
import os
from anthropic import Anthropic
client = Anthropic()
session_id = os.environ["new_session_id"]
question = os.environ["memory_question"]
with client.beta.sessions.events.stream(session_id) as stream:
client.beta.sessions.events.send(
session_id,
events=[{"type": "user.message", "content": [{"type": "text", "text": question}]}],
)
for event in stream:
if event.type == "agent.message":
for block in event.content:
if block.type == "text":
print(block.text, end="")
elif event.type == "session.status_idle":
print()
break
PY比較串流答案、儲存文字與原始工作階段。無法追溯至這些證據時,合理答案也不夠。記錄 Dream 識別碼、接受的輸出儲存庫識別碼、比較決策、新工作階段識別碼及結果。替代儲存庫通過檢查前,保留輸入儲存庫。
若建立傳回存取或驗證錯誤,先檢查研究預覽資格、確切輸入識別碼及工作階段數,再改要求。仍在等待或執行時,繼續輪詢同一識別碼。狀態為 failed 或 canceled 的執行可能留下部分輸出儲存庫;檢查錯誤,不要將它當作核准記憶附加。後續工作階段無法使用已接受記憶時,檢查 該工作階段的資源及掛載路徑。執行中的工作階段不能再新增儲存庫。
記憶變更會建立版本。Anthropic 稱一般版本保留 30 天,活躍記憶的一些近期版本保留更久。刪除目前記憶 不會 刪除保留的歷史。恢復舊保留版本時,先讀取,再更新目前記憶或重建已刪記憶;沒有獨立恢復呼叫。保留期結束前匯出需要的歷史,並用文件所述遮除途徑處理敏感歷史內容。封存儲存庫不可逆,會變成唯讀並阻止新附加。刪除儲存庫會永久移除記憶與版本。驗證後續工作階段後,再依資料擁有者政策決定兩者。
關於先前另一項 Managed Agents 任務,請參閱 我們的平行文件檢閱指南。我們的 Hy Memory 2.0 報導 涉及不同的記憶 SDK 及其限定範圍回憶流程。
來源及延伸閱讀
- Anthropic 的 Dreams 指南 說明研究預覽存取、輸入、建立和輪詢、狀態、獨立輸出、計費及失敗行為。其泛稱的儲存庫測試版標頭與現行專門記憶指南衝突;直接儲存庫呼叫應以後者為準。
- Anthropic 的 記憶指南 說明建立儲存庫、工作階段附加、專用標頭、清單、雜湊保護修改、版本及保留,並警告可寫儲存庫污染及不可逆封存和刪除。
- Anthropic 的 Managed Agents 快速入門 說明帳號、API 金鑰、代理、環境及工作階段要求。這些頁面不證明本指南有實際執行或品質提升。



