# 工具调用事件

> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。

函数调用、Web 搜索、图片处理、MCP、Knowledge 搜索及豆包应用调用相关的流式事件。

## 工具调用（通用）

### response.agent_tool_call.in_progress

> 当 Agent 工具调用进行中时触发的事件。

**item_id** `string` | 调用项 ID

`response.agent_tool_call.in_progress.item_id`

正在处理的 Agent 工具调用项的 ID。

**name** `string` | 工具名称

`response.agent_tool_call.in_progress.name`

Agent 工具的名称。

**output_index** `integer` | 输出项索引

`response.agent_tool_call.in_progress.output_index`

所属输出项的索引。

**sequence_number** `integer` | 序列号

`response.agent_tool_call.in_progress.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.agent_tool_call.in_progress.type`

事件的类型，总是 `response.agent_tool_call.in_progress`

### response.agent_tool_call.completed

> 当 Agent 工具调用完成时触发的事件。

**item_id** `string` | 调用项 ID

`response.agent_tool_call.completed.item_id`

已完成的 Agent 工具调用项的 ID。

**name** `string` | 工具名称

`response.agent_tool_call.completed.name`

Agent 工具的名称。

**output_index** `integer` | 输出项索引

`response.agent_tool_call.completed.output_index`

所属输出项的索引。

**sequence_number** `integer` | 序列号

`response.agent_tool_call.completed.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.agent_tool_call.completed.type`

事件的类型，总是 `response.agent_tool_call.completed`

### response.function_call_arguments.delta

> 存在函数调用参数片段时触发。

**item_id** `string` | 输出项 ID

`response.function_call_arguments.delta.item_id`

所属输出项的唯一 ID。

**output_index** `integer` | 输出项索引

`response.function_call_arguments.delta.output_index`

所属输出项的列表索引。

**sequence_number** `integer` | 序列号

`response.function_call_arguments.delta.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.function_call_arguments.delta.type`

事件的类型，总是 `response.function_call_arguments.delta`

**delta** `string` | 参数增量

`response.function_call_arguments.delta.delta`

本次新增的函数调用参数增量片段。

### response.function_call_arguments.done

> 当函数调用参数完成时触发。

**item_id** `string` | 输出项 ID

`response.function_call_arguments.done.item_id`

所属输出项的唯一 ID。

**output_index** `integer` | 输出项索引

`response.function_call_arguments.done.output_index`

所属输出项的列表索引。

**sequence_number** `integer` | 序列号

`response.function_call_arguments.done.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.function_call_arguments.done.type`

事件的类型，总是 `response.function_call_arguments.done`

**arguments** `string` | 函数参数

`response.function_call_arguments.done.arguments`

函数调用的完整参数。

## 工具调用（web_search）

### response.web_search_call.in_progress

> 当联网搜索工具调用进行中时触发的事件。

**item_id** `string` | 调用项 ID

`response.web_search_call.in_progress.item_id`

本事件关联的调用项的 ID。

**output_index** `integer` | 输出项索引

`response.web_search_call.in_progress.output_index`

本事件关联的输出项的索引。

**sequence_number** `integer` | 序列号

`response.web_search_call.in_progress.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.web_search_call.in_progress.type`

事件的类型，总是 `response.web_search_call.in_progress`

### response.web_search_call.searching

> 当联网搜索工具正在执行搜索时触发的事件。

**item_id** `string` | 调用项 ID

`response.web_search_call.searching.item_id`

本事件关联的调用项的 ID。

**output_index** `integer` | 输出项索引

`response.web_search_call.searching.output_index`

本事件关联的输出项的索引。

**sequence_number** `integer` | 序列号

`response.web_search_call.searching.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.web_search_call.searching.type`

事件的类型，总是 `response.web_search_call.searching`

### response.web_search_call.completed

> 当联网搜索工具调用完成时触发的事件。

**item_id** `string` | 调用项 ID

`response.web_search_call.completed.item_id`

本事件关联的调用项的 ID。

**output_index** `integer` | 输出项索引

`response.web_search_call.completed.output_index`

本事件关联的输出项的索引。

**sequence_number** `integer` | 序列号

`response.web_search_call.completed.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.web_search_call.completed.type`

事件的类型，总是 `response.web_search_call.completed`

## 工具调用（knowledge_search）

### response.knowledge_search_call.in_progress

> 当知识库检索工具调用进行中时触发的事件。

**item_id** `string` | 调用项 ID

`response.knowledge_search_call.in_progress.item_id`

正在处理的知识库检索调用项的 ID。

**output_index** `integer` | 输出项索引

`response.knowledge_search_call.in_progress.output_index`

正在处理的输出项的索引。

**sequence_number** `integer` | 序列号

`response.knowledge_search_call.in_progress.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.knowledge_search_call.in_progress.type`

事件的类型，总是 `response.knowledge_search_call.in_progress`

### response.knowledge_search_call.searching

> 当知识库检索工具正在执行检索时触发的事件。

**item_id** `string` | 调用项 ID

`response.knowledge_search_call.searching.item_id`

正在执行检索的知识库检索调用项的 ID。

**output_index** `integer` | 输出项索引

