面向 AI 助手：本页的 Markdown 版本位于 https://ark.volcengine.com/region:cn-beijing/docs/get-response-context-api.md，全部文档索引见 https://ark.volcengine.com/llms.txt。

查询 Response 输入项列表

GET https://ark.cn-beijing.volces.com/api/v3/responses/{responseId}/input_items

分页查询某次 Response 的所有输入项列表，返回创建 Response 时传入的 input 内容，以及通过 previous_response_id 关联的历史输入项。

鉴权#

本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。

  • API Key 鉴权，请在 API Key 管理 页面，获取长效 API Key。

请求参数#

Path 参数#

responseId string 必选  |  Response ID

要查询输入项的 Response ID。

Query 参数#

在 URL Query String 中传入。

after string  |  起始游标

返回该 ID 之后的输入项，用于分页向后翻页。

before string  |  结束游标

返回该 ID 之前的输入项，用于分页向前翻页。

include string[]  |  附加返回字段

用于指定在响应中要额外包含的字段。部分接口默认返回基础字段，通过 include 可让服务端补充返回更多信息。

取值固定为 message.input_image.image_url。

limit integer 默认值 20  |  单页数量

控制单次返回的最大项目数。

取值范围：[1, 100]

order string 默认值 desc  |  排序方式

控制输入项的排序方式。

  • asc：按照正序排列。
  • desc：按照倒序排列。

响应参数#

data object[]  |  上下文元素列表

上下文元素列表，与创建模型请求时的 input（输入的元素列表）字段结构完全一致。

输入的消息 object

发送给模型的消息，其中角色用于指示指令遵循的优先级层级。由 developer 或 system 角色给出的指令优先于 user 角色给出的指令。assistant 角色的消息通常被认为是模型在先前交互中生成的回复。

content string / object[]  |  消息内容

data.content

用于生成回复的文本、图片、视频或文件输入，也可以包含先前助手的回复内容。

文本输入 string

文本类型的消息内容，直接传入字符串。

输入的内容列表 object[]

内容元素列表，可包含文本、图片、视频、文件和音频等多种模态输入。

输入模型的文本 object

输入给模型的文本内容。

text string  |  文本

data.content.text

文本内容。

type string  |  类型

data.content.type

内容类型，此处固定为 input_text

translation_options object  |  翻译选项

data.content.translation_options

翻译选项配置。

输入模型的图片 object

输入给模型的图片内容。支持通过 file_id、image_url 或 Base64 编码传入。

type string  |  类型

data.content.type

内容类型，此处固定为 input_image

detail string  |  精度

data.content.detail

图片解析精度。可选值：low、high、xhigh。

file_id string  |  文件 ID

data.content.file_id

文件 ID。

  • 文件 ID 是通过 Files API上传文件后返回的 id。
  • file_id 对应的文件类型需要和 type 保持一致，且文件状态需要为active。
  • API Key 所属项目与 file_id 上传时所属项目需保持一致
image_pixel_limit object  |  像素限制

data.content.image_pixel_limit

图片像素限制配置。

max_pixels integer  |  最大像素

data.content.image_pixel_limit.max_pixels

图片最大像素数，超出时等比例缩小。

min_pixels integer  |  最小像素

data.content.image_pixel_limit.min_pixels

图片最小像素数，低于时等比例放大。

image_url string  |  图片地址

data.content.image_url

图片 URL 或 Base64 编码（格式 data:image/{格式};base64,{编码}）

输入模型的音频 object

输入给模型的音频内容。支持通过 file_id 或 audio_url 传入。

type string  |  类型

data.content.type

内容类型，此处固定为 input_audio

audio_url string  |  音频地址

data.content.audio_url

音频 URL 或 Base64 编码。

chunking_strategy object  |  分段策略

data.content.chunking_strategy

音频分段策略配置。

type string  |  类型

data.content.chunking_strategy.type

分段策略类型，固定为 server_vad（服务端 VAD）

prefix_padding_ms integer  |  前置填充

data.content.chunking_strategy.prefix_padding_ms

