cwc-workshops记忆调优指南改一行prompt让Agent的记忆文件结构大不同【免费下载链接】cwc-workshops项目地址: https://gitcode.com/GitHub_Trending/cw/cwc-workshopscwc-workshops是 Anthropic 官方 Code with Claude 工作坊的开源实操合集覆盖 Claude Managed Agents、多智能体协作、Agent 记忆与评估驱动开发等实战主题。本文聚焦其中「Agents That Remember」工作坊教你只改一行 prompt就能让 Agent 写入记忆存储Memory Store的文件结构大不同并借助 Dreaming 服务把历史会话整理成结构化记忆——让你的 Agent 从金鱼进化成靠谱的同事。为什么 Agent 会忘事先复现金鱼基线 默认情况下Claude Managed Agent 的每个会话Session都是隔离的上下文你在 A 会话告诉它的事情B 会话里它完全不知道。工作坊用了一个很直观的实验来证明这一点会话 A告诉 Agent我昨天中午参加了 CMA 演讲学到了一些新特性笔记已上传会话 B问它CMA 演讲发布了哪些特性把我的笔记链接给我结果Agent 一头雾水——这就是所谓的goldfish金鱼基线这个实验的完整脚本含 CLI 与控制台两种操作方式都在 agents-that-remember/README.md 中项目根目录的 README.md 也列出了全部八个工作坊的主题。记忆调优工具箱三大件各司其职 工作坊把 Agent 的记忆体系拆成三个层次这也是你后续调优时能拨动的全部旋钮层级作用特点Session会话当前对话上下文便宜、实时但什么都不持久化Memory Store记忆存储类文件系统的持久存储Agent 跨会话可读写把同一存储挂到多个会话 共享记忆Dreaming做梦服务批处理作业读取记忆存储 历史会话记录提炼后写入新记忆存储批量、蒸馏让 Agent 从自己的转录中升级一句话选型需要立刻携带状态跨会话 → 用 Memory Store想让记忆重新组织、或吸收更多历史转录 → 用 Dreaming。一行 prompt 调优改这一行文件结构就变了 真正让 Agent学会如何记笔记的不是存储本身而是挂载存储时附带的一行 prompt。创建会话挂载记忆存储时资源对象resource支持两个可选字段access控制读写权限而prompt会被注入到系统提示词中直接指导 Agent——何时读、写什么、如何组织。工作坊原文称它为This is the lever youll iterate on这就是你要反复迭代的旋钮。工作坊给出的示例只有一行{ type: memory_store, memory_store_id: mem_xxx, prompt: Track which CwC sessions I have attended, resource links I mention, and anything I flag to follow up on., access: read_write }这行 prompt 明确告诉 Agent 要追踪三类信息参加过的场次、提到的资源链接、标记待跟进的事项。Agent 会据此决定在记忆存储里创建哪些文件、如何分目录、写什么内容。工作坊特意设置了一个 Check-in 环节改动prompt后重跑一遍——记忆文件结构会不会变答案几乎总是会。这就是改一行 prompt记忆文件结构大不同的全部秘密prompt 决定了记忆的目录学。快速上手Memory Store 搭建五步走 以下命令均来自 agents-that-remember/scripts/bootstrap.sh脚本是幂等的重复执行会复用已创建的 Agent 与环境只追加新的历史会话第 1 步获取代码git clone https://gitcode.com/GitHub_Trending/cw/cwc-workshops cd cwc-workshops/agents-that-remember第 2 步配置 API Key——复制.env.example为.env并填入ANTHROPIC_API_KEY注意需先将你的组织加入 research preview 才可用后续能力。第 3 步一键引导./scripts/bootstrap.sh source .bootstrap-vars脚本会自动下载预览版antCLI、创建 Agent 与环境、播种三个历史会话并把所有 ID 写入.bootstrap-vars。第 4 步带记忆跑对照实验——创建两个会话并挂载同一记忆存储带上上面那行prompt在会话 1 告诉它信息会话 2 让它回忆。第 5 步检查 Agent 写了什么——用ant beta:memory-stores:memories list列出 Agent 创建的文件条目再用memory-versions查看每个条目的完整编辑历史你会直观看到 Agent选择记住什么以及如何组织。记忆结构调优这行 prompt 怎么写 ✍️调好那行prompt有章可循几个实操技巧列明记忆类目像示例一样把要追踪什么枚举出来场次、链接、待办Agent 会为每类信息建立独立文件写明组织方式可以进一步提示按日期、按主题或按项目分文件文件命名与层级会随之改变限定读写时机写明回答前先读存储用户提到新资源时立即写入记忆质量立刻提升小步对比迭代每次只改一处 prompt用文件树 编辑历史做前后对比这正是工作坊反复强调的实验方法Dreaming 记忆整理一行 instructions 重组全部记忆 当记忆越积越多该让 Dreaming 出手了。它是一个异步批处理作业读取现有记忆存储与指定会话转录运行模型提炼把蒸馏后的新记忆写入一个全新的记忆存储。启动时的instructions字段是又一个一行 prompt旋钮——它决定 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.跑完后从outputs中取出新存储 ID用它创建下一个会话注意记忆存储只在会话创建时挂载不支持对运行中会话热替换。工作坊建议换不同的instructions重跑一次对比两次产出的文件组织方式——这就是批量侧的记忆调优。真实案例生产级 Agent 如何挂载记忆 仓库里的「Deal Desk」工作坊production-ready-agent/给出了生产级用法一个并购研究团队由协调者 Agent 调度四个并行子 Agent 做尽调同时读取记忆存储中的历史交易教训。协调者的系统提示词明确写道While they work, read the memory store for prior-deal lessons.子 Agent 工作时去读记忆库里的历史教训见 seed/agents/deal-team.yaml种子记忆就是一份份一单一课例如 seed/memories/brightline.md 记录了一笔告吹交易的复盘——集成风险是隐形杀手任何有定制内部系统的目标LOI 之前必须先评集成复杂度bin/setup.sh 自动创建deal-priors记忆存储并把种子文件批量写入会话挂载时用的是read_only访问权限——对只供参考的沉淀知识只读是更稳的选择记忆调优清单一张表收尾 你的需求该动的旋钮Agent 需要跨会话记住信息挂载 Memory Storeread_write记忆文件结构不符合预期改资源对象里的那行prompt重跑对比想让 Agent 重新组织记忆 / 吸收历史转录跑 Dreaming调instructions沉淀知识只供参考、不许改挂载时设access: read_only⚠️ 温馨提示仓库中的代码为工作坊示例官方标注 Not maintained and not accepting contributions且记忆相关能力处于 research preview请提前确认你的组织已开通。改一行 prompt记忆的骨架就重写了。从金鱼到同事只差这几行文字的距离。【免费下载链接】cwc-workshops项目地址: https://gitcode.com/GitHub_Trending/cw/cwc-workshops创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考