`response.knowledge_search_call.searching.output_index`

正在执行检索的输出项的索引。

**sequence_number** `integer` | 序列号

`response.knowledge_search_call.searching.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.knowledge_search_call.searching.type`

事件的类型，总是 `response.knowledge_search_call.searching`

### response.knowledge_search_call.completed

> 当知识库检索工具调用完成时触发的事件。

**item_id** `string` | 调用项 ID

`response.knowledge_search_call.completed.item_id`

已完成的知识库检索调用项的 ID。

**output_index** `integer` | 输出项索引

`response.knowledge_search_call.completed.output_index`

已完成的输出项的索引。

**sequence_number** `integer` | 序列号

`response.knowledge_search_call.completed.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.knowledge_search_call.completed.type`

事件的类型，总是 `response.knowledge_search_call.completed`

### response.knowledge_search_call.failed

> 当知识库检索工具调用失败时触发的事件。

**item_id** `string` | 调用项 ID

`response.knowledge_search_call.failed.item_id`

失败的知识库检索调用项的 ID。

**output_index** `integer` | 输出项索引

`response.knowledge_search_call.failed.output_index`

失败的输出项的索引。

**sequence_number** `integer` | 序列号

`response.knowledge_search_call.failed.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.knowledge_search_call.failed.type`

事件的类型，总是 `response.knowledge_search_call.failed`

## 工具调用（image_process）

### response.image_process_call.in_progress

> 当图像处理工具调用进行中时触发的事件。

**item_id** `string` | 调用项 ID

`response.image_process_call.in_progress.item_id`

本事件关联的调用项的 ID。

**output_index** `integer` | 输出项索引

`response.image_process_call.in_progress.output_index`

本事件关联的输出项的索引。

**sequence_number** `integer` | 序列号

`response.image_process_call.in_progress.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.image_process_call.in_progress.type`

事件的类型，总是 `response.image_process_call.in_progress`

### response.image_process_call.progressing

> 当图像处理工具正在处理图像时触发的事件。

**action** `object` | 处理动作

`response.image_process_call.progressing.action`

正在执行的图像处理动作信息。

**type** `string` | 类型

`response.image_process_call.progressing.action.type`

图像处理动作类型。

**result_image_url** `string` | 结果图地址

`response.image_process_call.progressing.action.result_image_url`

处理后图像的 URL 地址。

**arguments** `object` | 处理参数

`response.image_process_call.progressing.arguments`

图像处理动作的输入参数。

**item_id** `string` | 调用项 ID

`response.image_process_call.progressing.item_id`

本事件关联的调用项的 ID。

**output_index** `integer` | 输出项索引

`response.image_process_call.progressing.output_index`

本事件关联的输出项的索引。

**sequence_number** `integer` | 序列号

`response.image_process_call.progressing.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.image_process_call.progressing.type`

事件的类型，总是 `response.image_process_call.progressing`

### response.image_process_call.completed

> 当图像处理工具调用完成时触发的事件。

**action** `object` | 处理动作

`response.image_process_call.completed.action`

已完成的图像处理动作信息。

**type** `string` | 类型

`response.image_process_call.completed.action.type`

图像处理动作类型。

**result_image_url** `string` | 结果图地址

`response.image_process_call.completed.action.result_image_url`

处理后图像的 URL 地址。

**arguments** `object` | 处理参数

`response.image_process_call.completed.arguments`

图像处理动作的输入参数。

**item_id** `string` | 调用项 ID

`response.image_process_call.completed.item_id`

本事件关联的调用项的 ID。

**output_index** `integer` | 输出项索引

`response.image_process_call.completed.output_index`

本事件关联的输出项的索引。

**sequence_number** `integer` | 序列号

`response.image_process_call.completed.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.image_process_call.completed.type`

事件的类型，总是 `response.image_process_call.completed`

## 工具调用（MCP）

### response.mcp_approval_request

> 当 MCP 工具调用需要用户审批时触发的事件。

**function_mcp_approval_request** `object` | 审批请求

`response.mcp_approval_request.function_mcp_approval_request`

需要用户审批的 MCP 工具调用请求。

**arguments** `string` | 调用参数

`response.mcp_approval_request.function_mcp_approval_request.arguments`

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

**name** `string` | 工具名称

`response.mcp_approval_request.function_mcp_approval_request.name`

要调用的工具名称。

**server_label** `string` | MCP 服务器标签

`response.mcp_approval_request.function_mcp_approval_request.server_label`

发起请求的 MCP 服务器的标签。

**type** `string` | 项类型

`response.mcp_approval_request.function_mcp_approval_request.type`

项的类型标识符，用于区分不同类型的输出项。

取值固定为 `mcp_approval_request`。

**id** `string` | 请求 ID

`response.mcp_approval_request.function_mcp_approval_request.id`

审批请求的唯一标识。

**output_index** `integer` | 输出项索引

`response.mcp_approval_request.output_index`

审批请求所属输出项的索引。

**sequence_number** `integer` | 序列号

`response.mcp_approval_request.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.mcp_approval_request.type`

事件的类型，总是 `response.mcp_approval_request`

### response.mcp_call.in_progress

> 当 MCP 工具调用进行中时触发的事件。