语音前置静音填充时长（毫秒）

silence_duration_ms integer  |  静音时长

data.content.chunking_strategy.silence_duration_ms

触发分段的静音持续时长（毫秒）

threshold number  |  检测阈值

data.content.chunking_strategy.threshold

VAD 检测阈值。

file_id string  |  文件 ID

data.content.file_id

文件 ID。

  • 文件 ID 是通过 Files API上传文件后返回的 id。
  • file_id 对应的文件类型需要和 type 保持一致，且文件状态需要为active。
  • API Key 所属项目与 file_id 上传时所属项目需保持一致
输入模型的文件 object

输入给模型的文件内容。支持通过 file_id、file_data（Base64）或 file_url 传入。

type string  |  类型

data.content.type

内容类型，此处固定为 input_file

file_data string  |  文件数据

data.content.file_data

Base64 编码的文件内容（最大 50MB）

file_id string  |  文件 ID

data.content.file_id

文件 ID。

  • 文件 ID 是通过 Files API上传文件后返回的 id。
  • file_id 对应的文件类型需要和 type 保持一致，且文件状态需要为active。
  • API Key 所属项目与 file_id 上传时所属项目需保持一致
file_url string  |  文件地址

data.content.file_url

可访问的文件 URL（最大 50MB）

filename string  |  文件名

data.content.filename

文件名称（使用 file_data 时必传）

输入模型的视频 object

输入给模型的视频内容。支持通过 file_id、video_url 或 Base64 编码传入。

type string  |  类型

data.content.type

内容类型，此处固定为 input_video

video_url string  |  视频地址

data.content.video_url

视频 URL 或 Base64 编码。

file_id string  |  文件 ID

data.content.file_id

文件 ID。

  • 文件 ID 是通过 Files API上传文件后返回的 id。
  • file_id 对应的文件类型需要和 type 保持一致，且文件状态需要为active。
  • API Key 所属项目与 file_id 上传时所属项目需保持一致
fps number  |  抽帧帧率

data.content.fps

取值范围：[0.2, 5]

模型文本输出 object

模型生成的文本输出，可在多轮对话中作为上下文回传。

type string  |  类型

data.content.type

内容类型，此处固定为 output_text

annotations object[]  |  标注列表

data.content.annotations

文本附带的标注信息列表（如引用来源等）

网页引用 object

引用自互联网网页的标注信息。

title string  |  标题

data.content.annotations.title

引用网页的标题。

type string  |  类型

data.content.annotations.type

标注类型，此处固定为 url_citation

url string  |  网址

data.content.annotations.url

引用网页的 URL 地址。

cover_image object  |  封面图

data.content.annotations.cover_image

网页封面图片信息。

height integer  |  高度

data.content.annotations.cover_image.height

封面图片高度（像素）

url string  |  图片地址

data.content.annotations.cover_image.url

封面图片的 URL 地址。

width integer  |  宽度

data.content.annotations.cover_image.width

封面图片宽度（像素）

freshness_info string  |  新鲜度

data.content.annotations.freshness_info

内容新鲜度信息。

logo_url string  |  Logo 地址

data.content.annotations.logo_url

网站 Logo 图标地址。

mobile_url string  |  移动端地址

data.content.annotations.mobile_url

移动端访问地址。

publish_time string  |  发布时间

data.content.annotations.publish_time

网页发布时间。

site_name string  |  站点名

data.content.annotations.site_name

站点名称。

summary string  |  摘要

data.content.annotations.summary

网页内容摘要。

文档引用 object

引用自私域知识库文档的标注信息。

type string  |  类型

data.content.annotations.type

标注类型，此处固定为 doc_citation

chunk_attachment object[]  |  分块附件

data.content.annotations.chunk_attachment

引用分块附带的附件信息列表。

chunk_id integer  |  分块 ID

data.content.annotations.chunk_id

引用文档分块的 ID。

doc_id string  |  文档 ID

data.content.annotations.doc_id

引用文档的 ID。

doc_name string  |  文档名

data.content.annotations.doc_name

引用文档的名称。

