Markdown 版本

AI-translated from English; not yet reviewed by a fluent editor.

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

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

By BIG CHANGE Editorial

Published: 2026-10-20T01:54:53.933Z
Updated: 2026-10-20T01:54:53.933Z
Canonical: https://bigchange.ai/blog/claude-managed-agents-reviewed-dream-memory-guide

![Conceptual charcoal illustration of one reviewer at a desktop monitor comparing two separate areas of indistinct text; one line on the right is orange.](https://bigchange.ai/api/media/file/claude-dream-reviewed-memory-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

Claude Managed Agent 可以通过记忆存储在会话间保留笔记，但笔记可能重复或过时。Anthropic 的 [Dreams 研究预览](https://platform.claude.com/docs/en/managed-agents/dreams) 可以读取一份存储和过往会话，写入另一份提议的存储。本指南向具有所需权限的开发者介绍如何运行 **一次手动 Dream**，检查保留内容，只将接受的记忆附加到后续会话。

这是文档型操作流程，已于 2026 年 10 月 20 日核对 Anthropic 现行 Managed Agents 指南。BIG CHANGE 没有运行 Dream、检查真实输出、测试账号访问或测量费用和改进。流程结束于一份经过审查的存储被一个后续会话使用；不设置定期运行、评分或向其他代理自动共享记忆。

## 关键变化

- **变化是什么：** Dream 可将现有记忆存储和 1–100 个选定会话的文字记录综合成新的存储，不改动输入。
- **为什么重要：** 独立输出让所有者有机会在其他会话读取前，将新增或浓缩的笔记与原始证据比较。
- **需要留意：** Dreams 需要单独的研究预览权限。作业完成只产生候选存储，并非已批准的事实或偏好。

## 开始前的准备

你需要 Claude Console 账号、API 密钥、具备代理工具集的现有 Managed Agent、运行环境，以及 [快速入门所述的 Managed Agents 测试权限](https://platform.claude.com/docs/en/managed-agents/quickstart)。还需要 **独立的 Dreams 研究预览权限**。仅有 Managed Agents 测试权限不能证明具备此资格。发送请求前，通过 [Dreams 访问途径](https://platform.claude.com/docs/en/managed-agents/dreams) 确认。

选择一份现有记忆存储及 1–100 个真实、相关、已完成、且获准共同处理内容的会话。如果有会话记录但无存储， [记忆指南](https://platform.claude.com/docs/en/managed-agents/memory#create-a-memory-store) 说明了如何创建空存储。使用限定范围的名称和描述。代理需要文档所述工具集才能读写已附加存储。创建输入会话时就附加存储，运行中的会话不能事后新增。只有需要保存记忆时才使用 `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` ，具体参见 [快速入门](https://platform.claude.com/docs/en/managed-agents/quickstart#install-the-sdk) 。通过惯用的秘密管理方式设置并 **导出** `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

1. 先读取输入存储和选定会话，记录真实标识符，以及与任务有关的记忆路径和内容。设定窄范围整理目标，例如保留有文档依据的项目惯例、删除被取代的笔记。运行结束前保持存储和会话可用。运行中输入存储被归档或删除，或输入会话被删除，都可能导致 Dream 失败。
2. 使用现有存储和会话创建 Dream。本例文档所用模型为 `claude-opus-5-5`； [Anthropic 也列出其他支持的预览模型](https://platform.claude.com/docs/en/managed-agents/dreams#create-a-dream)。可选的 `instructions` 可引导整体综合，最多 4096 个字符；它不是精确修改某条记忆中一句话的可靠方式。

```bash
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."
  }'
```

3. 把返回的 `drm_...` 标识符保存为 `dream_id`。响应 `pending` 表示作业已创建并排队。轮询 **同一个标识符** ，直到状态为 `completed`、 `failed` 或 `canceled`：

```bash
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` 字段报告令牌数，但最终收费取决于实际使用量和价格。本指南没有测得成本或完成时间。

## 检查并修正独立存储

4. 当 `status` 达到 `completed`后，获取 `memory_store_id` ，它来自 `memory_store` 条目，位于 `outputs` ，并将其设为 `output_store_id`。使用 **记忆** 测试版请求头列出该存储的记忆，逐条获取需要检查的内容。遍历所有列表页，检查完整内容，包括路径和哈希。也可在 Console 审查存储。

```bash
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"
```

5. 将每项保留或综合的论断与相关来源会话和旧存储比较。检查实际依据、所属用户或项目是否正确，以及新指令是否矛盾。查找秘密、个人数据及不可信内容夹带的指令。对每条重要记忆记录保留、修正或舍弃决定。Dream **不会改动** 输入存储，也不改来源会话；只有经过审查的输出才能继续使用。

要定点修正，先获取输出记忆当前的 `content_sha256`。将真实的 `mem_id`、新取得的哈希和修正内容，通过 [文档规定的记忆更新方式](https://platform.claude.com/docs/en/managed-agents/memory#update-a-memory)提交。哈希不匹配表示发生过其他写入：重新读取、解决差异，再用新哈希重试。下面语法体现该前置条件。把审查后的修正作为 `corrected_content` 通过 JSON 编码器输入；本例用 Python 3 安全转义内容。

```bash
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。达到存储上限后新记忆写入失败，现有记忆仍可读写。依赖新增写入前，缩小范围或安全清理拥挤存储。

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

6. 输出通过审查后，用该存储创建 **新的** 会话。本例附加权限为 `read_only`，适用于不应改动已审查记录的检查。后续需要增加记忆时，有意授予 `read_write` ，并审查之后的写入。

```bash
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 的 [快速入门消息流程](https://platform.claude.com/docs/en/managed-agents/quickstart#create-your-first-session) 会开启事件流、发送 `user.message`、输出 `agent.message` 文本，并在 `session.status_idle`停止。用这个文档接口发送问题、读取回答：

```bash
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 任务，请参阅 [我们的并行文档审阅指南](https://bigchange.ai/blog/claude-managed-agents-parallel-document-review-guide)。我们的 [Hy Memory 2.0 报道](https://bigchange.ai/blog/hy-memory-2-sdk-chat-work-coding-context) 涉及不同的记忆 SDK 和其特定范围检索流程。

## 来源与延伸阅读

- Anthropic 的 [Dreams 指南](https://platform.claude.com/docs/en/managed-agents/dreams) 介绍研究预览访问、输入、创建和轮询、状态、独立输出、计费及失败行为。关于记忆存储测试版请求头的泛化表述，与现行专项记忆指南冲突；直接存储调用应以后者为准。
- Anthropic 的 [记忆指南](https://platform.claude.com/docs/en/managed-agents/memory) 介绍存储创建、会话附加、专用请求头、列表、哈希保护修改、版本和保留。警告可写存储污染以及不可逆归档和删除。
- Anthropic 的 [Managed Agents 快速入门](https://platform.claude.com/docs/en/managed-agents/quickstart) 说明账号、API 密钥、代理、环境及会话要求。没有任何页面证明本指南做过实际运行或取得质量改进。

## Sources

- [Anthropic Dreams](https://platform.claude.com/docs/en/managed-agents/dreams) — 研究预览访问、一份输入存储和 1–100 个会话、创建/轮询/状态/输出、支持模型、可选指令、计费及错误。通用记忆存储请求头表述与现行专项指南冲突，直接存储请求应遵循后者。没有观察到运行或结果。
- [Anthropic：使用代理记忆](https://platform.claude.com/docs/en/managed-agents/memory) — 直接存储专用测试版请求头、创建及附加、访问及挂载路径、列出/读取/哈希保护修改、上限、版本保留、历史清除及归档/删除后果。警告不可信内容污染可写记忆，不验证 Dream 输出。
- [Anthropic Managed Agents 快速入门](https://platform.claude.com/docs/en/managed-agents/quickstart) — Console/API 密钥、代理、环境和会话设置要求。Managed Agents 权限本身不能证明 Dreams 研究预览资格。
- [BIG CHANGE：构建并行审阅文档的 Claude 工作流](https://bigchange.ai/blog/claude-managed-agents-parallel-document-review-guide) — 另一项并行文档审阅任务的 Managed Agents 背景报道。相关但独立，不是同一事件后续，也不是 Dream 结果的证据。
- [BIG CHANGE：Hy Memory 2.0 让代理用三种方式保留上下文](https://bigchange.ai/blog/hy-memory-2-sdk-chat-work-coding-context) — 不同 SDK 及限定范围检索的背景报道。不能证明 Anthropic Dream 行为，也不是“In this story”的上级文章。
Markdown 版本

查找报道。

探索 BIG CHANGE。

查找报道。

探索 BIG CHANGE。

Markdown 版本

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

您的隐私，由您决定。

您的隐私，由您决定。
