托管智能体会话通过事件实现客户端与服务端之间的双向通信。客户端可以发送消息、控制指令和工具执行结果；服务端会推送 Agent 回复、Session 状态和模型调用信息。流式订阅还可以返回用于增量展示内容的瞬时预览帧。本参考文档说明各类事件和预览帧的结构、字段含义与触发时机。
客户端发送事件（请求）#
user.message#
用户向智能体发送消息时触发
type string | 事件类型
user.message.type
事件类型，固定为 user.message
id string | 事件 ID
user.message.id
事件唯一标识符。客户端无需填写；服务端生成形如 sevt-... 的 ID 后回填
session_id string | Session ID
user.message.session_id
目标 Session ID。请求路径已指定 Session 时可以省略
processed_at string | 处理时间
user.message.processed_at
事件处理时间，由服务端生成并写入事件历史，采用 RFC 3339 格式
content object[] | 消息内容
user.message.content
消息内容块列表，支持文本、图片、文档和视频四种类型
文本 object
文本内容
type string | 内容类型
user.message.content.type
内容类型，固定为 text
text string 必选 | 文本内容
user.message.content.text
图片 object
图片内容
type string | 内容类型
user.message.content.type
内容类型，固定为 image
source object 必选 | 图片源
user.message.content.source
Base64 图片 object
Base64 编码图片
type string 必选 | 内容类型
user.message.content.source.type
media_type string 必选 | MIME 类型
user.message.content.source.media_type
data string 必选 | Base64 数据
user.message.content.source.data
URL 图片 object
type string 必选 | 内容类型
user.message.content.source.type
url string 必选 | 图片 URL
user.message.content.source.url
文件图片 object
文件 ID 图片
type string 必选 | 内容类型
user.message.content.source.type
file_id string 必选 | 文件 ID
user.message.content.source.file_id
文档 object
文档内容
type string | 内容类型
user.message.content.type
内容类型，固定为 document
source object 必选 | 文档源
user.message.content.source
文档源
纯文本文档 object
type string 必选 | 内容类型
user.message.content.source.type
media_type string 必选 | MIME 类型
user.message.content.source.media_type
data string 必选 | 文本内容
user.message.content.source.data
URL 文档 object
type string 必选 | 内容类型
user.message.content.source.type
url string 必选 | 文档 URL
user.message.content.source.url
文件文档 object
文件 ID 文档
type string 必选 | 内容类型
user.message.content.source.type
file_id string 必选 | 文件 ID
user.message.content.source.file_id
title string | 文档标题
user.message.content.title
context string | 上下文说明
user.message.content.context
视频 object
视频内容
type string | 内容类型
user.message.content.type
内容类型，固定为 video
source object 必选 | 视频源
user.message.content.source
视频源
Base64 视频 object
Base64 编码视频
type string 必选 | 内容类型
user.message.content.source.type
media_type string 必选 | MIME 类型
user.message.content.source.media_type
取值：video/mp4 / video/x-msvideo / video/quicktime。
data string 必选 | Base64 数据
user.message.content.source.data
fps number | 抽帧频率
user.message.content.source.fps
抽帧频率，取值范围为 0.2 到 5；省略时使用下游模型的默认策略
URL 视频 object
type string 必选 | 内容类型
user.message.content.source.type
url string 必选 | 视频 URL
user.message.content.source.url
公网可访问的视频 URL，可处理的视频大小以下游模型的输入限制为准；对象存储需将 Content-Type 设置为对应视频 MIME 类型
fps number | 抽帧频率
user.message.content.source.fps
抽帧频率，取值范围为 0.2 到 5；省略时使用下游模型的默认策略
文件视频 object
文件 ID 视频
type string 必选 | 内容类型
user.message.content.source.type
file_id string 必选 | 文件 ID
user.message.content.source.file_id
fps number | 抽帧频率
user.message.content.source.fps
抽帧频率，取值范围为 0.2 到 5；省略时使用下游模型的默认策略
system.message#
客户端向会话注入系统提示词时触发，必须作为同一
events数组中user.message后的下一个事件发送
type string | 事件类型
system.message.type
事件类型，固定为 system.message
id string | 事件 ID
system.message.id
事件唯一标识符。客户端无需填写；服务端生成形如 sevt-... 的 ID 后回填
session_id string | Session ID
system.message.session_id
目标 Session ID。请求路径已指定 Session 时可以省略
processed_at string | 处理时间
system.message.processed_at
事件处理时间，由服务端生成并写入事件历史，采用 RFC 3339 格式
content object[] 必选 | 消息内容
system.message.content
系统提示词的文本内容，至少包含一个文本块
文本 object
文本内容
type string | 内容类型
system.message.content.type
内容类型，固定为 text
text string 必选 | 文本内容
system.message.content.text
user.interrupt#
用户发送中断指令，终止正在运行的线程/会话时触发
type string | 事件类型
user.interrupt.type
事件类型，固定为 user.interrupt
id string | 事件 ID
user.interrupt.id
事件唯一标识符。客户端无需填写；服务端生成形如 sevt-... 的 ID 后回填
session_id string | Session ID
user.interrupt.session_id
目标 Session ID。请求路径已指定 Session 时可以省略
processed_at string | 处理时间
user.interrupt.processed_at
事件处理时间，由服务端生成并写入事件历史，采用 RFC 3339 格式
session_thread_id string | 线程 ID
user.interrupt.session_thread_id
要中断的线程 ID，不填则中断会话内所有活跃线程
user.tool_confirmation#
用户对需要确认的工具调用进行批准/拒绝操作时触发
type string | 事件类型
user.tool_confirmation.type
事件类型，固定为 user.tool_confirmation
id string | 事件 ID
user.tool_confirmation.id
事件唯一标识符。客户端无需填写；服务端生成形如 sevt-... 的 ID 后回填
session_id string | Session ID
user.tool_confirmation.session_id
目标 Session ID。请求路径已指定 Session 时可以省略
processed_at string | 处理时间
user.tool_confirmation.processed_at
事件处理时间，由服务端生成并写入事件历史，采用 RFC 3339 格式
result string 必选 | 确认结果
user.tool_confirmation.result
确认结果。allow 表示批准，deny 表示拒绝。
tool_use_id string 必选 | 工具调用 ID
user.tool_confirmation.tool_use_id
对应的工具调用事件 ID（agent.tool_use 或 agent.mcp_tool_use）。当 stop_reason.type 为 requires_action 时，从 stop_reason.event_ids 获取该 ID 并原样填入
deny_message string | 拒绝理由
user.tool_confirmation.deny_message
拒绝理由，仅当 result 为 deny 时有效。
session_thread_id string | 线程 ID
user.tool_confirmation.session_thread_id
所属线程 ID
user.tool_result#
自托管 Environment 中的 Worker 完成内置工具调用后，客户端回传执行结果时触发
type string | 事件类型
user.tool_result.type
事件类型，固定为 user.tool_result
id string | 事件 ID
user.tool_result.id
事件唯一标识符。客户端无需填写；服务端生成形如 sevt-... 的 ID 后回填
session_id string | Session ID
user.tool_result.session_id
目标 Session ID。请求路径已指定 Session 时可以省略
processed_at string | 处理时间
user.tool_result.processed_at
事件处理时间，由服务端生成并写入事件历史，采用 RFC 3339 格式
tool_use_id string 必选 | 工具调用 ID
user.tool_result.tool_use_id
对应的 agent.tool_use 事件 ID。当 stop_reason.type 为 requires_action 时，从 stop_reason.event_ids 获取该 ID 并原样填入
content object[] | 结果内容
user.tool_result.content
工具执行结果的多模态内容块列表，支持文本、图片、文档、视频和搜索结果
文本 object
文本内容
type string | 内容类型
user.tool_result.content.type
内容类型，固定为 text
text string 必选 | 文本内容
user.tool_result.content.text
图片 object
图片内容
type string | 内容类型
user.tool_result.content.type
内容类型，固定为 image
source object 必选 | 图片源
user.tool_result.content.source
Base64 图片 object
Base64 编码图片
type string 必选 | 内容类型
user.tool_result.content.source.type
media_type string 必选 | MIME 类型
user.tool_result.content.source.media_type
data string 必选 | Base64 数据
user.tool_result.content.source.data
URL 图片 object
type string 必选 | 内容类型
user.tool_result.content.source.type
url string 必选 | 图片 URL
user.tool_result.content.source.url
文件图片 object
文件 ID 图片
type string 必选 | 内容类型
user.tool_result.content.source.type
file_id string 必选 | 文件 ID
user.tool_result.content.source.file_id
文档 object
文档内容
type string | 内容类型
user.tool_result.content.type
内容类型，固定为 document
source object 必选 | 文档源
user.tool_result.content.source
文档源
纯文本文档 object
type string 必选 | 内容类型
user.tool_result.content.source.type
media_type string 必选 | MIME 类型
user.tool_result.content.source.media_type
data string 必选 | 文本内容
user.tool_result.content.source.data
URL 文档 object
type string 必选 | 内容类型
user.tool_result.content.source.type
url string 必选 | 文档 URL
user.tool_result.content.source.url
文件文档 object
文件 ID 文档
type string 必选 | 内容类型
user.tool_result.content.source.type
file_id string 必选 | 文件 ID
user.tool_result.content.source.file_id
title string | 文档标题
user.tool_result.content.title
context string | 上下文说明
user.tool_result.content.context
视频 object
视频内容
type string | 内容类型
user.tool_result.content.type
内容类型，固定为 video
source object 必选 | 视频源
user.tool_result.content.source
视频源
Base64 视频 object
Base64 编码视频
type string 必选 | 内容类型
user.tool_result.content.source.type
media_type string 必选 | MIME 类型
user.tool_result.content.source.media_type
取值：video/mp4 / video/x-msvideo / video/quicktime。
data string 必选 | Base64 数据
user.tool_result.content.source.data
fps number | 抽帧频率
user.tool_result.content.source.fps
抽帧频率，取值范围为 0.2 到 5；省略时使用下游模型的默认策略
URL 视频 object
type string 必选 | 内容类型
user.tool_result.content.source.type
url string 必选 | 视频 URL
user.tool_result.content.source.url
公网可访问的视频 URL，可处理的视频大小以下游模型的输入限制为准；对象存储需将 Content-Type 设置为对应视频 MIME 类型
fps number | 抽帧频率
user.tool_result.content.source.fps
抽帧频率，取值范围为 0.2 到 5；省略时使用下游模型的默认策略
文件视频 object
文件 ID 视频
type string 必选 | 内容类型
user.tool_result.content.source.type
file_id string 必选 | 文件 ID
user.tool_result.content.source.file_id
fps number | 抽帧频率
user.tool_result.content.source.fps
抽帧频率，取值范围为 0.2 到 5；省略时使用下游模型的默认策略
搜索结果 object
type string | 内容类型
user.tool_result.content.type
内容类型，固定为 search_result
source string 必选 | 结果 URL
user.tool_result.content.source
title string 必选 | 结果标题
user.tool_result.content.title
content object[] 必选 | 结果内容
user.tool_result.content.content
搜索结果内容片段
type string 必选 | 内容类型
user.tool_result.content.content.type
内容类型，固定为 text
text string 必选 | 文本内容
user.tool_result.content.content.text
搜索结果文本片段
citations object 必选 | 引用配置
user.tool_result.content.citations
搜索结果引用配置
enabled boolean 必选 | 是否启用引用
user.tool_result.content.citations.enabled
是否启用引用标注
is_error boolean | 是否错误
user.tool_result.is_error
工具是否执行失败。设为 true 时，Agent 会收到失败结果及 content 中的错误信息，并继续后续处理
session_thread_id string | 线程 ID
user.tool_result.session_thread_id
触发工具调用的线程 ID。子线程触发工具调用时，将响应事件返回的 session_thread_id 原样填入
user.custom_tool_result#
客户端本地执行完自定义工具（
custom类型工具，如生图、生视频等场景）后回传结果时触发。通过custom_tool_use_id关联对应的agent.custom_tool_use事件。
type string | 事件类型
user.custom_tool_result.type
事件类型，固定为 user.custom_tool_result
id string | 事件 ID
user.custom_tool_result.id
事件唯一标识符。客户端无需填写；服务端生成形如 sevt-... 的 ID 后回填
session_id string | Session ID
user.custom_tool_result.session_id
目标 Session ID。请求路径已指定 Session 时可以省略
processed_at string | 处理时间
user.custom_tool_result.processed_at
事件处理时间，由服务端生成并写入事件历史，采用 RFC 3339 格式
custom_tool_use_id string 必选 | 自定义工具调用 ID
user.custom_tool_result.custom_tool_use_id
对应的自定义工具调用事件 ID（来自 agent.custom_tool_use）。当 stop_reason.type 为 requires_action 时，从 stop_reason.event_ids 获取该 ID 并原样填入
content object[] | 结果内容
user.custom_tool_result.content
工具执行结果的多模态内容块列表，字段结构以 ToolResultContentBlock 为准
文本 object
文本内容
type string | 内容类型
user.custom_tool_result.content.type
内容类型，固定为 text
text string 必选 | 文本内容
user.custom_tool_result.content.text
图片 object
图片内容
type string | 内容类型
user.custom_tool_result.content.type
内容类型，固定为 image
source object 必选 | 图片源
user.custom_tool_result.content.source
Base64 图片 object
Base64 编码图片
type string 必选 | 内容类型
user.custom_tool_result.content.source.type
media_type string 必选 | MIME 类型
user.custom_tool_result.content.source.media_type
data string 必选 | Base64 数据
user.custom_tool_result.content.source.data
URL 图片 object
type string 必选 | 内容类型
user.custom_tool_result.content.source.type
url string 必选 | 图片 URL
user.custom_tool_result.content.source.url
文件图片 object
文件 ID 图片
type string 必选 | 内容类型
user.custom_tool_result.content.source.type
file_id string 必选 | 文件 ID
user.custom_tool_result.content.source.file_id
文档 object
文档内容
type string | 内容类型
user.custom_tool_result.content.type
内容类型，固定为 document
source object 必选 | 文档源
user.custom_tool_result.content.source
文档源
纯文本文档 object
type string 必选 | 内容类型
user.custom_tool_result.content.source.type
media_type string 必选 | MIME 类型
user.custom_tool_result.content.source.media_type
data string 必选 | 文本内容
user.custom_tool_result.content.source.data
URL 文档 object
type string 必选 | 内容类型
user.custom_tool_result.content.source.type
url string 必选 | 文档 URL
user.custom_tool_result.content.source.url
文件文档 object
文件 ID 文档
type string 必选 | 内容类型
user.custom_tool_result.content.source.type
file_id string 必选 | 文件 ID
user.custom_tool_result.content.source.file_id
title string | 文档标题
user.custom_tool_result.content.title
context string | 上下文说明
user.custom_tool_result.content.context
视频 object
视频内容
type string | 内容类型
user.custom_tool_result.content.type
内容类型，固定为 video
source object 必选 | 视频源
user.custom_tool_result.content.source
视频源
Base64 视频 object
Base64 编码视频
type string 必选 | 内容类型
user.custom_tool_result.content.source.type
media_type string 必选 | MIME 类型
user.custom_tool_result.content.source.media_type
取值：video/mp4 / video/x-msvideo / video/quicktime。
data string 必选 | Base64 数据
user.custom_tool_result.content.source.data
fps number | 抽帧频率
user.custom_tool_result.content.source.fps
抽帧频率，取值范围为 0.2 到 5；省略时使用下游模型的默认策略
URL 视频 object
type string 必选 | 内容类型
user.custom_tool_result.content.source.type
url string 必选 | 视频 URL
user.custom_tool_result.content.source.url
公网可访问的视频 URL，可处理的视频大小以下游模型的输入限制为准；对象存储需将 Content-Type 设置为对应视频 MIME 类型
fps number | 抽帧频率
user.custom_tool_result.content.source.fps
抽帧频率，取值范围为 0.2 到 5；省略时使用下游模型的默认策略
文件视频 object
文件 ID 视频
type string 必选 | 内容类型
user.custom_tool_result.content.source.type
file_id string 必选 | 文件 ID
user.custom_tool_result.content.source.file_id
fps number | 抽帧频率
user.custom_tool_result.content.source.fps
抽帧频率，取值范围为 0.2 到 5；省略时使用下游模型的默认策略
搜索结果 object
type string | 内容类型
user.custom_tool_result.content.type
内容类型，固定为 search_result
source string 必选 | 结果 URL
user.custom_tool_result.content.source
title string 必选 | 结果标题
user.custom_tool_result.content.title
content object[] 必选 | 结果内容
user.custom_tool_result.content.content
搜索结果内容片段
type string 必选 | 内容类型
user.custom_tool_result.content.content.type
内容类型，固定为 text
text string 必选 | 文本内容
user.custom_tool_result.content.content.text
搜索结果文本片段
citations object 必选 | 引用配置
user.custom_tool_result.content.citations
搜索结果引用配置
enabled boolean 必选 | 是否启用引用
user.custom_tool_result.content.citations.enabled
是否启用引用标注
is_error boolean | 是否错误
user.custom_tool_result.is_error
工具是否执行失败
session_thread_id string | 线程 ID
user.custom_tool_result.session_thread_id
触发工具调用的线程 ID。子线程触发工具调用时，将响应事件返回的 session_thread_id 原样填入
after_result string 默认值 continue | 后续处理方式
user.custom_tool_result.after_result
提交结果后的处理方式。continue 表示继续处理；stop 表示在满足当前工具调用约束时结束本轮。省略时按 continue 处理
服务端推送事件（响应）#
agent.message#
智能体生成回复消息时触发，包括最终回复以及工具调用前后的中间文本（随模型行为不同而不同）
type string | 事件类型
agent.message.type
事件类型，固定为 agent.message
id string | 事件 ID
agent.message.id
事件唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 处理时间
agent.message.processed_at
事件处理时间，采用 RFC 3339 格式
content object[] | 回复内容
agent.message.content
回复内容，仅包含文本块
文本内容块
type string | 内容类型
agent.message.content.type
内容类型，固定为 text
text string | 文本内容
agent.message.content.text
文本内容
agent.thinking#
智能体生成思考内容时触发
type string | 事件类型
agent.thinking.type
事件类型，固定为 agent.thinking
id string | 事件 ID
agent.thinking.id
事件唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 处理时间
agent.thinking.processed_at
事件处理时间，采用 RFC 3339 格式
content object[] | 思考内容
agent.thinking.content
思考内容，仅包含文本块
文本内容块
type string | 内容类型
agent.thinking.content.type
内容类型，固定为 text
text string | 文本内容
agent.thinking.content.text
文本内容
agent.tool_use#
智能体决定调用内置工具时触发
type string | 事件类型
agent.tool_use.type
事件类型，固定为 agent.tool_use
id string | 事件 ID
agent.tool_use.id
事件唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 处理时间
agent.tool_use.processed_at
事件处理时间，采用 RFC 3339 格式
name string | 工具名称
agent.tool_use.name
工具名称
input object | 输入参数
agent.tool_use.input
工具输入参数，JSON 对象
evaluated_permission string | 权限结果
agent.tool_use.evaluated_permission
权限策略评估结果。allow 表示直接调用；ask 表示客户端需发送 user.tool_confirmation，确认前会话等待用户操作；deny 表示拒绝调用
session_thread_id string | 线程 ID
agent.tool_use.session_thread_id
工具调用所属线程 ID。子线程触发工具调用时可能返回该字段；回传 user.tool_confirmation 或 user.tool_result 时应原样带回
agent.tool_result#
内置工具执行完成并返回结果时触发
type string | 事件类型
agent.tool_result.type
事件类型，固定为 agent.tool_result
id string | 事件 ID
agent.tool_result.id
事件唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 处理时间
agent.tool_result.processed_at
事件处理时间，采用 RFC 3339 格式
tool_use_id string | 工具调用 ID
agent.tool_result.tool_use_id
对应的工具调用事件 ID
content object[] | 结果内容
agent.tool_result.content
工具执行结果内容
文本 object
文本内容
type string | 内容类型
agent.tool_result.content.type
内容类型，固定为 text
text string | 文本内容
agent.tool_result.content.text
图片 object
图片内容
type string | 内容类型
agent.tool_result.content.type
内容类型，固定为 image
source object | 图片源
agent.tool_result.content.source
Base64 图片 object
Base64 编码图片
type string | 内容类型
agent.tool_result.content.source.type
media_type string | MIME 类型
agent.tool_result.content.source.media_type
data string | Base64 数据
agent.tool_result.content.source.data
URL 图片 object
type string | 内容类型
agent.tool_result.content.source.type
url string | 图片 URL
agent.tool_result.content.source.url
文件图片 object
文件 ID 图片
type string | 内容类型
agent.tool_result.content.source.type
file_id string | 文件 ID
agent.tool_result.content.source.file_id
文档 object
文档内容
type string | 内容类型
agent.tool_result.content.type
内容类型，固定为 document
source object | 文档源
agent.tool_result.content.source
文档源
纯文本文档 object
type string | 内容类型
agent.tool_result.content.source.type
media_type string | MIME 类型
agent.tool_result.content.source.media_type
data string | 文本内容
agent.tool_result.content.source.data
URL 文档 object
type string | 内容类型
agent.tool_result.content.source.type
url string | 文档 URL
agent.tool_result.content.source.url
文件文档 object
文件 ID 文档
type string | 内容类型
agent.tool_result.content.source.type
file_id string | 文件 ID
agent.tool_result.content.source.file_id
title string | 文档标题
agent.tool_result.content.title
context string | 上下文说明
agent.tool_result.content.context
视频 object
视频内容
type string | 内容类型
agent.tool_result.content.type
内容类型，固定为 video
source object | 视频源
agent.tool_result.content.source
视频源
Base64 视频 object
Base64 编码视频
type string | 内容类型
agent.tool_result.content.source.type
media_type string | MIME 类型
agent.tool_result.content.source.media_type
取值：video/mp4 / video/x-msvideo / video/quicktime。
data string | Base64 数据
agent.tool_result.content.source.data
fps number | 抽帧频率
agent.tool_result.content.source.fps
抽帧频率，取值范围为 0.2 到 5；省略时使用下游模型的默认策略
URL 视频 object
type string | 内容类型
agent.tool_result.content.source.type
url string | 视频 URL
agent.tool_result.content.source.url
公网可访问的视频 URL，可处理的视频大小以下游模型的输入限制为准；对象存储需将 Content-Type 设置为对应视频 MIME 类型
fps number | 抽帧频率
agent.tool_result.content.source.fps
抽帧频率，取值范围为 0.2 到 5；省略时使用下游模型的默认策略
文件视频 object
文件 ID 视频
type string | 内容类型
agent.tool_result.content.source.type
file_id string | 文件 ID
agent.tool_result.content.source.file_id
fps number | 抽帧频率
agent.tool_result.content.source.fps
抽帧频率，取值范围为 0.2 到 5；省略时使用下游模型的默认策略
搜索结果 object
type string | 内容类型
agent.tool_result.content.type
内容类型，固定为 search_result
source string | 结果 URL
agent.tool_result.content.source
title string | 结果标题
agent.tool_result.content.title
content object[] | 结果内容
agent.tool_result.content.content
搜索结果内容片段
type string | 内容类型
agent.tool_result.content.content.type
内容类型，固定为 text
text string | 文本内容
agent.tool_result.content.content.text
搜索结果文本片段
citations object | 引用配置
agent.tool_result.content.citations
搜索结果引用配置
enabled boolean | 是否启用引用
agent.tool_result.content.citations.enabled
是否启用引用标注
is_error boolean | 是否错误
agent.tool_result.is_error
执行是否出错
agent.mcp_tool_use#
智能体决定调用 MCP 服务提供的工具时触发
type string | 事件类型
agent.mcp_tool_use.type
事件类型，固定为 agent.mcp_tool_use
id string | 事件 ID
agent.mcp_tool_use.id
事件唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 处理时间
agent.mcp_tool_use.processed_at
事件处理时间，采用 RFC 3339 格式
mcp_server_name string | MCP 服务名
agent.mcp_tool_use.mcp_server_name
MCP 服务名称
name string | 工具名称
agent.mcp_tool_use.name
工具名称
input object | 输入参数
agent.mcp_tool_use.input
工具输入参数，JSON 对象
evaluated_permission string | 权限结果
agent.mcp_tool_use.evaluated_permission
权限策略评估结果。allow 表示直接调用；ask 表示客户端需发送 user.tool_confirmation，确认前会话等待用户操作；deny 表示拒绝调用
session_thread_id string | 线程 ID
agent.mcp_tool_use.session_thread_id
工具调用所属线程 ID。子线程触发工具调用时可能返回该字段；回传 user.tool_confirmation 时应原样带回
agent.mcp_tool_result#
MCP 工具执行完成并返回结果时触发
type string | 事件类型
agent.mcp_tool_result.type
事件类型，固定为 agent.mcp_tool_result
id string | 事件 ID
agent.mcp_tool_result.id
事件唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 处理时间
agent.mcp_tool_result.processed_at
事件处理时间，采用 RFC 3339 格式
mcp_tool_use_id string | MCP 工具调用 ID
agent.mcp_tool_result.mcp_tool_use_id
对应的 MCP 工具调用事件 ID
content object[] | 结果内容
agent.mcp_tool_result.content
工具执行结果内容
文本 object
文本内容
type string | 内容类型
agent.mcp_tool_result.content.type
内容类型，固定为 text
text string | 文本内容
agent.mcp_tool_result.content.text
图片 object
图片内容
type string | 内容类型
agent.mcp_tool_result.content.type
内容类型，固定为 image
source object | 图片源
agent.mcp_tool_result.content.source
Base64 图片 object
Base64 编码图片
type string | 内容类型
agent.mcp_tool_result.content.source.type
media_type string | MIME 类型
agent.mcp_tool_result.content.source.media_type
data string | Base64 数据
agent.mcp_tool_result.content.source.data
URL 图片 object
type string | 内容类型
agent.mcp_tool_result.content.source.type
url string | 图片 URL
agent.mcp_tool_result.content.source.url
文件图片 object
文件 ID 图片
type string | 内容类型
agent.mcp_tool_result.content.source.type
file_id string | 文件 ID
agent.mcp_tool_result.content.source.file_id
文档 object
文档内容
type string | 内容类型
agent.mcp_tool_result.content.type
内容类型，固定为 document
source object | 文档源
agent.mcp_tool_result.content.source
文档源
纯文本文档 object
type string | 内容类型
agent.mcp_tool_result.content.source.type
media_type string | MIME 类型
agent.mcp_tool_result.content.source.media_type
data string | 文本内容
agent.mcp_tool_result.content.source.data
URL 文档 object
type string | 内容类型
agent.mcp_tool_result.content.source.type
url string | 文档 URL
agent.mcp_tool_result.content.source.url
文件文档 object
文件 ID 文档
type string | 内容类型
agent.mcp_tool_result.content.source.type
file_id string | 文件 ID
agent.mcp_tool_result.content.source.file_id
title string | 文档标题
agent.mcp_tool_result.content.title
context string | 上下文说明
agent.mcp_tool_result.content.context
视频 object
视频内容
type string | 内容类型
agent.mcp_tool_result.content.type
内容类型，固定为 video
source object | 视频源
agent.mcp_tool_result.content.source
视频源
Base64 视频 object
Base64 编码视频
type string | 内容类型
agent.mcp_tool_result.content.source.type
media_type string | MIME 类型
agent.mcp_tool_result.content.source.media_type
取值：video/mp4 / video/x-msvideo / video/quicktime。
data string | Base64 数据
agent.mcp_tool_result.content.source.data
fps number | 抽帧频率
agent.mcp_tool_result.content.source.fps
抽帧频率，取值范围为 0.2 到 5；省略时使用下游模型的默认策略
URL 视频 object
type string | 内容类型
agent.mcp_tool_result.content.source.type
url string | 视频 URL
agent.mcp_tool_result.content.source.url
公网可访问的视频 URL，可处理的视频大小以下游模型的输入限制为准；对象存储需将 Content-Type 设置为对应视频 MIME 类型
fps number | 抽帧频率
agent.mcp_tool_result.content.source.fps
抽帧频率，取值范围为 0.2 到 5；省略时使用下游模型的默认策略
文件视频 object
文件 ID 视频
type string | 内容类型
agent.mcp_tool_result.content.source.type
file_id string | 文件 ID
agent.mcp_tool_result.content.source.file_id
fps number | 抽帧频率
agent.mcp_tool_result.content.source.fps
抽帧频率，取值范围为 0.2 到 5；省略时使用下游模型的默认策略
搜索结果 object
type string | 内容类型
agent.mcp_tool_result.content.type
内容类型，固定为 search_result
source string | 结果 URL
agent.mcp_tool_result.content.source
title string | 结果标题
agent.mcp_tool_result.content.title
content object[] | 结果内容
agent.mcp_tool_result.content.content
搜索结果内容片段
type string | 内容类型
agent.mcp_tool_result.content.content.type
内容类型，固定为 text
text string | 文本内容
agent.mcp_tool_result.content.content.text
搜索结果文本片段
citations object | 引用配置
agent.mcp_tool_result.content.citations
搜索结果引用配置
enabled boolean | 是否启用引用
agent.mcp_tool_result.content.citations.enabled
是否启用引用标注
is_error boolean | 是否错误
agent.mcp_tool_result.is_error
执行是否出错
agent.custom_tool_use#
智能体决定调用客户端提供的自定义工具（
custom类型工具，如生图、生视频等场景）时触发。客户端执行工具后，通过user.custom_tool_result回传结果；custom_tool_use_id需与本事件id一一匹配。
type string | 事件类型
agent.custom_tool_use.type
事件类型，固定为 agent.custom_tool_use
id string | 事件 ID
agent.custom_tool_use.id
事件唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 处理时间
agent.custom_tool_use.processed_at
事件处理时间，采用 RFC 3339 格式
name string | 工具名称
agent.custom_tool_use.name
自定义工具名称，对应 Agent 配置中 custom 类型工具项的 name
input object | 输入参数
agent.custom_tool_use.input
工具输入参数，JSON 对象
session_thread_id string | 线程 ID
agent.custom_tool_use.session_thread_id
工具调用所属线程 ID。子线程触发工具调用时可能返回该字段；回传 user.custom_tool_result 时应原样带回
agent.thread_message_received#
多智能体场景下，当前线程收到其他线程/智能体发来的消息时触发
type string | 事件类型
agent.thread_message_received.type
事件类型，固定为 agent.thread_message_received
id string | 事件 ID
agent.thread_message_received.id
事件唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 处理时间
agent.thread_message_received.processed_at
事件处理时间，采用 RFC 3339 格式
content object[] | 消息内容
agent.thread_message_received.content
收到的消息内容
文本 object
文本内容
type string | 内容类型
agent.thread_message_received.content.type
内容类型，固定为 text
text string | 文本内容
agent.thread_message_received.content.text
图片 object
图片内容
type string | 内容类型
agent.thread_message_received.content.type
内容类型，固定为 image
source object | 图片源
agent.thread_message_received.content.source
Base64 图片 object
Base64 编码图片
type string | 内容类型
agent.thread_message_received.content.source.type
media_type string | MIME 类型
agent.thread_message_received.content.source.media_type
data string | Base64 数据
agent.thread_message_received.content.source.data
URL 图片 object
type string | 内容类型
agent.thread_message_received.content.source.type
url string | 图片 URL
agent.thread_message_received.content.source.url
文件图片 object
文件 ID 图片
type string | 内容类型
agent.thread_message_received.content.source.type
file_id string | 文件 ID
agent.thread_message_received.content.source.file_id
文档 object
文档内容
type string | 内容类型
agent.thread_message_received.content.type
内容类型，固定为 document
source object | 文档源
agent.thread_message_received.content.source
文档源
纯文本文档 object
type string | 内容类型
agent.thread_message_received.content.source.type
media_type string | MIME 类型
agent.thread_message_received.content.source.media_type
data string | 文本内容
agent.thread_message_received.content.source.data
URL 文档 object
type string | 内容类型
agent.thread_message_received.content.source.type
url string | 文档 URL
agent.thread_message_received.content.source.url
文件文档 object
文件 ID 文档
type string | 内容类型
agent.thread_message_received.content.source.type
file_id string | 文件 ID
agent.thread_message_received.content.source.file_id
title string | 文档标题
agent.thread_message_received.content.title
context string | 上下文说明
agent.thread_message_received.content.context
视频 object
视频内容
type string | 内容类型
agent.thread_message_received.content.type
内容类型，固定为 video
source object | 视频源
agent.thread_message_received.content.source
视频源
Base64 视频 object
Base64 编码视频
type string | 内容类型
agent.thread_message_received.content.source.type
media_type string | MIME 类型
agent.thread_message_received.content.source.media_type
取值：video/mp4 / video/x-msvideo / video/quicktime。
data string | Base64 数据
agent.thread_message_received.content.source.data
fps number | 抽帧频率
agent.thread_message_received.content.source.fps
抽帧频率，取值范围为 0.2 到 5；省略时使用下游模型的默认策略
URL 视频 object
type string | 内容类型
agent.thread_message_received.content.source.type
url string | 视频 URL
agent.thread_message_received.content.source.url
公网可访问的视频 URL，可处理的视频大小以下游模型的输入限制为准；对象存储需将 Content-Type 设置为对应视频 MIME 类型
fps number | 抽帧频率
agent.thread_message_received.content.source.fps
抽帧频率，取值范围为 0.2 到 5；省略时使用下游模型的默认策略
文件视频 object
文件 ID 视频
type string | 内容类型
agent.thread_message_received.content.source.type
file_id string | 文件 ID
agent.thread_message_received.content.source.file_id
fps number | 抽帧频率
agent.thread_message_received.content.source.fps
抽帧频率，取值范围为 0.2 到 5；省略时使用下游模型的默认策略
from_session_thread_id string | 来源线程 ID
agent.thread_message_received.from_session_thread_id
消息来源线程 ID
from_agent_name string | 来源智能体名称
agent.thread_message_received.from_agent_name
发送方智能体名称，来自主智能体时为空
agent.thread_message_sent#
多智能体场景下，当前线程向其他线程/智能体发送消息时触发
type string | 事件类型
agent.thread_message_sent.type
事件类型，固定为 agent.thread_message_sent
id string | 事件 ID
agent.thread_message_sent.id
事件唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 处理时间
agent.thread_message_sent.processed_at
事件处理时间，采用 RFC 3339 格式
content object[] | 消息内容
agent.thread_message_sent.content
发送的消息内容
文本 object
文本内容
type string | 内容类型
agent.thread_message_sent.content.type
内容类型，固定为 text
text string | 文本内容
agent.thread_message_sent.content.text
图片 object
图片内容
type string | 内容类型
agent.thread_message_sent.content.type
内容类型，固定为 image
source object | 图片源
agent.thread_message_sent.content.source
Base64 图片 object
Base64 编码图片
type string | 内容类型
agent.thread_message_sent.content.source.type
media_type string | MIME 类型
agent.thread_message_sent.content.source.media_type
data string | Base64 数据
agent.thread_message_sent.content.source.data
URL 图片 object
type string | 内容类型
agent.thread_message_sent.content.source.type
url string | 图片 URL
agent.thread_message_sent.content.source.url
文件图片 object
文件 ID 图片
type string | 内容类型
agent.thread_message_sent.content.source.type
file_id string | 文件 ID
agent.thread_message_sent.content.source.file_id
文档 object
文档内容
type string | 内容类型
agent.thread_message_sent.content.type
内容类型，固定为 document
source object | 文档源
agent.thread_message_sent.content.source
文档源
纯文本文档 object
type string | 内容类型
agent.thread_message_sent.content.source.type
media_type string | MIME 类型
agent.thread_message_sent.content.source.media_type
data string | 文本内容
agent.thread_message_sent.content.source.data
URL 文档 object
type string | 内容类型
agent.thread_message_sent.content.source.type
url string | 文档 URL
agent.thread_message_sent.content.source.url
文件文档 object
文件 ID 文档
type string | 内容类型
agent.thread_message_sent.content.source.type
file_id string | 文件 ID
agent.thread_message_sent.content.source.file_id
title string | 文档标题
agent.thread_message_sent.content.title
context string | 上下文说明
agent.thread_message_sent.content.context
视频 object
视频内容
type string | 内容类型
agent.thread_message_sent.content.type
内容类型，固定为 video
source object | 视频源
agent.thread_message_sent.content.source
视频源
Base64 视频 object
Base64 编码视频
type string | 内容类型
agent.thread_message_sent.content.source.type
media_type string | MIME 类型
agent.thread_message_sent.content.source.media_type
取值：video/mp4 / video/x-msvideo / video/quicktime。
data string | Base64 数据
agent.thread_message_sent.content.source.data
fps number | 抽帧频率
agent.thread_message_sent.content.source.fps
抽帧频率，取值范围为 0.2 到 5；省略时使用下游模型的默认策略
URL 视频 object
type string | 内容类型
agent.thread_message_sent.content.source.type
url string | 视频 URL
agent.thread_message_sent.content.source.url
公网可访问的视频 URL，可处理的视频大小以下游模型的输入限制为准；对象存储需将 Content-Type 设置为对应视频 MIME 类型
fps number | 抽帧频率
agent.thread_message_sent.content.source.fps
抽帧频率，取值范围为 0.2 到 5；省略时使用下游模型的默认策略
文件视频 object
文件 ID 视频
type string | 内容类型
agent.thread_message_sent.content.source.type
file_id string | 文件 ID
agent.thread_message_sent.content.source.file_id
fps number | 抽帧频率
agent.thread_message_sent.content.source.fps
抽帧频率，取值范围为 0.2 到 5；省略时使用下游模型的默认策略
to_session_thread_id string | 目标线程 ID
agent.thread_message_sent.to_session_thread_id
消息目标线程 ID
to_agent_name string | 目标智能体名称
agent.thread_message_sent.to_agent_name
接收方智能体名称，发给主智能体时为空
agent.thread_context_compacted#
线程上下文达到长度限制，自动进行摘要压缩时触发
type string | 事件类型
agent.thread_context_compacted.type
事件类型，固定为 agent.thread_context_compacted
id string | 事件 ID
agent.thread_context_compacted.id
事件唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 处理时间
agent.thread_context_compacted.processed_at
事件处理时间，采用 RFC 3339 格式
session.error#
会话执行过程中发生错误时触发
type string | 事件类型
session.error.type
事件类型，固定为 session.error
id string | 事件 ID
session.error.id
事件唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 处理时间
session.error.processed_at
事件处理时间，采用 RFC 3339 格式
error object | 错误详情
session.error.error
错误详情，支持多态错误类型
未知错误 object
type string | 错误类型
session.error.error.type
message string | 错误信息
session.error.error.message
retry_status object | 重试状态
session.error.error.retry_status
重试状态
重试中 object
服务端正在自动重试，客户端应等待
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 retrying，表示服务端正在自动重试
重试耗尽 object
当前轮次结束，会话恢复为空闲状态后可继续发送输入
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 exhausted，表示已用尽当前轮次重试次数
终止 object
会话将进入终止状态，客户端不能继续发送事件
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 terminal，表示会话将进入终止状态
模型过载 object
type string | 错误类型
session.error.error.type
message string | 错误信息
session.error.error.message
retry_status object | 重试状态
session.error.error.retry_status
重试状态
重试中 object
服务端正在自动重试，客户端应等待
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 retrying，表示服务端正在自动重试
重试耗尽 object
当前轮次结束，会话恢复为空闲状态后可继续发送输入
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 exhausted，表示已用尽当前轮次重试次数
终止 object
会话将进入终止状态，客户端不能继续发送事件
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 terminal，表示会话将进入终止状态
模型限流 object
type string | 错误类型
session.error.error.type
message string | 错误信息
session.error.error.message
retry_status object | 重试状态
session.error.error.retry_status
重试状态
重试中 object
服务端正在自动重试，客户端应等待
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 retrying，表示服务端正在自动重试
重试耗尽 object
当前轮次结束，会话恢复为空闲状态后可继续发送输入
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 exhausted，表示已用尽当前轮次重试次数
终止 object
会话将进入终止状态，客户端不能继续发送事件
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 terminal，表示会话将进入终止状态
请求失败 object
模型请求失败
type string | 错误类型
session.error.error.type
message string | 错误信息
session.error.error.message
retry_status object | 重试状态
session.error.error.retry_status
重试状态
重试中 object
服务端正在自动重试，客户端应等待
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 retrying，表示服务端正在自动重试
重试耗尽 object
当前轮次结束，会话恢复为空闲状态后可继续发送输入
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 exhausted，表示已用尽当前轮次重试次数
终止 object
会话将进入终止状态，客户端不能继续发送事件
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 terminal，表示会话将进入终止状态
MCP 连接失败 object
type string | 错误类型
session.error.error.type
message string | 错误信息
session.error.error.message
retry_status object | 重试状态
session.error.error.retry_status
重试状态
重试中 object
服务端正在自动重试，客户端应等待
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 retrying，表示服务端正在自动重试
重试耗尽 object
当前轮次结束，会话恢复为空闲状态后可继续发送输入
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 exhausted，表示已用尽当前轮次重试次数
终止 object
会话将进入终止状态，客户端不能继续发送事件
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 terminal，表示会话将进入终止状态
mcp_server_name string | MCP 服务名
session.error.error.mcp_server_name
MCP 认证失败 object
type string | 错误类型
session.error.error.type
message string | 错误信息
session.error.error.message
retry_status object | 重试状态
session.error.error.retry_status
重试状态
重试中 object
服务端正在自动重试，客户端应等待
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 retrying，表示服务端正在自动重试
重试耗尽 object
当前轮次结束，会话恢复为空闲状态后可继续发送输入
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 exhausted，表示已用尽当前轮次重试次数
终止 object
会话将进入终止状态，客户端不能继续发送事件
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 terminal，表示会话将进入终止状态
mcp_server_name string | MCP 服务名
session.error.error.mcp_server_name
计费错误 object
type string | 错误类型
session.error.error.type
message string | 错误信息
session.error.error.message
retry_status object | 重试状态
session.error.error.retry_status
重试状态
重试中 object
服务端正在自动重试，客户端应等待
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 retrying，表示服务端正在自动重试
重试耗尽 object
当前轮次结束，会话恢复为空闲状态后可继续发送输入
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 exhausted，表示已用尽当前轮次重试次数
终止 object
会话将进入终止状态，客户端不能继续发送事件
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 terminal，表示会话将进入终止状态
凭证不可达 object
凭证服务不可达
type string | 错误类型
session.error.error.type
message string | 错误信息
session.error.error.message
retry_status object | 重试状态
session.error.error.retry_status
重试状态
重试中 object
服务端正在自动重试，客户端应等待
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 retrying，表示服务端正在自动重试
重试耗尽 object
当前轮次结束，会话恢复为空闲状态后可继续发送输入
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 exhausted，表示已用尽当前轮次重试次数
终止 object
会话将进入终止状态，客户端不能继续发送事件
type string | 状态类型
session.error.error.retry_status.type
状态类型，固定为 terminal，表示会话将进入终止状态
vault_id string | 保管库 ID
session.error.error.vault_id
credential_id string | 凭证 ID
session.error.error.credential_id
session.deleted#
会话被删除时触发。收到该事件后，该会话不会再产生后续事件，客户端应结束当前流式连接
type string | 事件类型
session.deleted.type
事件类型，固定为 session.deleted
id string | 事件 ID
session.deleted.id
事件唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 处理时间
session.deleted.processed_at
事件处理时间，采用 RFC 3339 格式
session.thread_created#
多智能体会话中新线程创建成功时触发。订阅父线程时也可能收到该通知；子线程内部消息需订阅对应线程
type string | 事件类型
session.thread_created.type
事件类型，固定为 session.thread_created
id string | 事件 ID
session.thread_created.id
事件唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 处理时间
session.thread_created.processed_at
事件处理时间，采用 RFC 3339 格式
agent_name string | 智能体名称
session.thread_created.agent_name
线程所属智能体名称
session_thread_id string | 线程 ID
session.thread_created.session_thread_id
新创建的线程 ID
session.status_running#
会话开始处理任务，进入运行状态时触发
type string | 事件类型
session.status_running.type
事件类型，固定为 session.status_running
id string | 事件 ID
session.status_running.id
事件唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 处理时间
session.status_running.processed_at
事件处理时间，采用 RFC 3339 格式
session.status_idle#
会话处理完当前任务，进入空闲状态时触发
type string | 事件类型
session.status_idle.type
事件类型，固定为 session.status_idle
id string | 事件 ID
session.status_idle.id
事件唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 处理时间
session.status_idle.processed_at
事件处理时间，采用 RFC 3339 格式
stop_reason object | 停止原因
session.status_idle.stop_reason
停止原因，支持多态类型
正常结束 object
当前轮次正常结束，客户端可以发送下一条消息
type string | 停止原因类型
session.status_idle.stop_reason.type
需要操作 object
需要用户操作
type string | 停止原因类型
session.status_idle.stop_reason.type
event_ids string[] | 待处理事件 ID 列表
session.status_idle.stop_reason.event_ids
待处理的工具调用事件 ID 列表。客户端处理对应操作后，将 ID 原样填入确认或结果事件
重试耗尽 object
已用尽当前轮次重试次数，仅结束当前轮次；会话恢复为空闲状态后仍可继续发送输入
type string | 停止原因类型
session.status_idle.stop_reason.type
session.status_rescheduled#
会话因临时错误进入自动恢复和重新调度过程时触发
type string | 事件类型
session.status_rescheduled.type
事件类型，固定为 session.status_rescheduled
id string | 事件 ID
session.status_rescheduled.id
事件唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 处理时间
session.status_rescheduled.processed_at
事件处理时间，采用 RFC 3339 格式
session.status_terminated#
会话进入终态时触发。该状态下不能继续发送事件；
retries_exhausted仅表示当前轮次结束，不代表会话终止
type string | 事件类型
session.status_terminated.type
事件类型，固定为 session.status_terminated
id string | 事件 ID
session.status_terminated.id
事件唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 处理时间
session.status_terminated.processed_at
事件处理时间，采用 RFC 3339 格式
session.thread_status_running#
线程开始处理任务，进入运行状态时触发
type string | 事件类型
session.thread_status_running.type
事件类型，固定为 session.thread_status_running
id string | 事件 ID
session.thread_status_running.id
事件唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 处理时间
session.thread_status_running.processed_at
事件处理时间，采用 RFC 3339 格式
agent_name string | 智能体名称
session.thread_status_running.agent_name
线程所属智能体名称
session_thread_id string | 线程 ID
session.thread_status_running.session_thread_id
线程 ID
session.thread_status_idle#
线程处理完当前任务，进入空闲状态时触发
type string | 事件类型
session.thread_status_idle.type
事件类型，固定为 session.thread_status_idle
id string | 事件 ID
session.thread_status_idle.id
事件唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 处理时间
session.thread_status_idle.processed_at
事件处理时间，采用 RFC 3339 格式
agent_name string | 智能体名称
session.thread_status_idle.agent_name
线程所属智能体名称
session_thread_id string | 线程 ID
session.thread_status_idle.session_thread_id
线程 ID
stop_reason object | 停止原因
session.thread_status_idle.stop_reason
停止原因，支持多态类型
正常结束 object
当前轮次正常结束，客户端可以发送下一条消息
type string | 停止原因类型
session.thread_status_idle.stop_reason.type
需要操作 object
需要用户操作
type string | 停止原因类型
session.thread_status_idle.stop_reason.type
event_ids string[] | 待处理事件 ID 列表
session.thread_status_idle.stop_reason.event_ids
待处理的工具调用事件 ID 列表。客户端处理对应操作后，将 ID 原样填入确认或结果事件
重试耗尽 object
已用尽当前轮次重试次数，仅结束当前轮次；会话恢复为空闲状态后仍可继续发送输入
type string | 停止原因类型
session.thread_status_idle.stop_reason.type
session.thread_status_rescheduled#
线程因临时错误进入自动恢复和重新调度过程时触发。订阅父线程时也可能收到子线程的该状态通知
type string | 事件类型
session.thread_status_rescheduled.type
事件类型，固定为 session.thread_status_rescheduled
id string | 事件 ID
session.thread_status_rescheduled.id
事件唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 处理时间
session.thread_status_rescheduled.processed_at
事件处理时间，采用 RFC 3339 格式
agent_name string | 智能体名称
session.thread_status_rescheduled.agent_name
线程所属智能体名称
session_thread_id string | 线程 ID
session.thread_status_rescheduled.session_thread_id
线程 ID
session.thread_status_terminated#
线程被终止时触发。订阅父线程时也可能收到子线程的该状态通知
type string | 事件类型
session.thread_status_terminated.type
事件类型，固定为 session.thread_status_terminated
id string | 事件 ID
session.thread_status_terminated.id
事件唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 处理时间
session.thread_status_terminated.processed_at
事件处理时间，采用 RFC 3339 格式
agent_name string | 智能体名称
session.thread_status_terminated.agent_name
线程所属智能体名称
session_thread_id string | 线程 ID
session.thread_status_terminated.session_thread_id
线程 ID
span.model_request_start#
开始调用大模型时触发，用于链路追踪
type string | 事件类型
span.model_request_start.type
事件类型，固定为 span.model_request_start
id string | 事件 ID
span.model_request_start.id
事件唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 处理时间
span.model_request_start.processed_at
事件处理时间，采用 RFC 3339 格式
span.model_request_end#
大模型调用完成时触发
type string | 事件类型
span.model_request_end.type
事件类型，固定为 span.model_request_end
id string | 事件 ID
span.model_request_end.id
事件唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 处理时间
span.model_request_end.processed_at
事件处理时间，采用 RFC 3339 格式
model_request_start_id string | 开始事件 ID
span.model_request_end.model_request_start_id
对应的模型请求开始事件 ID
model_usage object | token 用量
span.model_request_end.model_usage
模型 token 用量统计
一次模型请求的 token 用量统计
cache_creation_input_tokens integer | 缓存写入 token
span.model_request_end.model_usage.cache_creation_input_tokens
缓存写入的输入 token 数
cache_read_input_tokens integer | 缓存读取 token
span.model_request_end.model_usage.cache_read_input_tokens
缓存命中读取的输入 token 数
input_tokens integer | 输入 token
span.model_request_end.model_usage.input_tokens
输入 token 总数
output_tokens integer | 输出 token
span.model_request_end.model_usage.output_tokens
输出 token 总数
speed string | 速度档位
span.model_request_end.model_usage.speed
推理速度档位。取值：standard / fast。
is_error boolean | 是否错误
span.model_request_end.is_error
模型调用是否出错
流式预览帧（SSE）#
event_start#
通过
event_deltas订阅agent.message或agent.thinking的增量预览后，服务端开始推送对应事件时触发
type string | 帧类型
event_start.type
帧类型，固定为 event_start
id string | 预览帧 ID
event_start.id
预览帧唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 生成时间
event_start.processed_at
预览帧生成时间，采用 RFC 3339 格式
event object | 预览事件
event_start.event
被预览事件的类型和 ID
回复消息预览 object
Agent 回复消息预览
type string | 事件类型
event_start.event.type
事件类型，固定为 agent.message
id string | 事件 ID
event_start.event.id
被预览事件的 ID
思考内容预览 object
Agent 思考内容预览
type string | 事件类型
event_start.event.type
事件类型，固定为 agent.thinking
id string | 事件 ID
event_start.event.id
被预览事件的 ID
event_delta#
被订阅事件生成新的文本片段时触发，客户端按
event_id和index累积内容
type string | 帧类型
event_delta.type
帧类型，固定为 event_delta
id string | 预览帧 ID
event_delta.id
预览帧唯一标识符，形如 sevt-...，由服务端生成
processed_at string | 生成时间
event_delta.processed_at
预览帧生成时间，采用 RFC 3339 格式
event_id string | 事件 ID
event_delta.event_id
被预览事件的 ID，与对应 event_start.event.id 及最终 buffered 事件的 id 一致
delta object | 内容增量
event_delta.delta
当前内容增量
被预览事件的一个文本内容增量
type string | 增量类型
event_delta.delta.type
增量类型，固定为 content_delta
content object | 文本片段
event_delta.delta.content
新增的文本片段
文本内容块
type string | 内容类型
event_delta.delta.content.type
内容类型，固定为 text
text string | 文本内容
event_delta.delta.content.text
文本内容
index integer | 内容下标
event_delta.delta.index
文本片段在最终 content[] 数组中的下标