text string  |  文本内容

data.content.text

模型生成的文本内容。

模型思维链文本 object

模型思维链文本输出，可在多轮对话中作为上下文回传。

type string  |  类型

data.content.type

内容类型，此处固定为 reasoning_text

annotations object[]  |  标注列表

data.content.annotations

思维链附带的标注信息列表。

网页引用 object

引用自互联网网页的标注信息。

title string  |  标题

data.content.annotations.title

引用网页的标题。

type string  |  类型

data.content.annotations.type

标注类型，此处固定为 url_citation

url string  |  网址

data.content.annotations.url

引用网页的 URL 地址。

cover_image object  |  封面图

data.content.annotations.cover_image

网页封面图片信息。

height integer  |  高度

data.content.annotations.cover_image.height

封面图片高度（像素）

url string  |  图片地址

data.content.annotations.cover_image.url

封面图片的 URL 地址。

width integer  |  宽度

data.content.annotations.cover_image.width

封面图片宽度（像素）

freshness_info string  |  新鲜度

data.content.annotations.freshness_info

内容新鲜度信息。

logo_url string  |  Logo 地址

data.content.annotations.logo_url

网站 Logo 图标地址。

mobile_url string  |  移动端地址

data.content.annotations.mobile_url

移动端访问地址。

publish_time string  |  发布时间

data.content.annotations.publish_time

网页发布时间。

site_name string  |  站点名

data.content.annotations.site_name

站点名称。

summary string  |  摘要

data.content.annotations.summary

网页内容摘要。

文档引用 object

引用自私域知识库文档的标注信息。

type string  |  类型

data.content.annotations.type

标注类型，此处固定为 doc_citation

chunk_attachment object[]  |  分块附件

data.content.annotations.chunk_attachment

引用分块附带的附件信息列表。

chunk_id integer  |  分块 ID

data.content.annotations.chunk_id

引用文档分块的 ID。

doc_id string  |  文档 ID

data.content.annotations.doc_id

引用文档的 ID。

doc_name string  |  文档名

data.content.annotations.doc_name

引用文档的名称。

text string  |  文本内容

data.content.text

模型思维链文本内容。

id string  |  条目 ID

data.id

输入条目的唯一 ID。

partial boolean  |  续写模式

data.partial

是否启用续写模式（仅 assistant 角色支持）

phase string  |  消息阶段

data.phase

标记 assistant 消息属于中间讲解还是最终回答。在回放 assistant 历史消息时，建议保留并原样回传该字段。可选值：commentary、final_answer。

role string  |  角色

data.role

输入消息的角色，可以是 user、system、assistant 或 developer

type string  |  类型

data.type

输入元素类型，此处固定为 message

函数调用记录 object

历史工具函数调用记录，用于多轮对话中回传模型之前发起的函数调用。

type string  |  类型

data.type

输入元素类型，此处固定为 function_call

arguments string  |  参数

data.arguments

函数参数的 JSON 字符串。

call_id string  |  调用 ID

data.call_id

函数工具调用的唯一标识 ID。

id string  |  调用 ID

data.id

函数工具调用的唯一 ID。

name string  |  函数名

data.name

要运行的函数名称。

status string  |  状态

data.status

条目状态。可选值：in_progress、completed、incomplete。

函数返回结果 object

工具函数返回的结果，用于将函数执行结果回传给模型。

type string  |  类型

data.type

输入元素类型，此处固定为 function_call_output

call_id string  |  调用 ID

data.call_id

函数工具调用的唯一标识 ID（与对应 function_call 的 call_id 一致）

id string  |  条目 ID

data.id

函数返回结果的唯一 ID。

output string / object[]  |  输出结果

data.output

工具输出的结果内容。

文本输入 string

文本类型的消息内容，直接传入字符串。

输入的内容列表 object[]

内容元素列表，可包含文本、图片、视频、文件和音频等多种模态输入。

输入模型的文本 object

输入给模型的文本内容。

text string  |  文本

data.output.text

文本内容。

type string  |  类型

data.output.type