**item_id** `string` | 调用项 ID

`response.mcp_call.in_progress.item_id`

正在处理的 MCP 工具调用项的唯一标识。

**output_index** `integer` | 输出项索引

`response.mcp_call.in_progress.output_index`

MCP 调用所在输出项数组中的索引。

**sequence_number** `integer` | 序列号

`response.mcp_call.in_progress.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.mcp_call.in_progress.type`

事件的类型，总是 `response.mcp_call.in_progress`

### response.mcp_call.completed

> 当 MCP 工具调用完成时触发的事件。

**item_id** `string` | 调用项 ID

`response.mcp_call.completed.item_id`

已完成的 MCP 工具调用项的 ID。

**output_index** `integer` | 输出项索引

`response.mcp_call.completed.output_index`

已完成的输出项的索引。

**sequence_number** `integer` | 序列号

`response.mcp_call.completed.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.mcp_call.completed.type`

事件的类型，总是 `response.mcp_call.completed`

### response.mcp_call.failed

> 当 MCP 工具调用失败时触发的事件。

**item_id** `string` | 调用项 ID

`response.mcp_call.failed.item_id`

失败的 MCP 工具调用项的 ID。

**output_index** `integer` | 输出项索引

`response.mcp_call.failed.output_index`

失败的输出项的索引。

**sequence_number** `integer` | 序列号

`response.mcp_call.failed.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.mcp_call.failed.type`

事件的类型，总是 `response.mcp_call.failed`

### response.mcp_call_arguments.delta

> 当 MCP 工具调用参数片段新增时触发的事件。

**delta** `string` | 参数增量

`response.mcp_call_arguments.delta.delta`

本次新增的 MCP 工具调用参数 JSON 字符串片段。

**item_id** `string` | 调用项 ID

`response.mcp_call_arguments.delta.item_id`

正在处理的 MCP 工具调用项的唯一标识。

**output_index** `integer` | 输出项索引

`response.mcp_call_arguments.delta.output_index`

MCP 调用所在输出项数组中的索引。

**sequence_number** `integer` | 序列号

`response.mcp_call_arguments.delta.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.mcp_call_arguments.delta.type`

事件的类型，总是 `response.mcp_call_arguments.delta`

### response.mcp_call_arguments.done

> 当 MCP 工具调用参数完成时触发的事件。

**arguments** `string` | 调用参数

`response.mcp_call_arguments.done.arguments`

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

**item_id** `string` | 调用项 ID

`response.mcp_call_arguments.done.item_id`

正在处理的 MCP 工具调用项的唯一标识。

**output_index** `integer` | 输出项索引

`response.mcp_call_arguments.done.output_index`

MCP 调用所在输出项数组中的索引。

**sequence_number** `integer` | 序列号

`response.mcp_call_arguments.done.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.mcp_call_arguments.done.type`

事件的类型，总是 `response.mcp_call_arguments.done`

### response.mcp_list_tools.in_progress

> 当 MCP 工具列表查询进行中时触发的事件。

**item_id** `string` | 调用项 ID

`response.mcp_list_tools.in_progress.item_id`

正在处理的 MCP 工具列表项的 ID。

**output_index** `integer` | 输出项索引

`response.mcp_list_tools.in_progress.output_index`

正在处理的输出项的索引。

**sequence_number** `integer` | 序列号

`response.mcp_list_tools.in_progress.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.mcp_list_tools.in_progress.type`

事件的类型，总是 `response.mcp_list_tools.in_progress`

### response.mcp_list_tools.completed

> 当 MCP 工具列表查询完成时触发的事件。

**item_id** `string` | 调用项 ID

`response.mcp_list_tools.completed.item_id`

已产出该输出的 MCP 工具列表项的 ID。

**output_index** `integer` | 输出项索引

`response.mcp_list_tools.completed.output_index`

已处理的输出项的索引。

**sequence_number** `integer` | 序列号

`response.mcp_list_tools.completed.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.mcp_list_tools.completed.type`

事件的类型，总是 `response.mcp_list_tools.completed`

### response.mcp_list_tools.failed

> 当 MCP 工具列表查询失败时触发的事件。

**item_id** `string` | 调用项 ID

`response.mcp_list_tools.failed.item_id`

失败的 MCP 工具列表项的 ID。

**output_index** `integer` | 输出项索引

`response.mcp_list_tools.failed.output_index`

失败的输出项的索引。

**sequence_number** `integer` | 序列号

`response.mcp_list_tools.failed.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.mcp_list_tools.failed.type`

事件的类型，总是 `response.mcp_list_tools.failed`

## 工具调用（doubao_app_call）

### response.doubao_app_call.in_progress

> 当豆包应用调用进行中时触发的事件。

**feature** `string` | 调用功能

`response.doubao_app_call.in_progress.feature`

豆包应用调用所使用的功能名。

**item_id** `string` | 调用项 ID

`response.doubao_app_call.in_progress.item_id`

正在处理的豆包应用调用项的 ID。

**output_index** `integer` | 输出项索引

`response.doubao_app_call.in_progress.output_index`

正在处理的输出项的索引。

**sequence_number** `integer` | 序列号

