跳到正文
SGSteven Guan

原子概念 / Agent Session

Agent Session

持续交互与事件的容器,独立于当前context窗口。

要解决的问题会话、模型窗口、后台Task和长期记忆应怎样分开?

检索别名:会话 · Thread

BLUEPRINT局部蓝图

01 输入

  1. 参与者与授权scope
  2. 事件历史与游标
  3. 关联Task和Run
→

02 处理机制

  1. 创建或恢复Session身份
  2. 排序并追加交互事件
  3. 选择当前context
  4. 按策略fork或删除
→

03 输出与证据

  1. 持续会话记录
  2. Context视图
  3. 可解释的任务关联

持续交互与事件的容器,独立于当前context窗口。

Session是持续交互和事件的容器,与当前模型窗口、业务Task和沙箱都不同。一段会话可以讨论多个任务;同一Task也可能由另一个已授权会话继续。新窗口未必意味着新Session,而新的Session也不自动获得用户全部历史。数据模型应保存这些映射,而不是靠聊天标题猜测归属。

Claude Code官方文档描述本地JSONL记录、同ID恢复和新ID分叉;OpenAI Agents SDK的Session协议提供历史读取、追加、弹出与清空。它们说明会话连续性可以被持久化,但这种history接口本身没有完成企业长期记忆的来源、冲突、TTL与删除传播治理。

会话合同应记录租户、参与者、项目、可见范围、事件游标、保留策略和当前执行关联。Resume延续同一历史;fork复制某个边界的历史到新身份,并应重新检查工具和资料权限。多设备并发输入需要排序,不能两个客户端各自覆盖messages。模型窗口只是从Session中选择出来的当前视图。

关闭会话、取消后台任务、删除聊天和撤回记忆是四种产品操作。关闭窗口不应悄悄终止获准后台任务;删除聊天也不必然删除合规要求保留的业务记录。界面需清楚展示范围。测试跨窗口恢复、同时输入、fork与删除,检查权限变化后旧摘要和在途子Agent是否受到相应处理。

跨设备继续时,应以服务端事件游标和版本为准。客户端重连携带最后已见事件,服务器补发缺失记录;重复输入通过稳定消息身份去重。若离线设备携带旧权限或旧任务限制,应重新获取当前状态,不能让它把过时会话缓存覆盖服务器历史。这种场景需要实际多客户端验证。

Session访问范围由当前身份决定,历史上参与过会话不代表永久拥有全部产物。恢复、分享和导出都应重新执行相应权限检查。

实践重点:保存参与者、scope、日志游标与保留策略;resume和fork采用不同身份。

验证抓手:验证跨窗口恢复、fork、删除与权限重新核验。

常见误区:把会话、业务任务、sandbox和长期记忆合成一行文本。

Agents SDK:Session接口源码;Claude Code:工作原理。

RELATIONSHIP MAP

与其他节点的关系

箭头从本节点指向目标;关系是工程分析映射,不代表厂商合作或已披露的内部实现。

哪些节点指向本页 · 10
  • 记忆写入、使用与遗忘评测 — 验证 → Agent Session

    用多session序列检查记忆是否正确带入和隔离。

  • Claude Code — 实现 → Agent Session

    公开能力或可见源码体现Agent Session的具体产品路线。

  • Claude Managed Agents — 实现 → Agent Session

    公开能力或可见源码体现Agent Session的具体产品路线。

  • OpenAI Agents SDK — 实现 → Agent Session

    公开能力或可见源码体现Agent Session的具体产品路线。

  • OpenAI dots — 实现 → Agent Session

    公开能力或可见源码体现Agent Session的具体产品路线。

  • Grok Bot — 实现 → Agent Session

    公开能力或可见源码体现Agent Session的具体产品路线。

  • OpenAI Agents API — 实现 → Agent Session

    公开能力或可见源码体现Agent Session的具体产品路线。

  • Meta Muse — 实现 → Agent Session

    公开能力或可见源码体现Agent Session的具体产品路线。

  • OpenCode — 实现 → Agent Session

    公开能力或可见源码体现Agent Session的具体产品路线。

  • DeepSeek Harness — 实现 → Agent Session

    公开能力或可见源码体现Agent Session的具体产品路线。

PRIMARY SOURCES

来源与阅读边界

来源按研究截止日整理。官方文档说明能力和约束,代码只证明对应版本,论文与讲座不自动证明生产效果。 资料截止:2026-10-15。

  1. Agents SDK:Session接口源码 ↗公开代码

    观察基线:2026-10-15;固定源码与具体发行版本分别核验。

  2. Claude Code:工作原理 ↗官方文档 / 声明

    公开资料观察基线:2026-10-15。