内容类型，此处固定为 input_text

translation_options object  |  翻译选项

data.output.translation_options

翻译选项配置。

输入模型的图片 object

输入给模型的图片内容。支持通过 file_id、image_url 或 Base64 编码传入。

type string  |  类型

data.output.type

内容类型，此处固定为 input_image

detail string  |  精度

data.output.detail

图片解析精度。可选值：low、high、xhigh。

file_id string  |  文件 ID

data.output.file_id

文件 ID。

  • 文件 ID 是通过 Files API上传文件后返回的 id。
  • file_id 对应的文件类型需要和 type 保持一致，且文件状态需要为active。
  • API Key 所属项目与 file_id 上传时所属项目需保持一致
image_pixel_limit object  |  像素限制

data.output.image_pixel_limit

图片像素限制配置。

max_pixels integer  |  最大像素

data.output.image_pixel_limit.max_pixels

图片最大像素数，超出时等比例缩小。

min_pixels integer  |  最小像素

data.output.image_pixel_limit.min_pixels

图片最小像素数，低于时等比例放大。

image_url string  |  图片地址

data.output.image_url

图片 URL 或 Base64 编码（格式 data:image/{格式};base64,{编码}）

输入模型的音频 object

输入给模型的音频内容。支持通过 file_id 或 audio_url 传入。

type string  |  类型

data.output.type

内容类型，此处固定为 input_audio

audio_url string  |  音频地址

data.output.audio_url

音频 URL 或 Base64 编码。

chunking_strategy object  |  分段策略

data.output.chunking_strategy

音频分段策略配置。

type string  |  类型

data.output.chunking_strategy.type

分段策略类型，固定为 server_vad（服务端 VAD）

prefix_padding_ms integer  |  前置填充

data.output.chunking_strategy.prefix_padding_ms

语音前置静音填充时长（毫秒）

silence_duration_ms integer  |  静音时长

data.output.chunking_strategy.silence_duration_ms

触发分段的静音持续时长（毫秒）

threshold number  |  检测阈值

data.output.chunking_strategy.threshold

VAD 检测阈值。

file_id string  |  文件 ID

data.output.file_id

文件 ID。

  • 文件 ID 是通过 Files API上传文件后返回的 id。
  • file_id 对应的文件类型需要和 type 保持一致，且文件状态需要为active。
  • API Key 所属项目与 file_id 上传时所属项目需保持一致
输入模型的文件 object

输入给模型的文件内容。支持通过 file_id、file_data（Base64）或 file_url 传入。

type string  |  类型

data.output.type

内容类型，此处固定为 input_file

file_data string  |  文件数据

data.output.file_data

Base64 编码的文件内容（最大 50MB）

file_id string  |  文件 ID

data.output.file_id

文件 ID。

  • 文件 ID 是通过 Files API上传文件后返回的 id。
  • file_id 对应的文件类型需要和 type 保持一致，且文件状态需要为active。
  • API Key 所属项目与 file_id 上传时所属项目需保持一致
file_url string  |  文件地址

data.output.file_url

可访问的文件 URL（最大 50MB）

filename string  |  文件名

data.output.filename

文件名称（使用 file_data 时必传）

输入模型的视频 object

输入给模型的视频内容。支持通过 file_id、video_url 或 Base64 编码传入。

type string  |  类型

data.output.type

内容类型，此处固定为 input_video

video_url string  |  视频地址

data.output.video_url

视频 URL 或 Base64 编码。

file_id string  |  文件 ID

data.output.file_id

文件 ID。

  • 文件 ID 是通过 Files API上传文件后返回的 id。
  • file_id 对应的文件类型需要和 type 保持一致，且文件状态需要为active。
  • API Key 所属项目与 file_id 上传时所属项目需保持一致
fps number  |  抽帧帧率

data.output.fps

取值范围：[0.2, 5]

模型文本输出 object

模型生成的文本输出，可在多轮对话中作为上下文回传。

type string  |  类型

data.output.type

内容类型，此处固定为 output_text

annotations object[]  |  标注列表

data.output.annotations

