跳到主要内容

事件流

1.0:八个事件族,以及每一族由谁处理。

生产者要说的每一件事都以事件到达,分属八个族。每个族绑定一种事件模式,并添加自己的规则;每个族面向消费者的不同部分:

族 事件 模式 由谁消费
运行与步骤 RUN_STARTED · RUN_FINISHED · RUN_ERROR · STEP_STARTED · STEP_FINISHED 生命周期 客户端自身
文本消息 TEXT_MESSAGE_* 流式 UI
工具调用 TOOL_CALL_* 流式 应用
推理 REASONING_* 流式 UI
状态 STATE_SNAPSHOT · STATE_DELTA · MESSAGES_SNAPSHOT 快照–增量 应用存储
活动 ACTIVITY_SNAPSHOT · ACTIVITY_DELTA 快照–增量 UI
子智能体 SUBAGENT_STARTED · SUBAGENT_FINISHED · SUBAGENT_ERROR 生命周期 客户端自身
透传 RAW · CUSTOM 独立 应用(按需)

这些族共 31 种事件类型,在事件模型中枚举,其形状属于 schema。只有运行生命周期对生产者是强制的——其他每个族都是它在有内容要表达时才发射的特性。消费者 MUST 接受全部:消费者用不到的族的事件仍是格式良好的事件,不是未识别内容。

  • 运行与步骤:运行何时开始与结束,步骤如何标记其阶段。
  • 文本消息:会话本身,随生成而流式传输。
  • 工具调用:智能体提议,应用处置。
  • 推理:模型的思考,以及往返它的加密产物。
  • 状态:共享状态与会话,替换与修订。
  • 活动:UI 在对话记录之外渲染的结构化进度。
  • 子智能体:归因、所有权、嵌套、并行、状态与终止。
  • 透传:两个逃生舱及其限制。

Type to search…

↑↓ navigate↵ selectEsc close