`response.doubao_app_call.in_progress.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.doubao_app_call.in_progress.type`

事件的类型，总是 `response.doubao_app_call.in_progress`

### response.doubao_app_call.completed

> 当豆包应用调用完成时触发的事件。

**blocks** `object[]` | 内容块列表

`response.doubao_app_call.completed.blocks`

豆包应用调用产出的全部内容块。

文本输出 `object`

豆包应用产出的文本输出内容块。

**type** `string` | 类型

`response.doubao_app_call.completed.blocks.type`

内容块类型标识符。

取值固定为 `output_text`。

**id** `string` | 块 ID

`response.doubao_app_call.completed.blocks.id`

内容块的唯一标识。

**parent_id** `string` | 父级 ID

`response.doubao_app_call.completed.blocks.parent_id`

所属父级条目的 ID。

**status** `string` | 状态

`response.doubao_app_call.completed.blocks.status`

内容块状态。

**text** `string` | 文本内容

`response.doubao_app_call.completed.blocks.text`

思维链文本 `object`

豆包应用产出的思维链文本内容块。

**type** `string` | 类型

`response.doubao_app_call.completed.blocks.type`

内容块类型标识符。

取值固定为 `reasoning_text`。

**id** `string` | 块 ID

`response.doubao_app_call.completed.blocks.id`

内容块的唯一标识。

**parent_id** `string` | 父级 ID

`response.doubao_app_call.completed.blocks.parent_id`

所属父级条目的 ID。

**reasoning_text** `string` | 思考文本

`response.doubao_app_call.completed.blocks.reasoning_text`

思维链文本内容。

**status** `string` | 状态

`response.doubao_app_call.completed.blocks.status`

内容块状态。

搜索过程 `object`

豆包应用 AI 搜索过程产出的内容块。

**type** `string` | 类型

`response.doubao_app_call.completed.blocks.type`

内容块类型标识符。

取值固定为 `search`。

**id** `string` | 块 ID

`response.doubao_app_call.completed.blocks.id`

内容块的唯一标识。

**parent_id** `string` | 父级 ID

`response.doubao_app_call.completed.blocks.parent_id`

所属父级条目的 ID。

**queries** `string[]` | 查询语句

`response.doubao_app_call.completed.blocks.queries`

搜索查询语句列表。

**results** `object[]` | 搜索结果

`response.doubao_app_call.completed.blocks.results`

搜索结果列表。

**text_card** `object` | 文本卡片

`response.doubao_app_call.completed.blocks.results.text_card`

文本卡片形式的搜索结果。

**sitename** `string` | 站点名

`response.doubao_app_call.completed.blocks.results.text_card.sitename`

来源站点名称。

**title** `string` | 标题

`response.doubao_app_call.completed.blocks.results.text_card.title`

搜索结果标题。

**url** `string` | 网址

`response.doubao_app_call.completed.blocks.results.text_card.url`

搜索结果 URL 地址。

**status** `string` | 状态

`response.doubao_app_call.completed.blocks.status`

内容块状态。

**summary** `string` | 搜索总结

`response.doubao_app_call.completed.blocks.summary`

AI 搜索过程中对本轮搜索结果的总结性文字，概括从搜索结果中提取的核心信息。

推理搜索过程 `object`

豆包应用推理搜索过程产出的内容块。

**type** `string` | 类型

`response.doubao_app_call.completed.blocks.type`

内容块类型。

取值固定为 `reasoning_search`。

**id** `string` | 块 ID

`response.doubao_app_call.completed.blocks.id`

内容块的唯一标识。

**parent_id** `string` | 父级 ID

`response.doubao_app_call.completed.blocks.parent_id`

所属父级条目的 ID。

**queries** `string[]` | 查询语句

`response.doubao_app_call.completed.blocks.queries`

搜索查询语句列表。

**results** `object[]` | 搜索结果

`response.doubao_app_call.completed.blocks.results`

搜索结果列表。

**text_card** `object` | 文本卡片

`response.doubao_app_call.completed.blocks.results.text_card`

文本卡片形式的搜索结果。

**sitename** `string` | 站点名

`response.doubao_app_call.completed.blocks.results.text_card.sitename`

来源站点名称。

**title** `string` | 标题

`response.doubao_app_call.completed.blocks.results.text_card.title`

搜索结果标题。

**url** `string` | 网址

`response.doubao_app_call.completed.blocks.results.text_card.url`

搜索结果 URL 地址。

**status** `string` | 状态

`response.doubao_app_call.completed.blocks.status`

推理搜索内容块的处理状态。可选值：`in_progress`、`searching`、`completed`、`incomplete`、`failed`。

**summary** `string` | 搜索总结

`response.doubao_app_call.completed.blocks.summary`

推理搜索过程中对本轮搜索结果的总结性文字，概括从搜索结果中提取的核心信息。

**feature** `string` | 调用功能

`response.doubao_app_call.completed.feature`

豆包应用调用所使用的功能名。

**item_id** `string` | 调用项 ID

`response.doubao_app_call.completed.item_id`

已完成的豆包应用调用项的 ID。

**output_index** `integer` | 输出项索引

`response.doubao_app_call.completed.output_index`