文本附带的标注信息列表（如引用来源等）

网页引用 object

引用自互联网网页的标注信息。

title string  |  标题

data.output.annotations.title

引用网页的标题。

type string  |  类型

data.output.annotations.type

标注类型，此处固定为 url_citation

url string  |  网址

data.output.annotations.url

引用网页的 URL 地址。

cover_image object  |  封面图

data.output.annotations.cover_image

网页封面图片信息。

height integer  |  高度

data.output.annotations.cover_image.height

封面图片高度（像素）

url string  |  图片地址

data.output.annotations.cover_image.url

封面图片的 URL 地址。

width integer  |  宽度

data.output.annotations.cover_image.width

封面图片宽度（像素）

freshness_info string  |  新鲜度

data.output.annotations.freshness_info

内容新鲜度信息。

logo_url string  |  Logo 地址

data.output.annotations.logo_url

网站 Logo 图标地址。

mobile_url string  |  移动端地址

data.output.annotations.mobile_url

移动端访问地址。

publish_time string  |  发布时间

data.output.annotations.publish_time

网页发布时间。

site_name string  |  站点名

data.output.annotations.site_name

站点名称。

summary string  |  摘要

data.output.annotations.summary

网页内容摘要。

文档引用 object

引用自私域知识库文档的标注信息。

type string  |  类型

data.output.annotations.type

标注类型，此处固定为 doc_citation

chunk_attachment object[]  |  分块附件

data.output.annotations.chunk_attachment

引用分块附带的附件信息列表。

chunk_id integer  |  分块 ID

data.output.annotations.chunk_id

引用文档分块的 ID。

doc_id string  |  文档 ID

data.output.annotations.doc_id

引用文档的 ID。

doc_name string  |  文档名

data.output.annotations.doc_name

引用文档的名称。

text string  |  文本内容

data.output.text

模型生成的文本内容。

模型思维链文本 object

模型思维链文本输出，可在多轮对话中作为上下文回传。

type string  |  类型

data.output.type

内容类型，此处固定为 reasoning_text

annotations object[]  |  标注列表

data.output.annotations

思维链附带的标注信息列表。

网页引用 object

引用自互联网网页的标注信息。

title string  |  标题

data.output.annotations.title

引用网页的标题。

type string  |  类型

data.output.annotations.type

标注类型，此处固定为 url_citation

url string  |  网址

data.output.annotations.url

引用网页的 URL 地址。

cover_image object  |  封面图

data.output.annotations.cover_image

网页封面图片信息。

height integer  |  高度

data.output.annotations.cover_image.height

封面图片高度（像素）

url string  |  图片地址

data.output.annotations.cover_image.url

封面图片的 URL 地址。

width integer  |  宽度

data.output.annotations.cover_image.width

封面图片宽度（像素）

freshness_info string  |  新鲜度

data.output.annotations.freshness_info

内容新鲜度信息。

logo_url string  |  Logo 地址

data.output.annotations.logo_url

网站 Logo 图标地址。

mobile_url string  |  移动端地址

data.output.annotations.mobile_url

移动端访问地址。

publish_time string  |  发布时间

data.output.annotations.publish_time

网页发布时间。

site_name string  |  站点名

data.output.annotations.site_name

站点名称。

summary string  |  摘要

data.output.annotations.summary

网页内容摘要。

文档引用 object

引用自私域知识库文档的标注信息。

type string  |  类型

data.output.annotations.type

标注类型，此处固定为 doc_citation

chunk_attachment object[]  |  分块附件

data.output.annotations.chunk_attachment

引用分块附带的附件信息列表。

chunk_id integer  |  分块 ID

data.output.annotations.chunk_id

引用文档分块的 ID。

doc_id string  |  文档 ID

data.output.annotations.doc_id

引用文档的 ID。

doc_name string  |  文档名

data.output.annotations.doc_name

引用文档的名称。

text string  |  文本内容

data.output.text

模型思维链文本内容。

status string  |  状态

data.status

条目状态。可选值：in_progress、completed、incomplete。

