Skip to main content
Thread 是 Session 内一个 Agent 的执行上下文。普通单 Agent Session 也有 primary thread；委派后新增 child thread。旧 Session 由迁移补齐主线程，历史中无线程归属的事件按主线程读取。
Thread 暂不支持控制台的独立查看与管理。请使用下列 API 获取线程列表、状态和事件；会话级调试见在控制台查看与调试会话。

​
先看 Session，再查看 Thread

Session 事件列表与 SSE 使用相同可见集合。子线程逐字输出不出现在主流；要渲染它，订阅该 Thread 的 /stream。
响应为 data/next_page。主线程的 parent_thread_id 为 null，子线程指向父线程。

​
五个接口

列表与事件历史均默认 100 条，均使用 next_page → page，按创建时间升序；列表支持 statuses[] 过滤。Thread SSE 路径以 /stream 结束，不是 /events/stream。

​
ID 和事件方向

  • session_id 标识整个 Session；Thread 对象的 id（sthr_ 前缀）标识其中一个 Thread。
  • thread_id 是路径/委派参数名；session_thread_id 是事件或请求中的归属字段，值仍是同一个 Thread ID。
  • 主流中的跨线程摘要可带 session_thread_id。消息另有 from_session_thread_id/from_agent_name 或 to_session_thread_id/to_agent_name。
  • sent/received 相对于你正在读取的线程：主线程派出任务是 sent，子线程收到同一任务是 received；报告回流时方向相反。

​
状态与生命周期

Session 状态由线程聚合：任一线程 running 或 rescheduling，Session 为 running；全部 terminated 时为 terminated；其余为 idle。一个子线程等待审批时，其他线程可以继续，用户也可继续与未等待审批的主线程对话。 归档仅支持 idle 子线程（包括等待审批的 idle），不能归档 primary thread；running/rescheduling 返回 400，需先发定向 interrupt 并等收尾。重复归档子线程幂等成功，历史保留。 定向打断仍发到 Session events：
省略 session_thread_id 会打断所有活跃线程；普通 user.message 进入主线程，不提供直接向任意子线程发用户消息的接口。 Thread 的 agent 返回自身有效配置；Advisor 采用 {"type":"advisor","model":"..."}。新协议下 stats/usage 尚未产生时为 null，workflow_run_id 当前为 null。Thread usage 只含已计量字段，账单/Session 总量不能用缺省值或简单求和替代。 成员名单请读取对应 Agent 版本的 multiagent；Session.agent 当前返回 multiagent:null，Thread.agent 不重复 Agent 列表。