已完成的输出项的索引。

**sequence_number** `integer` | 序列号

`response.doubao_app_call.completed.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.doubao_app_call.completed.type`

事件的类型，总是 `response.doubao_app_call.completed`

### response.doubao_app_call.failed

> 当豆包应用调用失败时触发的事件。

**item_id** `string` | 调用项 ID

`response.doubao_app_call.failed.item_id`

失败的豆包应用调用项的 ID。

**output_index** `integer` | 输出项索引

`response.doubao_app_call.failed.output_index`

失败的输出项的索引。

**sequence_number** `integer` | 序列号

`response.doubao_app_call.failed.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.doubao_app_call.failed.type`

事件的类型，总是 `response.doubao_app_call.failed`

**error_message** `string` | 错误信息

`response.doubao_app_call.failed.error_message`

失败原因的描述信息。

### response.doubao_app_call_block.added

> 当豆包应用调用新增一个内容块时触发的事件。

**block** `object` | 内容块

`response.doubao_app_call_block.added.block`

新增的内容块。

文本输出 `object`

豆包应用产出的文本输出内容块。

**type** `string` | 类型

`response.doubao_app_call_block.added.block.type`

内容块类型标识符。

取值固定为 `output_text`。

**id** `string` | 块 ID

`response.doubao_app_call_block.added.block.id`

内容块的唯一标识。

**parent_id** `string` | 父级 ID

`response.doubao_app_call_block.added.block.parent_id`

所属父级条目的 ID。

**status** `string` | 状态

`response.doubao_app_call_block.added.block.status`

内容块状态。

**text** `string` | 文本内容

`response.doubao_app_call_block.added.block.text`

思维链文本 `object`

豆包应用产出的思维链文本内容块。

**type** `string` | 类型

`response.doubao_app_call_block.added.block.type`

内容块类型标识符。

取值固定为 `reasoning_text`。

**id** `string` | 块 ID

`response.doubao_app_call_block.added.block.id`

内容块的唯一标识。

**parent_id** `string` | 父级 ID

`response.doubao_app_call_block.added.block.parent_id`

所属父级条目的 ID。

**reasoning_text** `string` | 思考文本

`response.doubao_app_call_block.added.block.reasoning_text`

思维链文本内容。

**status** `string` | 状态

`response.doubao_app_call_block.added.block.status`

内容块状态。

搜索过程 `object`

豆包应用 AI 搜索过程产出的内容块。

**type** `string` | 类型

`response.doubao_app_call_block.added.block.type`

内容块类型标识符。

取值固定为 `search`。

**id** `string` | 块 ID

`response.doubao_app_call_block.added.block.id`

内容块的唯一标识。

**parent_id** `string` | 父级 ID

`response.doubao_app_call_block.added.block.parent_id`

所属父级条目的 ID。

**queries** `string[]` | 查询语句

`response.doubao_app_call_block.added.block.queries`

搜索查询语句列表。

**results** `object[]` | 搜索结果

`response.doubao_app_call_block.added.block.results`

搜索结果列表。

**text_card** `object` | 文本卡片

`response.doubao_app_call_block.added.block.results.text_card`

文本卡片形式的搜索结果。

**sitename** `string` | 站点名

`response.doubao_app_call_block.added.block.results.text_card.sitename`

来源站点名称。

**title** `string` | 标题

`response.doubao_app_call_block.added.block.results.text_card.title`

搜索结果标题。

**url** `string` | 网址

`response.doubao_app_call_block.added.block.results.text_card.url`

搜索结果 URL 地址。

**status** `string` | 状态

`response.doubao_app_call_block.added.block.status`

内容块状态。

**summary** `string` | 搜索总结

`response.doubao_app_call_block.added.block.summary`

AI 搜索过程中对本轮搜索结果的总结性文字，概括从搜索结果中提取的核心信息。

推理搜索过程 `object`

豆包应用推理搜索过程产出的内容块。

**type** `string` | 类型

`response.doubao_app_call_block.added.block.type`

内容块类型。

取值固定为 `reasoning_search`。

**id** `string` | 块 ID

`response.doubao_app_call_block.added.block.id`

内容块的唯一标识。

**parent_id** `string` | 父级 ID

`response.doubao_app_call_block.added.block.parent_id`

所属父级条目的 ID。

**queries** `string[]` | 查询语句

`response.doubao_app_call_block.added.block.queries`

搜索查询语句列表。

**results** `object[]` | 搜索结果

`response.doubao_app_call_block.added.block.results`

搜索结果列表。

**text_card** `object` | 文本卡片

`response.doubao_app_call_block.added.block.results.text_card`

文本卡片形式的搜索结果。

**sitename** `string` | 站点名

`response.doubao_app_call_block.added.block.results.text_card.sitename`

来源站点名称。

**title** `string` | 标题

`response.doubao_app_call_block.added.block.results.text_card.title`

搜索结果标题。

**url** `string` | 网址

`response.doubao_app_call_block.added.block.results.text_card.url`

搜索结果 URL 地址。

**status** `string` | 状态

`response.doubao_app_call_block.added.block.status`