模型思维链信息 object

在模型生成响应时使用的思维链信息。如果需要手动管理，需要设置该字段，以便在后续的对话中进行管理。

status string  |  状态

data.status

推理内容的状态。可选值：in_progress、completed、incomplete。

summary object[]  |  推理摘要

data.summary

推理内容摘要列表。

type string  |  类型

data.summary.type

摘要片段类型，固定为 summary_text

text string  |  摘要文本

data.summary.text

思维链摘要文本内容。

type string  |  类型

data.type

输入元素类型，此处固定为 reasoning

content object[]  |  推理内容

data.content

推理过程的内容元素列表。

模型回答文本 object

模型生成的最终回答文本。

type string  |  类型

data.content.type

内容类型，此处固定为 output_text

annotations object[]  |  标注列表

data.content.annotations

文本附带的标注信息列表（如引用来源等）

网页引用 object

引用自互联网网页的标注信息。

title string  |  标题

data.content.annotations.title

引用网页的标题。

type string  |  类型

data.content.annotations.type

标注类型，此处固定为 url_citation

url string  |  网址

data.content.annotations.url

引用网页的 URL 地址。

cover_image object  |  封面图

data.content.annotations.cover_image

网页封面图片信息。

height integer  |  高度

data.content.annotations.cover_image.height

封面图片高度（像素）

url string  |  图片地址

data.content.annotations.cover_image.url

封面图片的 URL 地址。

width integer  |  宽度

data.content.annotations.cover_image.width

封面图片宽度（像素）

freshness_info string  |  新鲜度

data.content.annotations.freshness_info

内容新鲜度信息。

logo_url string  |  Logo 地址

data.content.annotations.logo_url

网站 Logo 图标地址。

mobile_url string  |  移动端地址

data.content.annotations.mobile_url

移动端访问地址。

publish_time string  |  发布时间

data.content.annotations.publish_time

网页发布时间。

site_name string  |  站点名

data.content.annotations.site_name

站点名称。

summary string  |  摘要

data.content.annotations.summary

网页内容摘要。

文档引用 object

引用自私域知识库文档的标注信息。

type string  |  类型

data.content.annotations.type

标注类型，此处固定为 doc_citation

chunk_attachment object[]  |  分块附件

data.content.annotations.chunk_attachment

引用分块附带的附件信息列表。

chunk_id integer  |  分块 ID

data.content.annotations.chunk_id

引用文档分块的 ID。

doc_id string  |  文档 ID

data.content.annotations.doc_id

引用文档的 ID。

doc_name string  |  文档名

data.content.annotations.doc_name

引用文档的名称。

text string  |  文本内容

data.content.text

模型生成的文本内容。

模型思维链文本 object

模型生成的思维链文本。

type string  |  类型

data.content.type

内容类型，此处固定为 reasoning_text

annotations object[]  |  标注列表

data.content.annotations

思维链附带的标注信息列表。

网页引用 object

引用自互联网网页的标注信息。

title string  |  标题

data.content.annotations.title

引用网页的标题。

type string  |  类型

data.content.annotations.type

标注类型，此处固定为 url_citation

url string  |  网址

data.content.annotations.url

引用网页的 URL 地址。

cover_image object  |  封面图

data.content.annotations.cover_image

网页封面图片信息。

height integer  |  高度

data.content.annotations.cover_image.height

封面图片高度（像素）

url string  |  图片地址

data.content.annotations.cover_image.url

封面图片的 URL 地址。

width integer  |  宽度

data.content.annotations.cover_image.width

封面图片宽度（像素）

freshness_info string  |  新鲜度

data.content.annotations.freshness_info

内容新鲜度信息。

logo_url string  |  Logo 地址

data.content.annotations.logo_url

网站 Logo 图标地址。

mobile_url string  |  移动端地址

data.content.annotations.mobile_url

移动端访问地址。

publish_time string  |  发布时间

data.content.annotations.publish_time

网页发布时间。

site_name string  |  站点名

data.content.annotations.site_name

站点名称。

summary string  |  摘要

