托管智能体会话通过事件实现客户端与服务端之间的双向通信。客户端可以发送消息、控制指令和工具执行结果;服务端会推送 Agent 回复、Session 状态、累计用量和模型调用信息。流式订阅还可以返回用于增量展示内容的瞬时预览帧。本参考文档说明各类事件和预览帧的结构、字段含义与触发时机。
说明
- 客户端发送事件时,公共字段中的 id、processed_at 等由服务端自动生成,客户端仅需要填写事件类型(type)和对应业务字段即可。
- system.message 必须与一条 user.message 放在同一个 events 数组中,并紧跟在该 user.message 后发送;单独发送 system.message 会被服务端拒绝。
- 多态对象通过 type 字段区分具体结构。客户端应先读取 type,再按对应变体解析其余字段。
- 事件 ID、结果评估 ID 和线程 ID 分别以 sevt-、outc- 和 sthr- 开头。
- user.message 的 content[] 支持 video 内容块:
- fps:抽帧频率,取值范围为 0.2~5;省略时使用下游模型的默认策略。
- source.type:视频来源类型,支持以下取值:
- url:使用公网可访问的视频 URL。可处理的视频大小以下游模型的输入限制为准。
- base64:使用 Base64 编码的视频,媒体类型支持 video/mp4、video/x-msvideo 和 video/quicktime。
- file:使用 Files API 上传的视频文件 ID。
- event_start 和 event_delta 仅在流式接口通过 event_deltas 参数显式订阅后返回,不写入事件历史。每个预览帧都有独立的顶层 id 和 processed_at;使用 event_start.event.id 或 event_delta.event_id 关联最终完整事件。
- Session 事件接口返回完整的会话主线程事件。子 Agent 线程只有生命周期、协作消息、自定义工具调用和需要客户端处理的工具授权事件会返回;自托管 Environment 中需要宿主执行的内置工具调用也会返回。思考、普通回复、Span 和预览帧,以及服务端生成的工具执行结果不返回;客户端回传的工具结果和授权回复仍会返回。
- 流式响应可能为线程内事件补充 session_thread_id,事件历史接口可能省略该字段。下方事件结构仅列出事件自身定义的字段。
- Session 进入 idle 状态时,无论本轮停止原因为何,服务端都会按最后一个 session.thread_status_idle、session.usage、session.status_idle 的顺序返回本轮收尾事件。
- session.usage 的 id 为 sevt-usg-<对应的 session.status_idle 事件 ID>,processed_at 与该 session.status_idle 相同。客户端应保留服务端返回顺序,不要仅按 processed_at 排序或去重。
客户端发送事件(请求)
*type string | 事件类型
*user.message.type
*事件类型,固定为 user.message
type string | 事件类型
user.message.type
事件类型,固定为 user.message
*id string | 事件 ID
*user.message.id
*事件唯一标识符。可选;客户端可传入稳定 ID,服务端原样回填;省略时服务端生成形如 sevt-... 的 ID
id string | 事件 ID
user.message.id
事件唯一标识符。可选;客户端可传入稳定 ID,服务端原样回填;省略时服务端生成形如 sevt-... 的 ID
*session_id string | Session ID
*user.message.session_id
*目标 Session ID。请求路径已指定 Session 时可以省略
session_id string | Session ID
user.message.session_id
目标 Session ID。请求路径已指定 Session 时可以省略
*processed_at string | 处理时间
*user.message.processed_at
*事件处理时间,由服务端生成并写入事件历史,采用 RFC 3339 格式
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;省略时使用下游模型的默认策略
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
*内容类型,固定为 text
type string | 内容类型
user.message.content.type
内容类型,固定为 text
*text string 必选 | 文本内容
*user.message.content.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
*内容类型,固定为 image
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
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
Base64 图片 object
Base64 编码图片
*type string 必选 | 内容类型
*user.message.content.source.type
type string 必选 | 内容类型
user.message.content.source.type
*media_type string 必选 | MIME 类型
*user.message.content.source.media_type
media_type string 必选 | MIME 类型
user.message.content.source.media_type
*data string 必选 | Base64 数据
*user.message.content.source.data
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
URL 图片 object
*type string 必选 | 内容类型
*user.message.content.source.type
type string 必选 | 内容类型
user.message.content.source.type
*url string 必选 | 图片 URL
*user.message.content.source.url
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
文件 ID 图片
*type string 必选 | 内容类型
*user.message.content.source.type
type string 必选 | 内容类型
user.message.content.source.type
*file_id string 必选 | 文件 ID
*user.message.content.source.file_id
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
*内容类型,固定为 document
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
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
纯文本文档 object
*type string 必选 | 内容类型
*user.message.content.source.type
type string 必选 | 内容类型
user.message.content.source.type
*media_type string 必选 | MIME 类型
*user.message.content.source.media_type
media_type string 必选 | MIME 类型
user.message.content.source.media_type
*data string 必选 | 文本内容
*user.message.content.source.data
data string 必选 | 文本内容
user.message.content.source.data
*URL 文档 object
*
*
*type string 必选 | 内容类型
*user.message.content.source.type
*url string 必选 | 文档 URL
*user.message.content.source.url
URL 文档 object
*type string 必选 | 内容类型
*user.message.content.source.type
type string 必选 | 内容类型
user.message.content.source.type
*url string 必选 | 文档 URL
*user.message.content.source.url
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
文件 ID 文档
*type string 必选 | 内容类型
*user.message.content.source.type
type string 必选 | 内容类型
user.message.content.source.type
*file_id string 必选 | 文件 ID
*user.message.content.source.file_id
file_id string 必选 | 文件 ID
user.message.content.source.file_id
*title string | 文档标题
*user.message.content.title
title string | 文档标题
user.message.content.title
*context string | 上下文说明
*user.message.content.context
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;省略时使用下游模型的默认策略
视频 object
视频内容
*type string | 内容类型
*user.message.content.type
*内容类型,固定为 video
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;省略时使用下游模型的默认策略
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;省略时使用下游模型的默认策略
Base64 视频 object
Base64 编码视频
*type string 必选 | 内容类型
*user.message.content.source.type
type string 必选 | 内容类型
user.message.content.source.type
*media_type string 必选 | MIME 类型
*user.message.content.source.media_type
*取值:video/mp4 / video/x-msvideo / video/quicktime。
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
data string 必选 | Base64 数据
user.message.content.source.data
*fps number | 抽帧频率
*user.message.content.source.fps
*抽帧频率,取值范围为 0.2 到 5;省略时使用下游模型的默认策略
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;省略时使用下游模型的默认策略
URL 视频 object
*type string 必选 | 内容类型
*user.message.content.source.type
type string 必选 | 内容类型
user.message.content.source.type
*url string 必选 | 视频 URL
*user.message.content.source.url
*公网可访问的视频 URL,可处理的视频大小以下游模型的输入限制为准;对象存储需将 Content-Type 设置为对应视频 MIME 类型
url string 必选 | 视频 URL
user.message.content.source.url
公网可访问的视频 URL,可处理的视频大小以下游模型的输入限制为准;对象存储需将 Content-Type 设置为对应视频 MIME 类型
*fps number | 抽帧频率
*user.message.content.source.fps
*抽帧频率,取值范围为 0.2 到 5;省略时使用下游模型的默认策略
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;省略时使用下游模型的默认策略
文件视频 object
文件 ID 视频
*type string 必选 | 内容类型
*user.message.content.source.type
type string 必选 | 内容类型
user.message.content.source.type
*file_id string 必选 | 文件 ID
*user.message.content.source.file_id
file_id string 必选 | 文件 ID
user.message.content.source.file_id
*fps number | 抽帧频率
*user.message.content.source.fps
*抽帧频率,取值范围为 0.2 到 5;省略时使用下游模型的默认策略
fps number | 抽帧频率
user.message.content.source.fps
抽帧频率,取值范围为 0.2 到 5;省略时使用下游模型的默认策略
客户端向会话注入系统提示词时触发,必须作为同一 events 数组中 user.message 后的下一个事件发送
*type string | 事件类型
*system.message.type
*事件类型,固定为 system.message
type string | 事件类型
system.message.type
事件类型,固定为 system.message
*id string | 事件 ID
*system.message.id
*事件唯一标识符。可选;客户端可传入稳定 ID,服务端原样回填;省略时服务端生成形如 sevt-... 的 ID
id string | 事件 ID
system.message.id
事件唯一标识符。可选;客户端可传入稳定 ID,服务端原样回填;省略时服务端生成形如 sevt-... 的 ID
*session_id string | Session ID
*system.message.session_id
*目标 Session ID。请求路径已指定 Session 时可以省略
session_id string | Session ID
system.message.session_id
目标 Session ID。请求路径已指定 Session 时可以省略
*processed_at string | 处理时间
*system.message.processed_at
*事件处理时间,由服务端生成并写入事件历史,采用 RFC 3339 格式
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
content object[] 必选 | 消息内容
system.message.content
系统提示词的文本内容,至少包含一个文本块
*文本 object
*文本内容
*
*
*type string | 内容类型
*system.message.content.type
*内容类型,固定为 text
*text string 必选 | 文本内容
*system.message.content.text
文本 object
文本内容
*type string | 内容类型
*system.message.content.type
*内容类型,固定为 text
type string | 内容类型
system.message.content.type
内容类型,固定为 text
*text string 必选 | 文本内容
*system.message.content.text
text string 必选 | 文本内容
system.message.content.text
用户发送中断指令,终止正在运行的线程/会话时触发
*type string | 事件类型
*user.interrupt.type
*事件类型,固定为 user.interrupt
type string | 事件类型
user.interrupt.type
事件类型,固定为 user.interrupt
*id string | 事件 ID
*user.interrupt.id
*事件唯一标识符。可选;客户端可传入稳定 ID,服务端原样回填;省略时服务端生成形如 sevt-... 的 ID
id string | 事件 ID
user.interrupt.id
事件唯一标识符。可选;客户端可传入稳定 ID,服务端原样回填;省略时服务端生成形如 sevt-... 的 ID
*session_id string | Session ID
*user.interrupt.session_id
*目标 Session ID。请求路径已指定 Session 时可以省略
session_id string | Session ID
user.interrupt.session_id
目标 Session ID。请求路径已指定 Session 时可以省略
*processed_at string | 处理时间
*user.interrupt.processed_at
*事件处理时间,由服务端生成并写入事件历史,采用 RFC 3339 格式
processed_at string | 处理时间
user.interrupt.processed_at
事件处理时间,由服务端生成并写入事件历史,采用 RFC 3339 格式
*session_thread_id string | 线程 ID
*user.interrupt.session_thread_id
*要中断的线程 ID,不填则中断会话内所有活跃线程
session_thread_id string | 线程 ID
user.interrupt.session_thread_id
要中断的线程 ID,不填则中断会话内所有活跃线程
用户对需要确认的工具调用进行批准/拒绝操作时触发
*type string | 事件类型
*user.tool_confirmation.type
*事件类型,固定为 user.tool_confirmation
type string | 事件类型
user.tool_confirmation.type
事件类型,固定为 user.tool_confirmation
*id string | 事件 ID
*user.tool_confirmation.id
*事件唯一标识符。可选;客户端可传入稳定 ID,服务端原样回填;省略时服务端生成形如 sevt-... 的 ID
id string | 事件 ID
user.tool_confirmation.id
事件唯一标识符。可选;客户端可传入稳定 ID,服务端原样回填;省略时服务端生成形如 sevt-... 的 ID
*session_id string | Session ID
*user.tool_confirmation.session_id
*目标 Session ID。请求路径已指定 Session 时可以省略
session_id string | Session ID
user.tool_confirmation.session_id
目标 Session ID。请求路径已指定 Session 时可以省略
*processed_at string | 处理时间
*user.tool_confirmation.processed_at
*事件处理时间,由服务端生成并写入事件历史,采用 RFC 3339 格式
processed_at string | 处理时间
user.tool_confirmation.processed_at
事件处理时间,由服务端生成并写入事件历史,采用 RFC 3339 格式
*result string 必选 | 确认结果
*user.tool_confirmation.result
*确认结果。allow 表示批准,deny 表示拒绝。
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 并原样填入
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 时有效。
deny_message string | 拒绝理由
user.tool_confirmation.deny_message
拒绝理由,仅当 result 为 deny 时有效。
*session_thread_id string | 线程 ID
*user.tool_confirmation.session_thread_id
*工具调用所属的线程 ID。可省略,服务端根据 tool_use_id 定位所属线程;显式传入时必须匹配该线程
session_thread_id string | 线程 ID
user.tool_confirmation.session_thread_id
工具调用所属的线程 ID。可省略,服务端根据 tool_use_id 定位所属线程;显式传入时必须匹配该线程
自托管 Environment 中的 Worker 完成内置工具调用后,客户端回传执行结果时触发
*type string | 事件类型
*user.tool_result.type
*事件类型,固定为 user.tool_result
type string | 事件类型
user.tool_result.type
事件类型,固定为 user.tool_result
*id string | 事件 ID
*user.tool_result.id
*事件唯一标识符。可选;客户端可传入稳定 ID,服务端原样回填;省略时服务端生成形如 sevt-... 的 ID
id string | 事件 ID
user.tool_result.id
事件唯一标识符。可选;客户端可传入稳定 ID,服务端原样回填;省略时服务端生成形如 sevt-... 的 ID
*session_id string | Session ID
*user.tool_result.session_id
*目标 Session ID。请求路径已指定 Session 时可以省略
session_id string | Session ID
user.tool_result.session_id
目标 Session ID。请求路径已指定 Session 时可以省略
*processed_at string | 处理时间
*user.tool_result.processed_at
*事件处理时间,由服务端生成并写入事件历史,采用 RFC 3339 格式
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 并原样填入
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
*是否启用引用标注
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
*内容类型,固定为 text
type string | 内容类型
user.tool_result.content.type
内容类型,固定为 text
*text string 必选 | 文本内容
*user.tool_result.content.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
*内容类型,固定为 image
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
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
Base64 图片 object
Base64 编码图片
*type string 必选 | 内容类型
*user.tool_result.content.source.type
type string 必选 | 内容类型
user.tool_result.content.source.type
*media_type string 必选 | MIME 类型
*user.tool_result.content.source.media_type
media_type string 必选 | MIME 类型
user.tool_result.content.source.media_type
*data string 必选 | Base64 数据
*user.tool_result.content.source.data
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
URL 图片 object
*type string 必选 | 内容类型
*user.tool_result.content.source.type
type string 必选 | 内容类型
user.tool_result.content.source.type
*url string 必选 | 图片 URL
*user.tool_result.content.source.url
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
文件 ID 图片
*type string 必选 | 内容类型
*user.tool_result.content.source.type
type string 必选 | 内容类型
user.tool_result.content.source.type
*file_id string 必选 | 文件 ID
*user.tool_result.content.source.file_id
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
*内容类型,固定为 document
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
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
纯文本文档 object
*type string 必选 | 内容类型
*user.tool_result.content.source.type
type string 必选 | 内容类型
user.tool_result.content.source.type
*media_type string 必选 | MIME 类型
*user.tool_result.content.source.media_type
media_type string 必选 | MIME 类型
user.tool_result.content.source.media_type
*data string 必选 | 文本内容
*user.tool_result.content.source.data
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
URL 文档 object
*type string 必选 | 内容类型
*user.tool_result.content.source.type
type string 必选 | 内容类型
user.tool_result.content.source.type
*url string 必选 | 文档 URL
*user.tool_result.content.source.url
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
文件 ID 文档
*type string 必选 | 内容类型
*user.tool_result.content.source.type
type string 必选 | 内容类型
user.tool_result.content.source.type
*file_id string 必选 | 文件 ID
*user.tool_result.content.source.file_id
file_id string 必选 | 文件 ID
user.tool_result.content.source.file_id
*title string | 文档标题
*user.tool_result.content.title
title string | 文档标题
user.tool_result.content.title
*context string | 上下文说明
*user.tool_result.content.context
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
*内容类型,固定为 video
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;省略时使用下游模型的默认策略
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;省略时使用下游模型的默认策略
Base64 视频 object
Base64 编码视频
*type string 必选 | 内容类型
*user.tool_result.content.source.type
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。
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
data string 必选 | Base64 数据
user.tool_result.content.source.data
*fps number | 抽帧频率
*user.tool_result.content.source.fps
*抽帧频率,取值范围为 0.2 到 5;省略时使用下游模型的默认策略
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;省略时使用下游模型的默认策略
URL 视频 object
*type string 必选 | 内容类型
*user.tool_result.content.source.type
type string 必选 | 内容类型
user.tool_result.content.source.type
*url string 必选 | 视频 URL
*user.tool_result.content.source.url
*公网可访问的视频 URL,可处理的视频大小以下游模型的输入限制为准;对象存储需将 Content-Type 设置为对应视频 MIME 类型
url string 必选 | 视频 URL
user.tool_result.content.source.url
公网可访问的视频 URL,可处理的视频大小以下游模型的输入限制为准;对象存储需将 Content-Type 设置为对应视频 MIME 类型
*fps number | 抽帧频率
*user.tool_result.content.source.fps
*抽帧频率,取值范围为 0.2 到 5;省略时使用下游模型的默认策略
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
文件 ID 视频
*type string 必选 | 内容类型
*user.tool_result.content.source.type
type string 必选 | 内容类型
user.tool_result.content.source.type
*file_id string 必选 | 文件 ID
*user.tool_result.content.source.file_id
file_id string 必选 | 文件 ID
user.tool_result.content.source.file_id
*fps number | 抽帧频率
*user.tool_result.content.source.fps
*抽帧频率,取值范围为 0.2 到 5;省略时使用下游模型的默认策略
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
*是否启用引用标注
搜索结果 object
*type string | 内容类型
*user.tool_result.content.type
*内容类型,固定为 search_result
type string | 内容类型
user.tool_result.content.type
内容类型,固定为 search_result
*source string 必选 | 结果 URL
*user.tool_result.content.source
source string 必选 | 结果 URL
user.tool_result.content.source
*title string 必选 | 结果标题
*user.tool_result.content.title
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
*搜索结果文本片段
content object[] 必选 | 结果内容
user.tool_result.content.content
搜索结果内容片段
*type string 必选 | 内容类型
*user.tool_result.content.content.type
*内容类型,固定为 text
type string 必选 | 内容类型
user.tool_result.content.content.type
内容类型,固定为 text
*text string 必选 | 文本内容
*user.tool_result.content.content.text
*搜索结果文本片段
text string 必选 | 文本内容
user.tool_result.content.content.text
搜索结果文本片段
*citations object 必选 | 引用配置
*user.tool_result.content.citations
*搜索结果引用配置
*
*enabled boolean 必选 | 是否启用引用
*user.tool_result.content.citations.enabled
*是否启用引用标注
citations object 必选 | 引用配置
user.tool_result.content.citations
搜索结果引用配置
*enabled boolean 必选 | 是否启用引用
*user.tool_result.content.citations.enabled
*是否启用引用标注
enabled boolean 必选 | 是否启用引用
user.tool_result.content.citations.enabled
是否启用引用标注
*is_error boolean | 是否错误
*user.tool_result.is_error
*工具是否执行失败。设为 true 时,Agent 会收到失败结果及 content 中的错误信息,并继续后续处理
is_error boolean | 是否错误
user.tool_result.is_error
工具是否执行失败。设为 true 时,Agent 会收到失败结果及 content 中的错误信息,并继续后续处理
*session_thread_id string | 线程 ID
*user.tool_result.session_thread_id
*触发工具调用的线程 ID。可省略,服务端根据 tool_use_id 定位所属线程;显式传入时必须匹配该线程
session_thread_id string | 线程 ID
user.tool_result.session_thread_id
触发工具调用的线程 ID。可省略,服务端根据 tool_use_id 定位所属线程;显式传入时必须匹配该线程
客户端本地执行完自定义工具(custom 类型工具,如生图、生视频等场景)后回传结果时触发。通过 custom_tool_use_id 关联对应的 agent.custom_tool_use 事件。
*type string | 事件类型
*user.custom_tool_result.type
*事件类型,固定为 user.custom_tool_result
type string | 事件类型
user.custom_tool_result.type
事件类型,固定为 user.custom_tool_result
*id string | 事件 ID
*user.custom_tool_result.id
*事件唯一标识符。可选;客户端可传入稳定 ID,服务端原样回填;省略时服务端生成形如 sevt-... 的 ID
id string | 事件 ID
user.custom_tool_result.id
事件唯一标识符。可选;客户端可传入稳定 ID,服务端原样回填;省略时服务端生成形如 sevt-... 的 ID
*session_id string | Session ID
*user.custom_tool_result.session_id
*目标 Session ID。请求路径已指定 Session 时可以省略
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 格式
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 并原样填入
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
*是否启用引用标注
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
*内容类型,固定为 text
type string | 内容类型
user.custom_tool_result.content.type
内容类型,固定为 text
*text string 必选 | 文本内容
*user.custom_tool_result.content.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
*内容类型,固定为 image
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
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
Base64 图片 object
Base64 编码图片
*type string 必选 | 内容类型
*user.custom_tool_result.content.source.type
type string 必选 | 内容类型
user.custom_tool_result.content.source.type
*media_type string 必选 | MIME 类型
*user.custom_tool_result.content.source.media_type
media_type string 必选 | MIME 类型
user.custom_tool_result.content.source.media_type
*data string 必选 | Base64 数据
*user.custom_tool_result.content.source.data
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
URL 图片 object
*type string 必选 | 内容类型
*user.custom_tool_result.content.source.type
type string 必选 | 内容类型
user.custom_tool_result.content.source.type
*url string 必选 | 图片 URL
*user.custom_tool_result.content.source.url
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
文件 ID 图片
*type string 必选 | 内容类型
*user.custom_tool_result.content.source.type
type string 必选 | 内容类型
user.custom_tool_result.content.source.type
*file_id string 必选 | 文件 ID
*user.custom_tool_result.content.source.file_id
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
*内容类型,固定为 document
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
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
纯文本文档 object
*type string 必选 | 内容类型
*user.custom_tool_result.content.source.type
type string 必选 | 内容类型
user.custom_tool_result.content.source.type
*media_type string 必选 | MIME 类型
*user.custom_tool_result.content.source.media_type
media_type string 必选 | MIME 类型
user.custom_tool_result.content.source.media_type
*data string 必选 | 文本内容
*user.custom_tool_result.content.source.data
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
URL 文档 object
*type string 必选 | 内容类型
*user.custom_tool_result.content.source.type
type string 必选 | 内容类型
user.custom_tool_result.content.source.type
*url string 必选 | 文档 URL
*user.custom_tool_result.content.source.url
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
文件 ID 文档
*type string 必选 | 内容类型
*user.custom_tool_result.content.source.type
type string 必选 | 内容类型
user.custom_tool_result.content.source.type
*file_id string 必选 | 文件 ID
*user.custom_tool_result.content.source.file_id
file_id string 必选 | 文件 ID
user.custom_tool_result.content.source.file_id
*title string | 文档标题
*user.custom_tool_result.content.title
title string | 文档标题
user.custom_tool_result.content.title
*context string | 上下文说明
*user.custom_tool_result.content.context
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
*内容类型,固定为 video
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;省略时使用下游模型的默认策略
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;省略时使用下游模型的默认策略
Base64 视频 object
Base64 编码视频
*type string 必选 | 内容类型
*user.custom_tool_result.content.source.type
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。
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
data string 必选 | Base64 数据
user.custom_tool_result.content.source.data
*fps number | 抽帧频率
*user.custom_tool_result.content.source.fps
*抽帧频率,取值范围为 0.2 到 5;省略时使用下游模型的默认策略
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;省略时使用下游模型的默认策略
URL 视频 object
*type string 必选 | 内容类型
*user.custom_tool_result.content.source.type
type string 必选 | 内容类型
user.custom_tool_result.content.source.type
*url string 必选 | 视频 URL
*user.custom_tool_result.content.source.url
*公网可访问的视频 URL,可处理的视频大小以下游模型的输入限制为准;对象存储需将 Content-Type 设置为对应视频 MIME 类型
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;省略时使用下游模型的默认策略
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
文件 ID 视频
*type string 必选 | 内容类型
*user.custom_tool_result.content.source.type
type string 必选 | 内容类型
user.custom_tool_result.content.source.type
*file_id string 必选 | 文件 ID
*user.custom_tool_result.content.source.file_id
file_id string 必选 | 文件 ID
user.custom_tool_result.content.source.file_id
*fps number | 抽帧频率
*user.custom_tool_result.content.source.fps
*抽帧频率,取值范围为 0.2 到 5;省略时使用下游模型的默认策略
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
*是否启用引用标注
搜索结果 object
*type string | 内容类型
*user.custom_tool_result.content.type
*内容类型,固定为 search_result
type string | 内容类型
user.custom_tool_result.content.type
内容类型,固定为 search_result
*source string 必选 | 结果 URL
*user.custom_tool_result.content.source
source string 必选 | 结果 URL
user.custom_tool_result.content.source
*title string 必选 | 结果标题
*user.custom_tool_result.content.title
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
*搜索结果文本片段
content object[] 必选 | 结果内容
user.custom_tool_result.content.content
搜索结果内容片段
*type string 必选 | 内容类型
*user.custom_tool_result.content.content.type
*内容类型,固定为 text
type string 必选 | 内容类型
user.custom_tool_result.content.content.type
内容类型,固定为 text
*text string 必选 | 文本内容
*user.custom_tool_result.content.content.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
*是否启用引用标注
citations object 必选 | 引用配置
user.custom_tool_result.content.citations
搜索结果引用配置
*enabled boolean 必选 | 是否启用引用
*user.custom_tool_result.content.citations.enabled
*是否启用引用标注
enabled boolean 必选 | 是否启用引用
user.custom_tool_result.content.citations.enabled
是否启用引用标注
*is_error boolean | 是否错误
*user.custom_tool_result.is_error
*工具是否执行失败
is_error boolean | 是否错误
user.custom_tool_result.is_error
工具是否执行失败
*session_thread_id string | 线程 ID
*user.custom_tool_result.session_thread_id
*触发工具调用的线程 ID。可省略,服务端根据 custom_tool_use_id 定位所属线程;显式传入时必须匹配该线程
session_thread_id string | 线程 ID
user.custom_tool_result.session_thread_id
触发工具调用的线程 ID。可省略,服务端根据 custom_tool_use_id 定位所属线程;显式传入时必须匹配该线程
服务端推送事件(响应)
智能体生成回复消息时触发,包括最终回复以及工具调用前后的中间文本(随模型行为不同而不同)
*type string | 事件类型
*agent.message.type
*事件类型,固定为 agent.message
type string | 事件类型
agent.message.type
事件类型,固定为 agent.message
*id string | 事件 ID
*agent.message.id
*事件唯一标识符,形如 sevt-...,由服务端生成
id string | 事件 ID
agent.message.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*agent.message.processed_at
*事件处理时间,采用 RFC 3339 格式
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
*文本内容
content object[] | 回复内容
agent.message.content
回复内容,仅包含文本块
*type string | 内容类型
*agent.message.content.type
*内容类型,固定为 text
type string | 内容类型
agent.message.content.type
内容类型,固定为 text
*text string | 文本内容
*agent.message.content.text
*文本内容
text string | 文本内容
agent.message.content.text
文本内容
*type string | 事件类型
*agent.thinking.type
*事件类型,固定为 agent.thinking
type string | 事件类型
agent.thinking.type
事件类型,固定为 agent.thinking
*id string | 事件 ID
*agent.thinking.id
*事件唯一标识符,形如 sevt-...,由服务端生成
id string | 事件 ID
agent.thinking.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*agent.thinking.processed_at
*事件处理时间,采用 RFC 3339 格式
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
*文本内容
content object[] | 思考内容
agent.thinking.content
思考内容,仅包含文本块
*type string | 内容类型
*agent.thinking.content.type
*内容类型,固定为 text
type string | 内容类型
agent.thinking.content.type
内容类型,固定为 text
*text string | 文本内容
*agent.thinking.content.text
*文本内容
text string | 文本内容
agent.thinking.content.text
文本内容
*type string | 事件类型
*agent.tool_use.type
*事件类型,固定为 agent.tool_use
type string | 事件类型
agent.tool_use.type
事件类型,固定为 agent.tool_use
*id string | 事件 ID
*agent.tool_use.id
*事件唯一标识符,形如 sevt-...,由服务端生成
id string | 事件 ID
agent.tool_use.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*agent.tool_use.processed_at
*事件处理时间,采用 RFC 3339 格式
processed_at string | 处理时间
agent.tool_use.processed_at
事件处理时间,采用 RFC 3339 格式
*name string | 工具名称
*agent.tool_use.name
*工具名称。Skill 加载请求也通过 agent.tool_use 展示。客户端应按事件中的工具名称和输入字段识别 Skill 加载请求,不需要预先判断 Agent 类型
name string | 工具名称
agent.tool_use.name
工具名称。Skill 加载请求也通过 agent.tool_use 展示。客户端应按事件中的工具名称和输入字段识别 Skill 加载请求,不需要预先判断 Agent 类型
*input object | 输入参数
*agent.tool_use.input
*工具输入参数,JSON 对象。对应 Skill 加载请求时,存在以下两种结构:
*name 为 skill 时,input.name 表示被加载的 Skill 名称。
*name 为 Skill 时,input.skill 表示被加载的 Skill 名称。
*示例:
*
*
input object | 输入参数
agent.tool_use.input
工具输入参数,JSON 对象。对应 Skill 加载请求时,存在以下两种结构:
- name 为 skill 时,input.name 表示被加载的 Skill 名称。
- name 为 Skill 时,input.skill 表示被加载的 Skill 名称。
示例:
*evaluated_permission string | 权限结果
*agent.tool_use.evaluated_permission
*权限策略评估结果。allow 表示直接调用;ask 表示客户端需发送 user.tool_confirmation,确认前会话等待用户操作;deny 表示拒绝调用
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。子线程触发的工具调用会带上该字段;Session 事件流中可能补充该字段,事件历史接口可能省略。回传确认或结果时可省略,服务端根据 tool_use_id 确定所属线程
session_thread_id string | 线程 ID
agent.tool_use.session_thread_id
工具调用所属线程 ID。子线程触发的工具调用会带上该字段;Session 事件流中可能补充该字段,事件历史接口可能省略。回传确认或结果时可省略,服务端根据 tool_use_id 确定所属线程
*type string | 事件类型
*agent.tool_result.type
*事件类型,固定为 agent.tool_result
type string | 事件类型
agent.tool_result.type
事件类型,固定为 agent.tool_result
*id string | 事件 ID
*agent.tool_result.id
*事件唯一标识符,形如 sevt-...,由服务端生成
id string | 事件 ID
agent.tool_result.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*agent.tool_result.processed_at
*事件处理时间,采用 RFC 3339 格式
processed_at string | 处理时间
agent.tool_result.processed_at
事件处理时间,采用 RFC 3339 格式
*tool_use_id string | 工具调用 ID
*agent.tool_result.tool_use_id
*对应的工具调用事件 ID
tool_use_id string | 工具调用 ID
agent.tool_result.tool_use_id
对应的工具调用事件 ID
*content object[] | 结果内容
*agent.tool_result.content
*工具执行结果内容列表,可包含文本、图片、文档、视频或搜索结果。加载 Skill 的结果是否返回正文由 Skill 的可见性配置决定,事件中不会额外返回可见性字段。
*不要根据 Skills API 的 protection_enabled 推断本字段是否返回;客户端只需按当前事件中是否存在 content 以及 is_error 的取值展示加载结果。
*客户端可按以下方式展示:
*返回 content 时,展示其中的结果正文。
*未返回 content 且 is_error 为 false 时,表示 Skill 已加载完成,但结果正文不可见;不要展示为空结果或失败。
*is_error 为 true 时,表示工具执行失败。
*有正文的结果示例:
*
*正文不可见的结果示例:
*
*长结果:云环境中的内置工具返回过长且可恢复的纯文本时,方舟会把完整结果保存在当前 Session 的沙箱文件中,文本内容只返回紧凑摘要。如果任务依赖被省略的内容,Agent 会在当前 Session 中按摘要提示使用 read 或 grep 继续读取;客户端无需处理摘要中的路径。
*
*
*
*
*
*文本 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
*是否启用引用标注
content object[] | 结果内容
agent.tool_result.content
工具执行结果内容列表,可包含文本、图片、文档、视频或搜索结果。加载 Skill 的结果是否返回正文由 Skill 的可见性配置决定,事件中不会额外返回可见性字段。
不要根据 Skills API 的 protection_enabled 推断本字段是否返回;客户端只需按当前事件中是否存在 content 以及 is_error 的取值展示加载结果。
客户端可按以下方式展示:
- 未返回 content 且 is_error 为 false 时,表示 Skill 已加载完成,但结果正文不可见;不要展示为空结果或失败。
- is_error 为 true 时,表示工具执行失败。
有正文的结果示例:
正文不可见的结果示例:
长结果:云环境中的内置工具返回过长且可恢复的纯文本时,方舟会把完整结果保存在当前 Session 的沙箱文件中,文本内容只返回紧凑摘要。如果任务依赖被省略的内容,Agent 会在当前 Session 中按摘要提示使用 read 或 grep 继续读取;客户端无需处理摘要中的路径。
*文本 object
*文本内容
*
*
*type string | 内容类型
*agent.tool_result.content.type
*内容类型,固定为 text
*text string | 文本内容
*agent.tool_result.content.text
文本 object
文本内容
*type string | 内容类型
*agent.tool_result.content.type
*内容类型,固定为 text
type string | 内容类型
agent.tool_result.content.type
内容类型,固定为 text
*text string | 文本内容
*agent.tool_result.content.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
*内容类型,固定为 image
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
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
Base64 图片 object
Base64 编码图片
*type string | 内容类型
*agent.tool_result.content.source.type
type string | 内容类型
agent.tool_result.content.source.type
*media_type string | MIME 类型
*agent.tool_result.content.source.media_type
media_type string | MIME 类型
agent.tool_result.content.source.media_type
*data string | Base64 数据
*agent.tool_result.content.source.data
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
URL 图片 object
*type string | 内容类型
*agent.tool_result.content.source.type
type string | 内容类型
agent.tool_result.content.source.type
*url string | 图片 URL
*agent.tool_result.content.source.url
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
文件 ID 图片
*type string | 内容类型
*agent.tool_result.content.source.type
type string | 内容类型
agent.tool_result.content.source.type
*file_id string | 文件 ID
*agent.tool_result.content.source.file_id
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
*内容类型,固定为 document
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
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
纯文本文档 object
*type string | 内容类型
*agent.tool_result.content.source.type
type string | 内容类型
agent.tool_result.content.source.type
*media_type string | MIME 类型
*agent.tool_result.content.source.media_type
media_type string | MIME 类型
agent.tool_result.content.source.media_type
*data string | 文本内容
*agent.tool_result.content.source.data
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
URL 文档 object
*type string | 内容类型
*agent.tool_result.content.source.type
type string | 内容类型
agent.tool_result.content.source.type
*url string | 文档 URL
*agent.tool_result.content.source.url
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
文件 ID 文档
*type string | 内容类型
*agent.tool_result.content.source.type
type string | 内容类型
agent.tool_result.content.source.type
*file_id string | 文件 ID
*agent.tool_result.content.source.file_id
file_id string | 文件 ID
agent.tool_result.content.source.file_id
*title string | 文档标题
*agent.tool_result.content.title
title string | 文档标题
agent.tool_result.content.title
*context string | 上下文说明
*agent.tool_result.content.context
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
*内容类型,固定为 video
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;省略时使用下游模型的默认策略
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;省略时使用下游模型的默认策略
Base64 视频 object
Base64 编码视频
*type string | 内容类型
*agent.tool_result.content.source.type
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。
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
data string | Base64 数据
agent.tool_result.content.source.data
*fps number | 抽帧频率
*agent.tool_result.content.source.fps
*抽帧频率,取值范围为 0.2 到 5;省略时使用下游模型的默认策略
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;省略时使用下游模型的默认策略
URL 视频 object
*type string | 内容类型
*agent.tool_result.content.source.type
type string | 内容类型
agent.tool_result.content.source.type
*url string | 视频 URL
*agent.tool_result.content.source.url
*公网可访问的视频 URL,可处理的视频大小以下游模型的输入限制为准;对象存储需将 Content-Type 设置为对应视频 MIME 类型
url string | 视频 URL
agent.tool_result.content.source.url
公网可访问的视频 URL,可处理的视频大小以下游模型的输入限制为准;对象存储需将 Content-Type 设置为对应视频 MIME 类型
*fps number | 抽帧频率
*agent.tool_result.content.source.fps
*抽帧频率,取值范围为 0.2 到 5;省略时使用下游模型的默认策略
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
文件 ID 视频
*type string | 内容类型
*agent.tool_result.content.source.type
type string | 内容类型
agent.tool_result.content.source.type
*file_id string | 文件 ID
*agent.tool_result.content.source.file_id
file_id string | 文件 ID
agent.tool_result.content.source.file_id
*fps number | 抽帧频率
*agent.tool_result.content.source.fps
*抽帧频率,取值范围为 0.2 到 5;省略时使用下游模型的默认策略
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
*是否启用引用标注
搜索结果 object
*type string | 内容类型
*agent.tool_result.content.type
*内容类型,固定为 search_result
type string | 内容类型
agent.tool_result.content.type
内容类型,固定为 search_result
*source string | 结果 URL
*agent.tool_result.content.source
source string | 结果 URL
agent.tool_result.content.source
*title string | 结果标题
*agent.tool_result.content.title
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
*搜索结果文本片段
content object[] | 结果内容
agent.tool_result.content.content
搜索结果内容片段
*type string | 内容类型
*agent.tool_result.content.content.type
*内容类型,固定为 text
type string | 内容类型
agent.tool_result.content.content.type
内容类型,固定为 text
*text string | 文本内容
*agent.tool_result.content.content.text
*搜索结果文本片段
text string | 文本内容
agent.tool_result.content.content.text
搜索结果文本片段
*citations object | 引用配置
*agent.tool_result.content.citations
*搜索结果引用配置
*
*enabled boolean | 是否启用引用
*agent.tool_result.content.citations.enabled
*是否启用引用标注
citations object | 引用配置
agent.tool_result.content.citations
搜索结果引用配置
*enabled boolean | 是否启用引用
*agent.tool_result.content.citations.enabled
*是否启用引用标注
enabled boolean | 是否启用引用
agent.tool_result.content.citations.enabled
是否启用引用标注
*is_error boolean | 是否错误
*agent.tool_result.is_error
*执行是否出错
is_error boolean | 是否错误
agent.tool_result.is_error
执行是否出错
*type string | 事件类型
*agent.mcp_tool_use.type
*事件类型,固定为 agent.mcp_tool_use
type string | 事件类型
agent.mcp_tool_use.type
事件类型,固定为 agent.mcp_tool_use
*id string | 事件 ID
*agent.mcp_tool_use.id
*事件唯一标识符,形如 sevt-...,由服务端生成
id string | 事件 ID
agent.mcp_tool_use.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*agent.mcp_tool_use.processed_at
*事件处理时间,采用 RFC 3339 格式
processed_at string | 处理时间
agent.mcp_tool_use.processed_at
事件处理时间,采用 RFC 3339 格式
*mcp_server_name string | MCP 服务名
*agent.mcp_tool_use.mcp_server_name
*MCP 服务名称
mcp_server_name string | MCP 服务名
agent.mcp_tool_use.mcp_server_name
MCP 服务名称
*name string | 工具名称
*agent.mcp_tool_use.name
*工具名称
name string | 工具名称
agent.mcp_tool_use.name
工具名称
*input object | 输入参数
*agent.mcp_tool_use.input
*工具输入参数,JSON 对象
input object | 输入参数
agent.mcp_tool_use.input
工具输入参数,JSON 对象
*evaluated_permission string | 权限结果
*agent.mcp_tool_use.evaluated_permission
*权限策略评估结果。allow 表示直接调用;ask 表示客户端需发送 user.tool_confirmation,确认前会话等待用户操作;deny 表示拒绝调用
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。子线程触发的工具调用会带上该字段;Session 事件流中可能补充该字段,事件历史接口可能省略。回传确认时可省略,服务端根据 tool_use_id 确定所属线程
session_thread_id string | 线程 ID
agent.mcp_tool_use.session_thread_id
工具调用所属线程 ID。子线程触发的工具调用会带上该字段;Session 事件流中可能补充该字段,事件历史接口可能省略。回传确认时可省略,服务端根据 tool_use_id 确定所属线程
*type string | 事件类型
*agent.mcp_tool_result.type
*事件类型,固定为 agent.mcp_tool_result
type string | 事件类型
agent.mcp_tool_result.type
事件类型,固定为 agent.mcp_tool_result
*id string | 事件 ID
*agent.mcp_tool_result.id
*事件唯一标识符,形如 sevt-...,由服务端生成
id string | 事件 ID
agent.mcp_tool_result.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*agent.mcp_tool_result.processed_at
*事件处理时间,采用 RFC 3339 格式
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
mcp_tool_use_id string | MCP 工具调用 ID
agent.mcp_tool_result.mcp_tool_use_id
对应的 MCP 工具调用事件 ID
*content object[] | 结果内容
*agent.mcp_tool_result.content
*工具执行结果内容列表,可包含文本、图片、文档、视频或搜索结果。
*云环境中的 MCP 工具返回过长且可恢复的纯文本时,方舟会把完整结果保存在当前 Session 的沙箱文件中,文本内容只返回紧凑摘要。如果任务依赖被省略的内容,Agent 会在当前 Session 中按摘要提示使用 read 或 grep 继续读取;客户端无需处理摘要中的路径。
*
*
*
*
*
*文本 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
*是否启用引用标注
content object[] | 结果内容
agent.mcp_tool_result.content
工具执行结果内容列表,可包含文本、图片、文档、视频或搜索结果。
云环境中的 MCP 工具返回过长且可恢复的纯文本时,方舟会把完整结果保存在当前 Session 的沙箱文件中,文本内容只返回紧凑摘要。如果任务依赖被省略的内容,Agent 会在当前 Session 中按摘要提示使用 read 或 grep 继续读取;客户端无需处理摘要中的路径。
*文本 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
*内容类型,固定为 text
type string | 内容类型
agent.mcp_tool_result.content.type
内容类型,固定为 text
*text string | 文本内容
*agent.mcp_tool_result.content.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
*内容类型,固定为 image
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
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
Base64 图片 object
Base64 编码图片
*type string | 内容类型
*agent.mcp_tool_result.content.source.type
type string | 内容类型
agent.mcp_tool_result.content.source.type
*media_type string | MIME 类型
*agent.mcp_tool_result.content.source.media_type
media_type string | MIME 类型
agent.mcp_tool_result.content.source.media_type
*data string | Base64 数据
*agent.mcp_tool_result.content.source.data
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
URL 图片 object
*type string | 内容类型
*agent.mcp_tool_result.content.source.type
type string | 内容类型
agent.mcp_tool_result.content.source.type
*url string | 图片 URL
*agent.mcp_tool_result.content.source.url
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
文件 ID 图片
*type string | 内容类型
*agent.mcp_tool_result.content.source.type
type string | 内容类型
agent.mcp_tool_result.content.source.type
*file_id string | 文件 ID
*agent.mcp_tool_result.content.source.file_id
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
*内容类型,固定为 document
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
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
纯文本文档 object
*type string | 内容类型
*agent.mcp_tool_result.content.source.type
type string | 内容类型
agent.mcp_tool_result.content.source.type
*media_type string | MIME 类型
*agent.mcp_tool_result.content.source.media_type
media_type string | MIME 类型
agent.mcp_tool_result.content.source.media_type
*data string | 文本内容
*agent.mcp_tool_result.content.source.data
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
URL 文档 object
*type string | 内容类型
*agent.mcp_tool_result.content.source.type
type string | 内容类型
agent.mcp_tool_result.content.source.type
*url string | 文档 URL
*agent.mcp_tool_result.content.source.url
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
文件 ID 文档
*type string | 内容类型
*agent.mcp_tool_result.content.source.type
type string | 内容类型
agent.mcp_tool_result.content.source.type
*file_id string | 文件 ID
*agent.mcp_tool_result.content.source.file_id
file_id string | 文件 ID
agent.mcp_tool_result.content.source.file_id
*title string | 文档标题
*agent.mcp_tool_result.content.title
title string | 文档标题
agent.mcp_tool_result.content.title
*context string | 上下文说明
*agent.mcp_tool_result.content.context
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
*内容类型,固定为 video
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;省略时使用下游模型的默认策略
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;省略时使用下游模型的默认策略
Base64 视频 object
Base64 编码视频
*type string | 内容类型
*agent.mcp_tool_result.content.source.type
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。
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
data string | Base64 数据
agent.mcp_tool_result.content.source.data
*fps number | 抽帧频率
*agent.mcp_tool_result.content.source.fps
*抽帧频率,取值范围为 0.2 到 5;省略时使用下游模型的默认策略
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;省略时使用下游模型的默认策略
URL 视频 object
*type string | 内容类型
*agent.mcp_tool_result.content.source.type
type string | 内容类型
agent.mcp_tool_result.content.source.type
*url string | 视频 URL
*agent.mcp_tool_result.content.source.url
*公网可访问的视频 URL,可处理的视频大小以下游模型的输入限制为准;对象存储需将 Content-Type 设置为对应视频 MIME 类型
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;省略时使用下游模型的默认策略
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
文件 ID 视频
*type string | 内容类型
*agent.mcp_tool_result.content.source.type
type string | 内容类型
agent.mcp_tool_result.content.source.type
*file_id string | 文件 ID
*agent.mcp_tool_result.content.source.file_id
file_id string | 文件 ID
agent.mcp_tool_result.content.source.file_id
*fps number | 抽帧频率
*agent.mcp_tool_result.content.source.fps
*抽帧频率,取值范围为 0.2 到 5;省略时使用下游模型的默认策略
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
*是否启用引用标注
搜索结果 object
*type string | 内容类型
*agent.mcp_tool_result.content.type
*内容类型,固定为 search_result
type string | 内容类型
agent.mcp_tool_result.content.type
内容类型,固定为 search_result
*source string | 结果 URL
*agent.mcp_tool_result.content.source
source string | 结果 URL
agent.mcp_tool_result.content.source
*title string | 结果标题
*agent.mcp_tool_result.content.title
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
*搜索结果文本片段
content object[] | 结果内容
agent.mcp_tool_result.content.content
搜索结果内容片段
*type string | 内容类型
*agent.mcp_tool_result.content.content.type
*内容类型,固定为 text
type string | 内容类型
agent.mcp_tool_result.content.content.type
内容类型,固定为 text
*text string | 文本内容
*agent.mcp_tool_result.content.content.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
*是否启用引用标注
citations object | 引用配置
agent.mcp_tool_result.content.citations
搜索结果引用配置
*enabled boolean | 是否启用引用
*agent.mcp_tool_result.content.citations.enabled
*是否启用引用标注
enabled boolean | 是否启用引用
agent.mcp_tool_result.content.citations.enabled
是否启用引用标注
*is_error boolean | 是否错误
*agent.mcp_tool_result.is_error
*执行是否出错
is_error boolean | 是否错误
agent.mcp_tool_result.is_error
执行是否出错
智能体决定调用客户端提供的自定义工具(custom 类型工具,如生图、生视频等场景)时触发。客户端执行工具后,通过 user.custom_tool_result 回传结果;custom_tool_use_id 需与本事件 id 一一匹配。
*type string | 事件类型
*agent.custom_tool_use.type
*事件类型,固定为 agent.custom_tool_use
type string | 事件类型
agent.custom_tool_use.type
事件类型,固定为 agent.custom_tool_use
*id string | 事件 ID
*agent.custom_tool_use.id
*事件唯一标识符,形如 sevt-...,由服务端生成
id string | 事件 ID
agent.custom_tool_use.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*agent.custom_tool_use.processed_at
*事件处理时间,采用 RFC 3339 格式
processed_at string | 处理时间
agent.custom_tool_use.processed_at
事件处理时间,采用 RFC 3339 格式
*name string | 工具名称
*agent.custom_tool_use.name
*自定义工具名称,对应 Agent 配置中 custom 类型工具项的 name
name string | 工具名称
agent.custom_tool_use.name
自定义工具名称,对应 Agent 配置中 custom 类型工具项的 name
*input object | 输入参数
*agent.custom_tool_use.input
*工具输入参数,JSON 对象
input object | 输入参数
agent.custom_tool_use.input
工具输入参数,JSON 对象
*session_thread_id string | 线程 ID
*agent.custom_tool_use.session_thread_id
*工具调用所属线程 ID。子线程触发的工具调用会返回该字段,可用于定位对应的线程事件
session_thread_id string | 线程 ID
agent.custom_tool_use.session_thread_id
工具调用所属线程 ID。子线程触发的工具调用会返回该字段,可用于定位对应的线程事件
agent.thread_message_received
多智能体场景下,当前线程收到其他线程/智能体发来的消息时触发
*type string | 事件类型
*agent.thread_message_received.type
*事件类型,固定为 agent.thread_message_received
type string | 事件类型
agent.thread_message_received.type
事件类型,固定为 agent.thread_message_received
*id string | 事件 ID
*agent.thread_message_received.id
*事件唯一标识符,形如 sevt-...,由服务端生成
id string | 事件 ID
agent.thread_message_received.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*agent.thread_message_received.processed_at
*事件处理时间,采用 RFC 3339 格式
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;省略时使用下游模型的默认策略
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
*内容类型,固定为 text
type string | 内容类型
agent.thread_message_received.content.type
内容类型,固定为 text
*text string | 文本内容
*agent.thread_message_received.content.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
*内容类型,固定为 image
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
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
Base64 图片 object
Base64 编码图片
*type string | 内容类型
*agent.thread_message_received.content.source.type
type string | 内容类型
agent.thread_message_received.content.source.type
*media_type string | MIME 类型
*agent.thread_message_received.content.source.media_type
media_type string | MIME 类型
agent.thread_message_received.content.source.media_type
*data string | Base64 数据
*agent.thread_message_received.content.source.data
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
URL 图片 object
*type string | 内容类型
*agent.thread_message_received.content.source.type
type string | 内容类型
agent.thread_message_received.content.source.type
*url string | 图片 URL
*agent.thread_message_received.content.source.url
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
文件 ID 图片
*type string | 内容类型
*agent.thread_message_received.content.source.type
type string | 内容类型
agent.thread_message_received.content.source.type
*file_id string | 文件 ID
*agent.thread_message_received.content.source.file_id
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
*内容类型,固定为 document
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
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
纯文本文档 object
*type string | 内容类型
*agent.thread_message_received.content.source.type
type string | 内容类型
agent.thread_message_received.content.source.type
*media_type string | MIME 类型
*agent.thread_message_received.content.source.media_type
media_type string | MIME 类型
agent.thread_message_received.content.source.media_type
*data string | 文本内容
*agent.thread_message_received.content.source.data
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
URL 文档 object
*type string | 内容类型
*agent.thread_message_received.content.source.type
type string | 内容类型
agent.thread_message_received.content.source.type
*url string | 文档 URL
*agent.thread_message_received.content.source.url
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
文件 ID 文档
*type string | 内容类型
*agent.thread_message_received.content.source.type
type string | 内容类型
agent.thread_message_received.content.source.type
*file_id string | 文件 ID
*agent.thread_message_received.content.source.file_id
file_id string | 文件 ID
agent.thread_message_received.content.source.file_id
*title string | 文档标题
*agent.thread_message_received.content.title
title string | 文档标题
agent.thread_message_received.content.title
*context string | 上下文说明
*agent.thread_message_received.content.context
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;省略时使用下游模型的默认策略
视频 object
视频内容
*type string | 内容类型
*agent.thread_message_received.content.type
*内容类型,固定为 video
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;省略时使用下游模型的默认策略
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;省略时使用下游模型的默认策略
Base64 视频 object
Base64 编码视频
*type string | 内容类型
*agent.thread_message_received.content.source.type
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。
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
data string | Base64 数据
agent.thread_message_received.content.source.data
*fps number | 抽帧频率
*agent.thread_message_received.content.source.fps
*抽帧频率,取值范围为 0.2 到 5;省略时使用下游模型的默认策略
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;省略时使用下游模型的默认策略
URL 视频 object
*type string | 内容类型
*agent.thread_message_received.content.source.type
type string | 内容类型
agent.thread_message_received.content.source.type
*url string | 视频 URL
*agent.thread_message_received.content.source.url
*公网可访问的视频 URL,可处理的视频大小以下游模型的输入限制为准;对象存储需将 Content-Type 设置为对应视频 MIME 类型
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;省略时使用下游模型的默认策略
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;省略时使用下游模型的默认策略
文件视频 object
文件 ID 视频
*type string | 内容类型
*agent.thread_message_received.content.source.type
type string | 内容类型
agent.thread_message_received.content.source.type
*file_id string | 文件 ID
*agent.thread_message_received.content.source.file_id
file_id string | 文件 ID
agent.thread_message_received.content.source.file_id
*fps number | 抽帧频率
*agent.thread_message_received.content.source.fps
*抽帧频率,取值范围为 0.2 到 5;省略时使用下游模型的默认策略
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_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
*发送方智能体名称,来自主智能体时为空
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
type string | 事件类型
agent.thread_message_sent.type
事件类型,固定为 agent.thread_message_sent
*id string | 事件 ID
*agent.thread_message_sent.id
*事件唯一标识符,形如 sevt-...,由服务端生成
id string | 事件 ID
agent.thread_message_sent.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*agent.thread_message_sent.processed_at
*事件处理时间,采用 RFC 3339 格式
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;省略时使用下游模型的默认策略
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
*内容类型,固定为 text
type string | 内容类型
agent.thread_message_sent.content.type
内容类型,固定为 text
*text string | 文本内容
*agent.thread_message_sent.content.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
*内容类型,固定为 image
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
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
Base64 图片 object
Base64 编码图片
*type string | 内容类型
*agent.thread_message_sent.content.source.type
type string | 内容类型
agent.thread_message_sent.content.source.type
*media_type string | MIME 类型
*agent.thread_message_sent.content.source.media_type
media_type string | MIME 类型
agent.thread_message_sent.content.source.media_type
*data string | Base64 数据
*agent.thread_message_sent.content.source.data
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
URL 图片 object
*type string | 内容类型
*agent.thread_message_sent.content.source.type
type string | 内容类型
agent.thread_message_sent.content.source.type
*url string | 图片 URL
*agent.thread_message_sent.content.source.url
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
文件 ID 图片
*type string | 内容类型
*agent.thread_message_sent.content.source.type
type string | 内容类型
agent.thread_message_sent.content.source.type
*file_id string | 文件 ID
*agent.thread_message_sent.content.source.file_id
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
*内容类型,固定为 document
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
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
纯文本文档 object
*type string | 内容类型
*agent.thread_message_sent.content.source.type
type string | 内容类型
agent.thread_message_sent.content.source.type
*media_type string | MIME 类型
*agent.thread_message_sent.content.source.media_type
media_type string | MIME 类型
agent.thread_message_sent.content.source.media_type
*data string | 文本内容
*agent.thread_message_sent.content.source.data
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
URL 文档 object
*type string | 内容类型
*agent.thread_message_sent.content.source.type
type string | 内容类型
agent.thread_message_sent.content.source.type
*url string | 文档 URL
*agent.thread_message_sent.content.source.url
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
文件 ID 文档
*type string | 内容类型
*agent.thread_message_sent.content.source.type
type string | 内容类型
agent.thread_message_sent.content.source.type
*file_id string | 文件 ID
*agent.thread_message_sent.content.source.file_id
file_id string | 文件 ID
agent.thread_message_sent.content.source.file_id
*title string | 文档标题
*agent.thread_message_sent.content.title
title string | 文档标题
agent.thread_message_sent.content.title
*context string | 上下文说明
*agent.thread_message_sent.content.context
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;省略时使用下游模型的默认策略
视频 object
视频内容
*type string | 内容类型
*agent.thread_message_sent.content.type
*内容类型,固定为 video
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;省略时使用下游模型的默认策略
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;省略时使用下游模型的默认策略
Base64 视频 object
Base64 编码视频
*type string | 内容类型
*agent.thread_message_sent.content.source.type
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。
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
data string | Base64 数据
agent.thread_message_sent.content.source.data
*fps number | 抽帧频率
*agent.thread_message_sent.content.source.fps
*抽帧频率,取值范围为 0.2 到 5;省略时使用下游模型的默认策略
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;省略时使用下游模型的默认策略
URL 视频 object
*type string | 内容类型
*agent.thread_message_sent.content.source.type
type string | 内容类型
agent.thread_message_sent.content.source.type
*url string | 视频 URL
*agent.thread_message_sent.content.source.url
*公网可访问的视频 URL,可处理的视频大小以下游模型的输入限制为准;对象存储需将 Content-Type 设置为对应视频 MIME 类型
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;省略时使用下游模型的默认策略
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;省略时使用下游模型的默认策略
文件视频 object
文件 ID 视频
*type string | 内容类型
*agent.thread_message_sent.content.source.type
type string | 内容类型
agent.thread_message_sent.content.source.type
*file_id string | 文件 ID
*agent.thread_message_sent.content.source.file_id
file_id string | 文件 ID
agent.thread_message_sent.content.source.file_id
*fps number | 抽帧频率
*agent.thread_message_sent.content.source.fps
*抽帧频率,取值范围为 0.2 到 5;省略时使用下游模型的默认策略
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_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
*接收方智能体名称,发给主智能体时为空
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
type string | 事件类型
agent.thread_context_compacted.type
事件类型,固定为 agent.thread_context_compacted
*id string | 事件 ID
*agent.thread_context_compacted.id
*事件唯一标识符,形如 sevt-...,由服务端生成
id string | 事件 ID
agent.thread_context_compacted.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*agent.thread_context_compacted.processed_at
*事件处理时间,采用 RFC 3339 格式
processed_at string | 处理时间
agent.thread_context_compacted.processed_at
事件处理时间,采用 RFC 3339 格式
*type string | 事件类型
*session.error.type
*事件类型,固定为 session.error
type string | 事件类型
session.error.type
事件类型,固定为 session.error
*id string | 事件 ID
*session.error.id
*事件唯一标识符,形如 sevt-...,由服务端生成
id string | 事件 ID
session.error.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*session.error.processed_at
*事件处理时间,采用 RFC 3339 格式
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
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
type string | 错误类型
session.error.error.type
*message string | 错误信息
*session.error.error.message
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,表示会话将进入终止状态
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
*状态类型,固定为 retrying,表示服务端正在自动重试
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
*状态类型,固定为 exhausted,表示已用尽当前轮次重试次数
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.retry_status.type
*状态类型,固定为 terminal,表示会话将进入终止状态
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
type string | 错误类型
session.error.error.type
*message string | 错误信息
*session.error.error.message
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,表示会话将进入终止状态
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
*状态类型,固定为 retrying,表示服务端正在自动重试
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
*状态类型,固定为 exhausted,表示已用尽当前轮次重试次数
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.retry_status.type
*状态类型,固定为 terminal,表示会话将进入终止状态
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
type string | 错误类型
session.error.error.type
*message string | 错误信息
*session.error.error.message
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,表示会话将进入终止状态
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
*状态类型,固定为 retrying,表示服务端正在自动重试
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
*状态类型,固定为 exhausted,表示已用尽当前轮次重试次数
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.retry_status.type
*状态类型,固定为 terminal,表示会话将进入终止状态
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
type string | 错误类型
session.error.error.type
*message string | 错误信息
*session.error.error.message
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,表示会话将进入终止状态
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
*状态类型,固定为 retrying,表示服务端正在自动重试
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
*状态类型,固定为 exhausted,表示已用尽当前轮次重试次数
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.retry_status.type
*状态类型,固定为 terminal,表示会话将进入终止状态
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
type string | 错误类型
session.error.error.type
*message string | 错误信息
*session.error.error.message
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,表示会话将进入终止状态
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
*状态类型,固定为 retrying,表示服务端正在自动重试
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
*状态类型,固定为 exhausted,表示已用尽当前轮次重试次数
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.retry_status.type
*状态类型,固定为 terminal,表示会话将进入终止状态
type string | 状态类型
session.error.error.retry_status.type
状态类型,固定为 terminal,表示会话将进入终止状态
*mcp_server_name string | MCP 服务名
*session.error.error.mcp_server_name
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
MCP 认证失败 object
*type string | 错误类型
*session.error.error.type
type string | 错误类型
session.error.error.type
*message string | 错误信息
*session.error.error.message
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,表示会话将进入终止状态
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
*状态类型,固定为 retrying,表示服务端正在自动重试
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
*状态类型,固定为 exhausted,表示已用尽当前轮次重试次数
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.retry_status.type
*状态类型,固定为 terminal,表示会话将进入终止状态
type string | 状态类型
session.error.error.retry_status.type
状态类型,固定为 terminal,表示会话将进入终止状态
*mcp_server_name string | MCP 服务名
*session.error.error.mcp_server_name
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
type string | 错误类型
session.error.error.type
*message string | 错误信息
*session.error.error.message
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,表示会话将进入终止状态
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
*状态类型,固定为 retrying,表示服务端正在自动重试
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
*状态类型,固定为 exhausted,表示已用尽当前轮次重试次数
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.retry_status.type
*状态类型,固定为 terminal,表示会话将进入终止状态
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
凭证不可达 object
凭证服务不可达
*type string | 错误类型
*session.error.error.type
type string | 错误类型
session.error.error.type
*message string | 错误信息
*session.error.error.message
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,表示会话将进入终止状态
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
*状态类型,固定为 retrying,表示服务端正在自动重试
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
*状态类型,固定为 exhausted,表示已用尽当前轮次重试次数
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.retry_status.type
*状态类型,固定为 terminal,表示会话将进入终止状态
type string | 状态类型
session.error.error.retry_status.type
状态类型,固定为 terminal,表示会话将进入终止状态
*vault_id string | 保管库 ID
*session.error.error.vault_id
vault_id string | 保管库 ID
session.error.error.vault_id
*credential_id string | 凭证 ID
*session.error.error.credential_id
credential_id string | 凭证 ID
session.error.error.credential_id
会话被删除时触发。收到该事件后,该会话不会再产生后续事件,客户端应结束当前流式连接
*type string | 事件类型
*session.deleted.type
*事件类型,固定为 session.deleted
type string | 事件类型
session.deleted.type
事件类型,固定为 session.deleted
*id string | 事件 ID
*session.deleted.id
*事件唯一标识符,形如 sevt-...,由服务端生成
id string | 事件 ID
session.deleted.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*session.deleted.processed_at
*事件处理时间,采用 RFC 3339 格式
processed_at string | 处理时间
session.deleted.processed_at
事件处理时间,采用 RFC 3339 格式
多智能体会话中新线程创建成功时触发。Session 事件接口会返回该通知;子线程内部的完整执行过程需订阅或查询对应线程
*type string | 事件类型
*session.thread_created.type
*事件类型,固定为 session.thread_created
type string | 事件类型
session.thread_created.type
事件类型,固定为 session.thread_created
*id string | 事件 ID
*session.thread_created.id
*事件唯一标识符,形如 sevt-...,由服务端生成
id string | 事件 ID
session.thread_created.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*session.thread_created.processed_at
*事件处理时间,采用 RFC 3339 格式
processed_at string | 处理时间
session.thread_created.processed_at
事件处理时间,采用 RFC 3339 格式
*agent_name string | 智能体名称
*session.thread_created.agent_name
*线程所属智能体名称
agent_name string | 智能体名称
session.thread_created.agent_name
线程所属智能体名称
*session_thread_id string | 线程 ID
*session.thread_created.session_thread_id
*新创建的线程 ID
session_thread_id string | 线程 ID
session.thread_created.session_thread_id
新创建的线程 ID
会话开始处理任务、状态变为 running 时触发。只要会话内任一未归档线程开始执行任务或进入重调度,会话就会进入 running
*type string | 事件类型
*session.status_running.type
*事件类型,固定为 session.status_running
type string | 事件类型
session.status_running.type
事件类型,固定为 session.status_running
*id string | 事件 ID
*session.status_running.id
*事件唯一标识符,形如 sevt-...,由服务端生成
id string | 事件 ID
session.status_running.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*session.status_running.processed_at
*事件处理时间,采用 RFC 3339 格式
processed_at string | 处理时间
session.status_running.processed_at
事件处理时间,采用 RFC 3339 格式
会话即将进入空闲状态时触发。无论本轮停止原因为何,服务端都会在最后一个 session.thread_status_idle 之后、session.status_idle 之前返回会话的最新累计用量快照
*type string | 事件类型
*session.usage.type
*事件类型,固定为 session.usage
type string | 事件类型
session.usage.type
事件类型,固定为 session.usage
*id string | 事件 ID
*session.usage.id
*事件唯一标识符,形如 sevt-...,由服务端生成
id string | 事件 ID
session.usage.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*session.usage.processed_at
*事件处理时间,采用 RFC 3339 格式
processed_at string | 处理时间
session.usage.processed_at
事件处理时间,采用 RFC 3339 格式
*usage object | 累计用量
*session.usage.usage
*会话运行期间累计的运行时长、模型 token 和服务端搜索请求统计
*
*
*
*
*
*
*active_seconds number | 累计运行时长
*session.usage.usage.active_seconds
*会话处于 running 状态的累计时长,单位为秒
*cache_creation object | 缓存创建统计
*session.usage.usage.cache_creation
*提示词缓存创建 token 统计。当前服务端不区分缓存有效期,两个字段均返回 0
*
*
*ephemeral_1h_input_tokens integer | 1 小时缓存输入 token 数
*session.usage.usage.cache_creation.ephemeral_1h_input_tokens
*1 小时有效期提示词缓存的输入 token 数。当前固定返回 0
*ephemeral_5m_input_tokens integer | 5 分钟缓存输入 token 数
*session.usage.usage.cache_creation.ephemeral_5m_input_tokens
*5 分钟有效期提示词缓存的输入 token 数。当前固定返回 0
*cache_read_input_tokens integer | 缓存读取 token 数
*session.usage.usage.cache_read_input_tokens
*会话累计从提示词缓存读取的输入 token 数
*input_tokens integer | 输入 token 数
*session.usage.usage.input_tokens
*会话内所有模型请求累计消耗的未缓存输入 token 数
*output_tokens integer | 输出 token 数
*session.usage.usage.output_tokens
*会话内所有模型请求累计生成的输出 token 数
*server_tool_use object | 服务端工具用量
*session.usage.usage.server_tool_use
*会话内服务端托管搜索工具累计发起的请求次数
*
*
*
*
*web_fetch_requests integer | 网页抓取请求次数
*session.usage.usage.server_tool_use.web_fetch_requests
*服务端执行网页抓取的累计请求次数
*web_search_requests integer | 联网搜索请求次数
*session.usage.usage.server_tool_use.web_search_requests
*服务端执行联网搜索的累计请求次数
*general_search_requests integer | 通用搜索请求次数
*session.usage.usage.server_tool_use.general_search_requests
*服务端执行通用搜索的累计请求次数
*visual_search_requests integer | 视觉搜索请求次数
*session.usage.usage.server_tool_use.visual_search_requests
*服务端执行视觉搜索的累计请求次数
usage object | 累计用量
session.usage.usage
会话运行期间累计的运行时长、模型 token 和服务端搜索请求统计
*active_seconds number | 累计运行时长
*session.usage.usage.active_seconds
*会话处于 running 状态的累计时长,单位为秒
active_seconds number | 累计运行时长
session.usage.usage.active_seconds
会话处于 running 状态的累计时长,单位为秒
*cache_creation object | 缓存创建统计
*session.usage.usage.cache_creation
*提示词缓存创建 token 统计。当前服务端不区分缓存有效期,两个字段均返回 0
*
*
*ephemeral_1h_input_tokens integer | 1 小时缓存输入 token 数
*session.usage.usage.cache_creation.ephemeral_1h_input_tokens
*1 小时有效期提示词缓存的输入 token 数。当前固定返回 0
*ephemeral_5m_input_tokens integer | 5 分钟缓存输入 token 数
*session.usage.usage.cache_creation.ephemeral_5m_input_tokens
*5 分钟有效期提示词缓存的输入 token 数。当前固定返回 0
cache_creation object | 缓存创建统计
session.usage.usage.cache_creation
提示词缓存创建 token 统计。当前服务端不区分缓存有效期,两个字段均返回 0
*ephemeral_1h_input_tokens integer | 1 小时缓存输入 token 数
*session.usage.usage.cache_creation.ephemeral_1h_input_tokens
*1 小时有效期提示词缓存的输入 token 数。当前固定返回 0
ephemeral_1h_input_tokens integer | 1 小时缓存输入 token 数
session.usage.usage.cache_creation.ephemeral_1h_input_tokens
1 小时有效期提示词缓存的输入 token 数。当前固定返回 0
*ephemeral_5m_input_tokens integer | 5 分钟缓存输入 token 数
*session.usage.usage.cache_creation.ephemeral_5m_input_tokens
*5 分钟有效期提示词缓存的输入 token 数。当前固定返回 0
ephemeral_5m_input_tokens integer | 5 分钟缓存输入 token 数
session.usage.usage.cache_creation.ephemeral_5m_input_tokens
5 分钟有效期提示词缓存的输入 token 数。当前固定返回 0
*cache_read_input_tokens integer | 缓存读取 token 数
*session.usage.usage.cache_read_input_tokens
*会话累计从提示词缓存读取的输入 token 数
cache_read_input_tokens integer | 缓存读取 token 数
session.usage.usage.cache_read_input_tokens
会话累计从提示词缓存读取的输入 token 数
*input_tokens integer | 输入 token 数
*session.usage.usage.input_tokens
*会话内所有模型请求累计消耗的未缓存输入 token 数
input_tokens integer | 输入 token 数
session.usage.usage.input_tokens
会话内所有模型请求累计消耗的未缓存输入 token 数
*output_tokens integer | 输出 token 数
*session.usage.usage.output_tokens
*会话内所有模型请求累计生成的输出 token 数
output_tokens integer | 输出 token 数
session.usage.usage.output_tokens
会话内所有模型请求累计生成的输出 token 数
*server_tool_use object | 服务端工具用量
*session.usage.usage.server_tool_use
*会话内服务端托管搜索工具累计发起的请求次数
*
*
*
*
*web_fetch_requests integer | 网页抓取请求次数
*session.usage.usage.server_tool_use.web_fetch_requests
*服务端执行网页抓取的累计请求次数
*web_search_requests integer | 联网搜索请求次数
*session.usage.usage.server_tool_use.web_search_requests
*服务端执行联网搜索的累计请求次数
*general_search_requests integer | 通用搜索请求次数
*session.usage.usage.server_tool_use.general_search_requests
*服务端执行通用搜索的累计请求次数
*visual_search_requests integer | 视觉搜索请求次数
*session.usage.usage.server_tool_use.visual_search_requests
*服务端执行视觉搜索的累计请求次数
server_tool_use object | 服务端工具用量
session.usage.usage.server_tool_use
会话内服务端托管搜索工具累计发起的请求次数
*web_fetch_requests integer | 网页抓取请求次数
*session.usage.usage.server_tool_use.web_fetch_requests
*服务端执行网页抓取的累计请求次数
web_fetch_requests integer | 网页抓取请求次数
session.usage.usage.server_tool_use.web_fetch_requests
服务端执行网页抓取的累计请求次数
*web_search_requests integer | 联网搜索请求次数
*session.usage.usage.server_tool_use.web_search_requests
*服务端执行联网搜索的累计请求次数
web_search_requests integer | 联网搜索请求次数
session.usage.usage.server_tool_use.web_search_requests
服务端执行联网搜索的累计请求次数
*general_search_requests integer | 通用搜索请求次数
*session.usage.usage.server_tool_use.general_search_requests
*服务端执行通用搜索的累计请求次数
general_search_requests integer | 通用搜索请求次数
session.usage.usage.server_tool_use.general_search_requests
服务端执行通用搜索的累计请求次数
*visual_search_requests integer | 视觉搜索请求次数
*session.usage.usage.server_tool_use.visual_search_requests
*服务端执行视觉搜索的累计请求次数
visual_search_requests integer | 视觉搜索请求次数
session.usage.usage.server_tool_use.visual_search_requests
服务端执行视觉搜索的累计请求次数
会话内没有正在运行或重调度的线程时触发,状态变为 idle。仍有线程等待工具授权或外部结果时,stop_reason.type 为 requires_action
*type string | 事件类型
*session.status_idle.type
*事件类型,固定为 session.status_idle
type string | 事件类型
session.status_idle.type
事件类型,固定为 session.status_idle
*id string | 事件 ID
*session.status_idle.id
*事件唯一标识符,形如 sevt-...,由服务端生成
id string | 事件 ID
session.status_idle.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*session.status_idle.processed_at
*事件处理时间,采用 RFC 3339 格式
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
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
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
type string | 停止原因类型
session.status_idle.stop_reason.type
*event_ids string[] | 待处理事件 ID 列表
*session.status_idle.stop_reason.event_ids
*待处理的工具调用事件 ID 列表。客户端处理对应操作后,将 ID 原样填入确认或结果事件
event_ids string[] | 待处理事件 ID 列表
session.status_idle.stop_reason.event_ids
待处理的工具调用事件 ID 列表。客户端处理对应操作后,将 ID 原样填入确认或结果事件
*重试耗尽 object
*已用尽当前轮次重试次数,仅结束当前轮次;会话恢复为空闲状态后仍可继续发送输入
*
*type string | 停止原因类型
*session.status_idle.stop_reason.type
重试耗尽 object
已用尽当前轮次重试次数,仅结束当前轮次;会话恢复为空闲状态后仍可继续发送输入
*type string | 停止原因类型
*session.status_idle.stop_reason.type
type string | 停止原因类型
session.status_idle.stop_reason.type
session.status_rescheduled
*type string | 事件类型
*session.status_rescheduled.type
*事件类型,固定为 session.status_rescheduled
type string | 事件类型
session.status_rescheduled.type
事件类型,固定为 session.status_rescheduled
*id string | 事件 ID
*session.status_rescheduled.id
*事件唯一标识符,形如 sevt-...,由服务端生成
id string | 事件 ID
session.status_rescheduled.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*session.status_rescheduled.processed_at
*事件处理时间,采用 RFC 3339 格式
processed_at string | 处理时间
session.status_rescheduled.processed_at
事件处理时间,采用 RFC 3339 格式
session.status_terminated
会话进入终态时触发。该状态下不能继续发送事件;retries_exhausted 仅表示当前轮次结束,不代表会话终止
*type string | 事件类型
*session.status_terminated.type
*事件类型,固定为 session.status_terminated
type string | 事件类型
session.status_terminated.type
事件类型,固定为 session.status_terminated
*id string | 事件 ID
*session.status_terminated.id
*事件唯一标识符,形如 sevt-...,由服务端生成
id string | 事件 ID
session.status_terminated.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*session.status_terminated.processed_at
*事件处理时间,采用 RFC 3339 格式
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
type string | 事件类型
session.thread_status_running.type
事件类型,固定为 session.thread_status_running
*id string | 事件 ID
*session.thread_status_running.id
*事件唯一标识符,形如 sevt-...,由服务端生成
id string | 事件 ID
session.thread_status_running.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*session.thread_status_running.processed_at
*事件处理时间,采用 RFC 3339 格式
processed_at string | 处理时间
session.thread_status_running.processed_at
事件处理时间,采用 RFC 3339 格式
*agent_name string | 智能体名称
*session.thread_status_running.agent_name
*线程所属智能体名称
agent_name string | 智能体名称
session.thread_status_running.agent_name
线程所属智能体名称
*session_thread_id string | 线程 ID
*session.thread_status_running.session_thread_id
*线程 ID
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
type string | 事件类型
session.thread_status_idle.type
事件类型,固定为 session.thread_status_idle
*id string | 事件 ID
*session.thread_status_idle.id
*事件唯一标识符,形如 sevt-...,由服务端生成
id string | 事件 ID
session.thread_status_idle.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*session.thread_status_idle.processed_at
*事件处理时间,采用 RFC 3339 格式
processed_at string | 处理时间
session.thread_status_idle.processed_at
事件处理时间,采用 RFC 3339 格式
*agent_name string | 智能体名称
*session.thread_status_idle.agent_name
*线程所属智能体名称
agent_name string | 智能体名称
session.thread_status_idle.agent_name
线程所属智能体名称
*session_thread_id string | 线程 ID
*session.thread_status_idle.session_thread_id
*线程 ID
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
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
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
type string | 停止原因类型
session.thread_status_idle.stop_reason.type
*event_ids string[] | 待处理事件 ID 列表
*session.thread_status_idle.stop_reason.event_ids
*待处理的工具调用事件 ID 列表。客户端处理对应操作后,将 ID 原样填入确认或结果事件
event_ids string[] | 待处理事件 ID 列表
session.thread_status_idle.stop_reason.event_ids
待处理的工具调用事件 ID 列表。客户端处理对应操作后,将 ID 原样填入确认或结果事件
*重试耗尽 object
*已用尽当前轮次重试次数,仅结束当前轮次;会话恢复为空闲状态后仍可继续发送输入
*
*type string | 停止原因类型
*session.thread_status_idle.stop_reason.type
重试耗尽 object
已用尽当前轮次重试次数,仅结束当前轮次;会话恢复为空闲状态后仍可继续发送输入
*type string | 停止原因类型
*session.thread_status_idle.stop_reason.type
type string | 停止原因类型
session.thread_status_idle.stop_reason.type
session.thread_status_rescheduled
线程因临时错误进入自动恢复和重新调度过程时触发。Session 事件接口也会返回子线程的该状态通知
*type string | 事件类型
*session.thread_status_rescheduled.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-...,由服务端生成
id string | 事件 ID
session.thread_status_rescheduled.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*session.thread_status_rescheduled.processed_at
*事件处理时间,采用 RFC 3339 格式
processed_at string | 处理时间
session.thread_status_rescheduled.processed_at
事件处理时间,采用 RFC 3339 格式
*agent_name string | 智能体名称
*session.thread_status_rescheduled.agent_name
*线程所属智能体名称
agent_name string | 智能体名称
session.thread_status_rescheduled.agent_name
线程所属智能体名称
*session_thread_id string | 线程 ID
*session.thread_status_rescheduled.session_thread_id
*线程 ID
session_thread_id string | 线程 ID
session.thread_status_rescheduled.session_thread_id
线程 ID
session.thread_status_terminated
线程被终止时触发。Session 事件接口也会返回子线程的该状态通知
*type string | 事件类型
*session.thread_status_terminated.type
*事件类型,固定为 session.thread_status_terminated
type string | 事件类型
session.thread_status_terminated.type
事件类型,固定为 session.thread_status_terminated
*id string | 事件 ID
*session.thread_status_terminated.id
*事件唯一标识符,形如 sevt-...,由服务端生成
id string | 事件 ID
session.thread_status_terminated.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*session.thread_status_terminated.processed_at
*事件处理时间,采用 RFC 3339 格式
processed_at string | 处理时间
session.thread_status_terminated.processed_at
事件处理时间,采用 RFC 3339 格式
*agent_name string | 智能体名称
*session.thread_status_terminated.agent_name
*线程所属智能体名称
agent_name string | 智能体名称
session.thread_status_terminated.agent_name
线程所属智能体名称
*session_thread_id string | 线程 ID
*session.thread_status_terminated.session_thread_id
*线程 ID
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
type string | 事件类型
span.model_request_start.type
事件类型,固定为 span.model_request_start
*id string | 事件 ID
*span.model_request_start.id
*事件唯一标识符,形如 sevt-...,由服务端生成
id string | 事件 ID
span.model_request_start.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*span.model_request_start.processed_at
*事件处理时间,采用 RFC 3339 格式
processed_at string | 处理时间
span.model_request_start.processed_at
事件处理时间,采用 RFC 3339 格式
*type string | 事件类型
*span.model_request_end.type
*事件类型,固定为 span.model_request_end
type string | 事件类型
span.model_request_end.type
事件类型,固定为 span.model_request_end
*id string | 事件 ID
*span.model_request_end.id
*事件唯一标识符,形如 sevt-...,由服务端生成
id string | 事件 ID
span.model_request_end.id
事件唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 处理时间
*span.model_request_end.processed_at
*事件处理时间,采用 RFC 3339 格式
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_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 用量统计
*
*
*
*
*
*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。
model_usage object | token 用量
span.model_request_end.model_usage
模型 token 用量统计
*cache_creation_input_tokens integer | 缓存写入 token
*span.model_request_end.model_usage.cache_creation_input_tokens
*缓存写入的输入 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 数
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 总数
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 总数
output_tokens integer | 输出 token
span.model_request_end.model_usage.output_tokens
输出 token 总数
*speed string | 速度档位
*span.model_request_end.model_usage.speed
*推理速度档位。取值:standard / fast。
speed string | 速度档位
span.model_request_end.model_usage.speed
推理速度档位。取值:standard / fast。
*is_error boolean | 是否错误
*span.model_request_end.is_error
*模型调用是否出错
is_error boolean | 是否错误
span.model_request_end.is_error
模型调用是否出错
流式预览帧(SSE)
通过 event_deltas 订阅 agent.message 或 agent.thinking 的增量预览后,服务端开始推送对应事件时触发
*type string | 帧类型
*event_start.type
*帧类型,固定为 event_start
type string | 帧类型
event_start.type
帧类型,固定为 event_start
*id string | 预览帧 ID
*event_start.id
*预览帧唯一标识符,形如 sevt-...,由服务端生成
id string | 预览帧 ID
event_start.id
预览帧唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 生成时间
*event_start.processed_at
*预览帧生成时间,采用 RFC 3339 格式
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 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.message
type string | 事件类型
event_start.event.type
事件类型,固定为 agent.message
*id string | 事件 ID
*event_start.event.id
*被预览事件的 ID
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
思考内容预览 object
Agent 思考内容预览
*type string | 事件类型
*event_start.event.type
*事件类型,固定为 agent.thinking
type string | 事件类型
event_start.event.type
事件类型,固定为 agent.thinking
*id string | 事件 ID
*event_start.event.id
*被预览事件的 ID
id string | 事件 ID
event_start.event.id
被预览事件的 ID
被订阅事件生成新的文本片段时触发,客户端按 event_id 和 index 累积内容
*type string | 帧类型
*event_delta.type
*帧类型,固定为 event_delta
type string | 帧类型
event_delta.type
帧类型,固定为 event_delta
*id string | 预览帧 ID
*event_delta.id
*预览帧唯一标识符,形如 sevt-...,由服务端生成
id string | 预览帧 ID
event_delta.id
预览帧唯一标识符,形如 sevt-...,由服务端生成
*processed_at string | 生成时间
*event_delta.processed_at
*预览帧生成时间,采用 RFC 3339 格式
processed_at string | 生成时间
event_delta.processed_at
预览帧生成时间,采用 RFC 3339 格式
*event_id string | 事件 ID
*event_delta.event_id
*被预览事件的 ID,与对应 event_start.event.id 及最终 buffered 事件的 id 一致
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[] 数组中的下标
delta object | 内容增量
event_delta.delta
当前内容增量
*type string | 增量类型
*event_delta.delta.type
*增量类型,固定为 content_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
*文本内容
content object | 文本片段
event_delta.delta.content
新增的文本片段
*type string | 内容类型
*event_delta.delta.content.type
*内容类型,固定为 text
type string | 内容类型
event_delta.delta.content.type
内容类型,固定为 text
*text string | 文本内容
*event_delta.delta.content.text
*文本内容
text string | 文本内容
event_delta.delta.content.text
文本内容
*index integer | 内容下标
*event_delta.delta.index
*文本片段在最终 content[] 数组中的下标
index integer | 内容下标
event_delta.delta.index
文本片段在最终 content[] 数组中的下标