推理搜索内容块的处理状态。可选值：`in_progress`、`searching`、`completed`、`incomplete`、`failed`。

**summary** `string` | 搜索总结

`response.doubao_app_call_block.added.block.summary`

推理搜索过程中对本轮搜索结果的总结性文字，概括从搜索结果中提取的核心信息。

**item_id** `string` | 调用项 ID

`response.doubao_app_call_block.added.item_id`

豆包应用调用项的 ID。

**output_index** `integer` | 输出项索引

`response.doubao_app_call_block.added.output_index`

所属输出项的索引。

**sequence_number** `integer` | 序列号

`response.doubao_app_call_block.added.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.doubao_app_call_block.added.type`

事件的类型，总是 `response.doubao_app_call_block.added`

### response.doubao_app_call_block.done

> 当豆包应用调用的内容块完成时触发的事件。

**block** `object` | 内容块

`response.doubao_app_call_block.done.block`

已完成的内容块。

文本输出 `object`

豆包应用产出的文本输出内容块。

**type** `string` | 类型

`response.doubao_app_call_block.done.block.type`

内容块类型标识符。

取值固定为 `output_text`。

**id** `string` | 块 ID

`response.doubao_app_call_block.done.block.id`

内容块的唯一标识。

**parent_id** `string` | 父级 ID

`response.doubao_app_call_block.done.block.parent_id`

所属父级条目的 ID。

**status** `string` | 状态

`response.doubao_app_call_block.done.block.status`

内容块状态。

**text** `string` | 文本内容

`response.doubao_app_call_block.done.block.text`

思维链文本 `object`

豆包应用产出的思维链文本内容块。

**type** `string` | 类型

`response.doubao_app_call_block.done.block.type`

内容块类型标识符。

取值固定为 `reasoning_text`。

**id** `string` | 块 ID

`response.doubao_app_call_block.done.block.id`

内容块的唯一标识。

**parent_id** `string` | 父级 ID

`response.doubao_app_call_block.done.block.parent_id`

所属父级条目的 ID。

**reasoning_text** `string` | 思考文本

`response.doubao_app_call_block.done.block.reasoning_text`

思维链文本内容。

**status** `string` | 状态

`response.doubao_app_call_block.done.block.status`

内容块状态。

搜索过程 `object`

豆包应用 AI 搜索过程产出的内容块。

**type** `string` | 类型

`response.doubao_app_call_block.done.block.type`

内容块类型标识符。

取值固定为 `search`。

**id** `string` | 块 ID

`response.doubao_app_call_block.done.block.id`

内容块的唯一标识。

**parent_id** `string` | 父级 ID

`response.doubao_app_call_block.done.block.parent_id`

所属父级条目的 ID。

**queries** `string[]` | 查询语句

`response.doubao_app_call_block.done.block.queries`

搜索查询语句列表。

**results** `object[]` | 搜索结果

`response.doubao_app_call_block.done.block.results`

搜索结果列表。

**text_card** `object` | 文本卡片

`response.doubao_app_call_block.done.block.results.text_card`

文本卡片形式的搜索结果。

**sitename** `string` | 站点名

`response.doubao_app_call_block.done.block.results.text_card.sitename`

来源站点名称。

**title** `string` | 标题

`response.doubao_app_call_block.done.block.results.text_card.title`

搜索结果标题。

**url** `string` | 网址

`response.doubao_app_call_block.done.block.results.text_card.url`

搜索结果 URL 地址。

**status** `string` | 状态

`response.doubao_app_call_block.done.block.status`

内容块状态。

**summary** `string` | 搜索总结

`response.doubao_app_call_block.done.block.summary`

AI 搜索过程中对本轮搜索结果的总结性文字，概括从搜索结果中提取的核心信息。

推理搜索过程 `object`

豆包应用推理搜索过程产出的内容块。

**type** `string` | 类型

`response.doubao_app_call_block.done.block.type`

内容块类型。

取值固定为 `reasoning_search`。

**id** `string` | 块 ID

`response.doubao_app_call_block.done.block.id`

内容块的唯一标识。

**parent_id** `string` | 父级 ID

`response.doubao_app_call_block.done.block.parent_id`

所属父级条目的 ID。

**queries** `string[]` | 查询语句

`response.doubao_app_call_block.done.block.queries`

搜索查询语句列表。

**results** `object[]` | 搜索结果

`response.doubao_app_call_block.done.block.results`

搜索结果列表。

**text_card** `object` | 文本卡片

`response.doubao_app_call_block.done.block.results.text_card`

文本卡片形式的搜索结果。

**sitename** `string` | 站点名

`response.doubao_app_call_block.done.block.results.text_card.sitename`

来源站点名称。

**title** `string` | 标题

`response.doubao_app_call_block.done.block.results.text_card.title`

搜索结果标题。

**url** `string` | 网址

`response.doubao_app_call_block.done.block.results.text_card.url`

搜索结果 URL 地址。

**status** `string` | 状态

`response.doubao_app_call_block.done.block.status`

推理搜索内容块的处理状态。可选值：`in_progress`、`searching`、`completed`、`incomplete`、`failed`。

**summary** `string` | 搜索总结

`response.doubao_app_call_block.done.block.summary`