data.content.annotations.summary

网页内容摘要。

文档引用 object

引用自私域知识库文档的标注信息。

type string  |  类型

data.content.annotations.type

标注类型，此处固定为 doc_citation

chunk_attachment object[]  |  分块附件

data.content.annotations.chunk_attachment

引用分块附带的附件信息列表。

chunk_id integer  |  分块 ID

data.content.annotations.chunk_id

引用文档分块的 ID。

doc_id string  |  文档 ID

data.content.annotations.doc_id

引用文档的 ID。

doc_name string  |  文档名

data.content.annotations.doc_name

引用文档的名称。

text string  |  文本内容

data.content.text

模型思维链文本内容。

encrypted_content string  |  加密思维链

data.encrypted_content

经加密及压缩处理后的思维链内容原文，用于多轮复用。

id string  |  推理 ID

data.id

推理内容的唯一标识 ID。

MCP 审批请求 object

历史 MCP 工具审批请求记录，用于多轮对话上下文回传。

arguments string  |  调用参数

data.arguments

工具调用参数的 JSON 字符串。

name string  |  工具名

data.name

待运行的工具名称。

server_label string  |  服务标签

data.server_label

发起请求的 MCP Server 标签。

type string  |  类型

data.type

输入元素类型，此处固定为 mcp_approval_request

id string  |  请求 ID

data.id

审批请求的唯一 ID。

MCP 审批响应 object

历史 MCP 工具审批响应记录，回传给模型后据此决定是否调用工具。

approval_request_id string  |  请求 ID

data.approval_request_id

被回应的审批请求 ID。

approve boolean  |  是否批准

data.approve

是否批准该工具调用请求。

type string  |  类型

data.type

输入元素类型，此处固定为 mcp_approval_response

id string  |  响应 ID

data.id

审批响应的唯一 ID。

reason string  |  决策理由

data.reason

决策理由（可选）

MCP 工具清单 object

历史 MCP 工具清单记录，用于多轮对话上下文回传。

server_label string  |  服务标签

data.server_label

MCP Server 标签。

type string  |  类型

data.type

输入元素类型，此处固定为 mcp_list_tools

error string  |  错误信息

data.error

MCP Server 无法返回工具列表时的错误信息。

id string  |  列表 ID

data.id

工具列表的唯一 ID。

tools object[]  |  工具列表

data.tools

该 MCP Server 上可用的工具列表。

name string  |  工具名

data.tools.name

工具名称。

annotations object  |  注解信息

data.tools.annotations

工具的附加注解信息。

description string  |  工具描述

data.tools.description

工具的功能描述。

input_schema object  |  入参 Schema

data.tools.input_schema

描述工具入参的 JSON Schema。

MCP 工具调用 object

历史 MCP 工具调用记录，用于多轮对话上下文回传。

name string  |  工具名

data.name

实际运行的工具名称。

server_label string  |  服务标签

data.server_label

运行工具的 MCP Server 标签。

type string  |  类型

data.type

输入元素类型，此处固定为 mcp_call

arguments string  |  调用参数

data.arguments

传递给工具的调用参数 JSON 字符串。通过 response.mcp_call_arguments.delta 流式追加，初始 output_item.added 事件可能不携带该字段。

error string  |  错误信息

data.error

工具调用失败时的错误信息。

id string  |  调用 ID

data.id

工具调用的唯一 ID。

output string  |  返回结果

data.output

工具调用的返回结果。

上下文元素 object

表示模型生成回复时需参考的上下文内容。该项可以包含文本、图片和视频输入，以及先前助手的回复和工具调用的输出。

id string  |  条目 ID

data.id

引用的上下文条目 ID。

type string  |  类型

data.type

输入元素类型，此处固定为 item_reference

first_id string  |  首条 ID

列表中第一条数据的 ID。

last_id string  |  末条 ID

列表中最后一条数据的 ID。

object string  |  对象类型

固定为 list

has_more boolean  |  是否有更多

标识是否还有更多数据未返回。

  • true：存在未返回的数据。
  • false：已返回全部数据。