Cloudflare Sessions API：Agent 记忆要分上下文、全文搜索和清理规则

这篇解决什么

Agent 记忆一旦长期保存，就会面对过期事实、敏感输入、检索噪音和清理责任。Session 设计应先写清哪些内容能留下。

适合谁

适合构建个人助理、客服系统、长期项目 Agent 和团队知识助手的开发者。

操作步骤

1. 把记忆分为会话消息、长期偏好、项目事实和临时上下文
2. 为每类 context block 定义来源和保留期限
3. 开启 compaction 前保留关键引用
4. 为全文搜索设置可见范围
5. 提供用户查看、修正和删除入口
6. 每月抽检召回结果和过期记忆

可复制模板

记忆类型：
来源：
保留期限：
搜索范围：
用户控制：
清理规则：
抽检问题：

验收清单

• 记忆类型已分层
• 保留期限明确
• 搜索范围可控
• 用户可修正删除
• 过期记忆定期清理

常见错误

• 只收藏产品更新，没有把它改成当天能执行的工作卡。
• 只看发布标题，没有确认账号权限、适用版本、成本和数据边界。
• 把 AI 自动化结果直接当结论，没有保留人工复核和失败恢复动作。
• 外部链接散落在聊天记录里，后续复查时找不到来源和日期。

30 分钟小样本

先选一个真实但低风险的任务。前 5 分钟写清输入材料和目标产物；中间 15 分钟按本文步骤执行一次；最后 10 分钟记录输出、人工修改量、失败点和下一次复用条件。小样本通过后，再扩展到团队模板或固定 SOP。

复用方式

第一次执行时，把它当成个人操作卡；第二次执行时，把成功步骤整理成团队模板；第三次执行时，再判断是否值得升级成固定 SOP、工具页或培训材料。每次复查都要看官方页面是否改版、权限或价格是否变化、原来的示例是否还能跑通。

资料依据

• Cloudflare Agents Docs / Sessions / 2026-05

标签