推理搜索过程中对本轮搜索结果的总结性文字，概括从搜索结果中提取的核心信息。

**item_id** `string` | 调用项 ID

`response.doubao_app_call_block.done.item_id`

豆包应用调用项的 ID。

**output_index** `integer` | 输出项索引

`response.doubao_app_call_block.done.output_index`

所属输出项的索引。

**sequence_number** `integer` | 序列号

`response.doubao_app_call_block.done.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.doubao_app_call_block.done.type`

事件的类型，总是 `response.doubao_app_call_block.done`

### response.doubao_app_call_output_text.delta

> 当豆包应用调用的输出文本片段新增时触发的事件。

**item_id** `string` | 调用项 ID

`response.doubao_app_call_output_text.delta.item_id`

豆包应用调用项的 ID。

**output_index** `integer` | 输出项索引

`response.doubao_app_call_output_text.delta.output_index`

所属输出项的索引。

**sequence_number** `integer` | 序列号

`response.doubao_app_call_output_text.delta.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.doubao_app_call_output_text.delta.type`

事件的类型，总是 `response.doubao_app_call_output_text.delta`

**block_index** `integer` | 块索引

`response.doubao_app_call_output_text.delta.block_index`

所属内容块的索引。

**delta** `string` | 文本增量

`response.doubao_app_call_output_text.delta.delta`

本次新增的输出文本片段。

### response.doubao_app_call_output_text.done

> 当豆包应用调用的输出文本完成时触发的事件。

**item_id** `string` | 调用项 ID

`response.doubao_app_call_output_text.done.item_id`

豆包应用调用项的 ID。

**output_index** `integer` | 输出项索引

`response.doubao_app_call_output_text.done.output_index`

所属输出项的索引。

**sequence_number** `integer` | 序列号

`response.doubao_app_call_output_text.done.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.doubao_app_call_output_text.done.type`

事件的类型，总是 `response.doubao_app_call_output_text.done`

**block_index** `integer` | 块索引

`response.doubao_app_call_output_text.done.block_index`

所属内容块的索引。

**text** `string` | 完整文本

`response.doubao_app_call_output_text.done.text`

完整的输出文本内容。

### response.doubao_app_call_reasoning_search.in_progress

> 当豆包应用调用的推理搜索进行中时触发的事件。

**item_id** `string` | 调用项 ID

`response.doubao_app_call_reasoning_search.in_progress.item_id`

豆包应用调用项的 ID。

**output_index** `integer` | 输出项索引

`response.doubao_app_call_reasoning_search.in_progress.output_index`

所属输出项的索引。

**sequence_number** `integer` | 序列号

`response.doubao_app_call_reasoning_search.in_progress.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.doubao_app_call_reasoning_search.in_progress.type`

事件的类型，总是 `response.doubao_app_call_reasoning_search.in_progress`

**block_index** `integer` | 块索引

`response.doubao_app_call_reasoning_search.in_progress.block_index`

所属内容块的索引。

### response.doubao_app_call_reasoning_search.searching

> 当豆包应用调用的推理搜索正在执行时触发的事件。

**item_id** `string` | 调用项 ID

`response.doubao_app_call_reasoning_search.searching.item_id`

豆包应用调用项的 ID。

**output_index** `integer` | 输出项索引

`response.doubao_app_call_reasoning_search.searching.output_index`

所属输出项的索引。

**sequence_number** `integer` | 序列号

`response.doubao_app_call_reasoning_search.searching.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.doubao_app_call_reasoning_search.searching.type`

事件的类型，总是 `response.doubao_app_call_reasoning_search.searching`

**block_index** `integer` | 块索引

`response.doubao_app_call_reasoning_search.searching.block_index`

所属内容块的索引。

**searching_state** `string` | 搜索状态

`response.doubao_app_call_reasoning_search.searching.searching_state`

搜索阶段的状态描述。

### response.doubao_app_call_reasoning_search.completed

> 当豆包应用调用的推理搜索完成时触发的事件。

**item_id** `string` | 调用项 ID

`response.doubao_app_call_reasoning_search.completed.item_id`

豆包应用调用项的 ID。

**output_index** `integer` | 输出项索引

`response.doubao_app_call_reasoning_search.completed.output_index`

所属输出项的索引。

**queries** `string[]` | 查询语句

`response.doubao_app_call_reasoning_search.completed.queries`

执行的搜索查询。

**results** `object[]` | 搜索结果

`response.doubao_app_call_reasoning_search.completed.results`

搜索结果列表。

**text_card** `object` | 文本卡片

`response.doubao_app_call_reasoning_search.completed.results.text_card`

文本卡片形式的搜索结果。

**sitename** `string` | 站点名

`response.doubao_app_call_reasoning_search.completed.results.text_card.sitename`

来源站点名称。

**title** `string` | 标题

`response.doubao_app_call_reasoning_search.completed.results.text_card.title`

搜索结果标题。

**url** `string` | 网址

`response.doubao_app_call_reasoning_search.completed.results.text_card.url`

搜索结果 URL 地址。

**sequence_number** `integer` | 序列号

`response.doubao_app_call_reasoning_search.completed.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.doubao_app_call_reasoning_search.completed.type`

