Claude Managed Agents：用一次 Dream 审查记忆

针对获准的会话手动运行一次 Claude Dream，检查并修正独立的输出记忆存储，再将审查过的记忆附加到后续会话。

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 个字符；它不是精确修改某条记忆中一句话的可靠方式。

Terminal

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：

Terminal

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 审查存储。

Terminal

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 安全转义内容。

Terminal

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 ，并审查之后的写入。

Terminal

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停止。用这个文档接口发送问题、读取回答：

Terminal

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 密钥、代理、环境及会话要求。没有任何页面证明本指南做过实际运行或取得质量改进。

用一次 Dream 审查 Claude Managed Agent 的记忆存储

关键变化

开始前的准备

运行并跟踪一次 Dream

检查并修正独立存储

只向后续会话附加接受的记忆

来源与延伸阅读

继续关注变革。

用 Claude 将核查过的 PDF 证据制作成 PowerPoint 演示文稿

在 Obsidian 保存一份联系人记录，并核对 Codex 的回答

创建并检查 Pomelli Business Profile

查找报道。

探索 BIG CHANGE。

查找报道。

探索 BIG CHANGE。

用一次 Dream 审查 Claude Managed Agent 的记忆存储

关键变化

开始前的准备

运行并跟踪一次 Dream

检查并修正独立存储

只向后续会话附加接受的记忆

来源与延伸阅读

值得了解，值得分享。

继续关注变革。

用 Claude 将核查过的 PDF 证据制作成 PowerPoint 演示文稿

在 Obsidian 保存一份联系人记录，并核对 Codex 的回答

创建并检查 Pomelli Business Profile

纵览全局，按自己的节奏。

您的隐私，由您决定。

您的隐私，由您决定。