cwc-workshops Dreams API参考:创建、监控、检索与输出Store获取全流程 cwc-workshops Dreams API参考创建、监控、检索与输出Store获取全流程【免费下载链接】cwc-workshops项目地址: https://gitcode.com/GitHub_Trending/cw/cwc-workshopscwc-workshops 是 Anthropic 官方 Code with Claude 系列工作坊的开源资料库。本文带你走通其中Agents That Remember工作坊的核心实操用Dreams API为 Managed Agent 做跨会话记忆整合——从创建 dream、监控运行进度到检索结果、获取输出 memory store一条命令都不落。学完后你的智能体将告别金鱼记忆进化为可靠同事 →‍为什么需要 Dreams API想象这样一个场景你在会话 A 里告诉智能体我昨天参加了 CMA 演讲转头在会话 B 里问它讲了什么——它一脸茫然。这就是失忆型智能体的基线每个 session 彼此隔离没有任何东西会持久化。Workshop 用一张图讲清了三种记忆的分工机制定位特点Session 会话临时上下文便宜、实时但会话一结束就清空Memory Store 记忆库持久化文件系统智能体可跨会话读写实时积累Dreaming 梦境服务批量整理提炼读取历史记录把原始对话蒸馏成结构化记忆何时用 memory store智能体需要当下就记住时。何时用 Dreaming想让智能体重新组织记忆、或消化一批历史会话记录时。完整教学文档见 agents-that-remember/README.md。前置准备一键 Bootstrap 脚本开始 Dreams API 全流程前需要三样东西一个 agent、一个 environment、以及几段历史会话当作梦境素材。工作坊提供了一键脚本 agents-that-remember/scripts/bootstrap.sh它会自动下载预览版antCLI按你的系统架构选择创建或复用名为cwc-agent/cwc-env的 agent 与环境播种 3 个历史会话——主题演讲笔记、课程心得、日程安排正好作为 Dreaming 的输入素材把所有 ID 写入.bootstrap-varssource一下即可。⚠️ 前提条件你的组织需先加入research preview研究预览计划否则看不到beta:dreams命令。./scripts/bootstrap.sh source .bootstrap-vars脚本是幂等的重复运行会跳过 CLI 下载、按名称复用 agent 和环境只追加新的历史会话——相当于给 Dreaming 攒更多素材。第一步创建 Dream创建全流程Dream 是一个异步批量任务它读取指定的 memory store 历史会话记录跑一遍模型把提炼后的记忆写进一个全新的 memory store。创建命令只需三个关键参数DREAM$(ant beta:dreams create \ --model claude-opus-4-7 \ --input {\type\:\memory_store\,\memory_store_id\:\$MEM\} \ --input {\type\:\sessions\,\session_ids\:[\$HIST1\,\$HIST2\,\$HIST3\]} \ --instructions I am attending CwC, and I want to remember what Ive learned. \ --format json | jq -r .id)参数速查表 参数作用小提示--model梦境任务使用的模型官方示例使用claude-opus-4-7--input可多次声明读取来源支持memory_store和sessions两种类型--instructions引导提示词决定智能体如何组织提取内容值得反复调优--format jsonJSON 输出配合jq提取.id拿到 dream IDinstructions是整个流程里最值得迭代的杠杆换一句引导语输出记忆库的文件结构可能就完全不同。不用 CLI在 Console 的Dreams页面点击Dream粘贴会话 ID 列表echo $HIST1,$HIST2,$HIST3一键生成勾选Use custom instructions填入引导语效果相同。第二步监控运行进度Dream 是异步任务创建后后台运行。Console 监控推荐打开工作区的Dreams页面可以看到实时进度任务完成后还会提供一份快照对比——直观展示梦境对记忆做了哪些改动 CLI 轮询随时用retrieve拉取 dream 对象从outputs字段判断是否已产出ant beta:dreams retrieve --dream-id $DREAM --format json第三步检索结果与获取输出 StoreDream 完成后它的outputs数组里装着新生成的 memory store。取 ID 只需一行jqMEM_OUT$(ant beta:dreams retrieve --dream-id $DREAM --format json \ | jq -r .outputs[] | select(.typememory_store) | .memory_store_id)拿到输出 Store 后立刻验证写入内容ant beta:memory-stores:memories list --memory-store-id $MEM_OUT还可以进一步查看智能体具体记住了什么、怎么组织的ant beta:memory-stores:memories retrieve—— 查看单条记忆全文默认--view fullant beta:memory-stores:memory-versions list—— 查看每条记忆的完整编辑历史。对比技巧在 Console 的Memory Stores里把输出 Store 与原始$MEM放在一起对比——Claude 会重新归类文件、合并碎片信息效果常常超出预期。第四步让新 Store 上岗完整闭环注意一个细节memory store 只在创建会话时挂载运行中的会话无法原地更换。所以替换的正确姿势是——用$MEM_OUT创建下一个会话SES_E$(ant beta:sessions create --agent $AGENT --environment-id $ENV \ --title Post-dreaming recall \ --resource {\type\:\memory_store\,\memory_store_id\:\$MEM_OUT\} \ --format json | jq -r .id)现在问它我参加过哪些会话有哪些资源链接标记过哪些待办——它能准确回忆出自己从未参与过的历史会话内容。这就是 Goldfish → Colleague 的完整闭环 ✨收尾可选操作归档旧 Storeant beta:memory-stores archive --memory-store-id $MEM保持工作区整洁。常见问题 FAQQ1Dream 和 memory store 会互相覆盖吗不会。Dream 读取源 store 是只读行为结果写入一个全新的store旧 store 安然无恙可自由对比和回滚。Q2为什么智能体记得的内容和我预期不同调整两处提示词挂载 store 时的prompt指导何时读、写什么、怎么组织和 dream 的--instructions指导如何蒸馏。Workshop 专门设计了改提示词重跑的验证环节。Q3可以只对部分历史会话做梦吗可以。--input的sessions类型接受任意session_ids列表精确挑选素材即可。总结一张表带走全流程阶段核心命令产出 创建ant beta:dreams createdream ID 监控Console Dreams 页 /retrieve轮询实时进度 快照对比 检索ant beta:dreams retrieve --dream-idoutputs 中的新 store ID 输出 Storememory-stores:memories list结构化记忆 编辑历史 上岗用新 store ID 创建下一会话跨会话记忆生效带走一句话live 状态交给 memory store批量蒸馏交给 Dreaming。今晚就可以把它指向你自己的业务——建一个 store、挂到你的 agent 上对过去一周的会话跑一次 Dreaming看看智能体如何把聊天记录变成组织过的记忆。更多工作坊内容多智能体拆解、评测驱动开发、Deal Desk 等可浏览仓库根目录说明 README.md。【免费下载链接】cwc-workshops项目地址: https://gitcode.com/GitHub_Trending/cw/cwc-workshops创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考