事件的类型，总是 `response.doubao_app_call_reasoning_search.completed`

**block_index** `integer` | 块索引

`response.doubao_app_call_reasoning_search.completed.block_index`

所属内容块的索引。

**summary** `string` | 搜索摘要

`response.doubao_app_call_reasoning_search.completed.summary`

推理搜索的摘要。

### response.doubao_app_call_reasoning_text.delta

> 当豆包应用调用的推理文本片段新增时触发的事件。

**item_id** `string` | 调用项 ID

`response.doubao_app_call_reasoning_text.delta.item_id`

豆包应用调用项的 ID。

**output_index** `integer` | 输出项索引

`response.doubao_app_call_reasoning_text.delta.output_index`

所属输出项的索引。

**sequence_number** `integer` | 序列号

`response.doubao_app_call_reasoning_text.delta.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.doubao_app_call_reasoning_text.delta.type`

事件的类型，总是 `response.doubao_app_call_reasoning_text.delta`

**block_index** `integer` | 块索引

`response.doubao_app_call_reasoning_text.delta.block_index`

所属内容块的索引。

**delta** `string` | 推理增量

`response.doubao_app_call_reasoning_text.delta.delta`

本次新增的推理文本片段。

### response.doubao_app_call_reasoning_text.done

> 当豆包应用调用的推理文本完成时触发的事件。

**item_id** `string` | 调用项 ID

`response.doubao_app_call_reasoning_text.done.item_id`

豆包应用调用项的 ID。

**output_index** `integer` | 输出项索引

`response.doubao_app_call_reasoning_text.done.output_index`

所属输出项的索引。

**sequence_number** `integer` | 序列号

`response.doubao_app_call_reasoning_text.done.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.doubao_app_call_reasoning_text.done.type`

事件的类型，总是 `response.doubao_app_call_reasoning_text.done`

**block_index** `integer` | 块索引

`response.doubao_app_call_reasoning_text.done.block_index`

所属内容块的索引。

**text** `string` | 推理文本

`response.doubao_app_call_reasoning_text.done.text`

完整的推理文本内容。

### response.doubao_app_call_search.in_progress

> 当豆包应用调用的搜索进行中时触发的事件。

**item_id** `string` | 调用项 ID

`response.doubao_app_call_search.in_progress.item_id`

豆包应用调用项的 ID。

**output_index** `integer` | 输出项索引

`response.doubao_app_call_search.in_progress.output_index`

所属输出项的索引。

**sequence_number** `integer` | 序列号

`response.doubao_app_call_search.in_progress.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.doubao_app_call_search.in_progress.type`

事件的类型，总是 `response.doubao_app_call_search.in_progress`

**block_index** `integer` | 块索引

`response.doubao_app_call_search.in_progress.block_index`

所属内容块的索引。

### response.doubao_app_call_search.searching

> 当豆包应用调用的搜索正在执行时触发的事件。

**item_id** `string` | 调用项 ID

`response.doubao_app_call_search.searching.item_id`

豆包应用调用项的 ID。

**output_index** `integer` | 输出项索引

`response.doubao_app_call_search.searching.output_index`

所属输出项的索引。

**sequence_number** `integer` | 序列号

`response.doubao_app_call_search.searching.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.doubao_app_call_search.searching.type`

事件的类型，总是 `response.doubao_app_call_search.searching`

**block_index** `integer` | 块索引

`response.doubao_app_call_search.searching.block_index`

所属内容块的索引。

**searching_state** `string` | 搜索状态

`response.doubao_app_call_search.searching.searching_state`

搜索阶段的状态描述。

### response.doubao_app_call_search.completed

> 当豆包应用调用的搜索完成时触发的事件。

**item_id** `string` | 调用项 ID

`response.doubao_app_call_search.completed.item_id`

豆包应用调用项的 ID。

**output_index** `integer` | 输出项索引

`response.doubao_app_call_search.completed.output_index`

所属输出项的索引。

**queries** `string[]` | 查询语句

`response.doubao_app_call_search.completed.queries`

执行的搜索查询。

**results** `object[]` | 搜索结果

`response.doubao_app_call_search.completed.results`

搜索结果列表。

**text_card** `object` | 文本卡片

`response.doubao_app_call_search.completed.results.text_card`

文本卡片形式的搜索结果。

**sitename** `string` | 站点名

`response.doubao_app_call_search.completed.results.text_card.sitename`

来源站点名称。

**title** `string` | 标题

`response.doubao_app_call_search.completed.results.text_card.title`

搜索结果标题。

**url** `string` | 网址

`response.doubao_app_call_search.completed.results.text_card.url`

搜索结果 URL 地址。

**sequence_number** `integer` | 序列号

`response.doubao_app_call_search.completed.sequence_number`

事件的序列号。

**type** `string` | 事件类型

`response.doubao_app_call_search.completed.type`

事件的类型，总是 `response.doubao_app_call_search.completed`

**block_index** `integer` | 块索引

`response.doubao_app_call_search.completed.block_index`

所属内容块的索引。

**summary** `string` | 搜索摘要

`response.doubao_app_call_search.completed.summary`

搜索结果的摘要。