深度研究Agent运行接口
更新时间：2026-01-07
POST
https://qianfan.baidubce.com/v2/agent/deepresearch/run
运行深度研究智能体，支持多轮流式对话与研究任务全生命周期管理
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
query
string
输入的对话信息。
根据用户输入的 query 判断是简单问答还是进行深度研究。
必选
conversation_id
string
对话ID。
首轮对话：可不填，由服务端自动生成并在响应中返回，也可通过对话创建接口预先获取对话ID。
后续对话：必须填写，以保持上下文连续性，可在sse数据流获取 conversation_id。
可选
file_ids
array
传入的文件 ID 列表。
请确保文件已依次完成以下步骤：
1. 通过文件上传接口获取 file_id
2. 调用文件解析提交接口完成内容解析且解析成功，可通过文件解析查询接口查询解析结果file_id 必须由当前对话（即本次请求的 conversation_id）上传生成，且仅限在本对话中使用。
可选
显示子属性
隐藏子属性
items
string
interrupt_id
string
中断/干预 ID。
在回复 Agent 的“需求澄清”或“大纲确认”请求时必填。
该字段内容在上一轮 SSE 响应中 content.text.data 字段内获取。
可选
structured_outline
object {4}
深度研究报告的结构化大纲。
若上一轮对话输出为大纲确认数据，用户可基于大纲内容进行修改，下一轮对话请求携带最终大纲即可。
Agent 将严格依据此数据生成后续的研究报告。
可选
显示子属性
隐藏子属性
locale
string
指定报告生成的目标语言，默认简体中文。
可选
title
string
报告标题。
可修改此字段以调整报告主题。
可选
description
string
报告摘要。
指导 Agent 全文写作。
可选
sub_chapters
array
子章节列表，支持递归嵌套。
章节当前仅支持2级。
可选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
title
string
章节标题。
可选
description
string
章节写作指引。
可对章节内容、组织结构、语言风格等给出明确要求。
可选
sub_chapters
array
子章节列表，支持递归嵌套。
可选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
title
string
子章节标题。
可选
description
string
子章节写作指引。
可选
sub_chapters
array
子章节列表，支持递归嵌套。
可选
显示子属性
隐藏子属性
items
object
显示子属性
隐藏子属性
请求结构
POST /v2/agent/deepresearch/run HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"query": "研究AI市场",
"conversation_id": "5f54660a-4846-495e-bc99-e0c0d6db8a7d",
"interrupt_id": "83e03dfa-3077-4a3f-80cb-1ee991c219ae",
"structured_outline": {
"locale": "简体中文",
"title": "全球人工智能市场研究与战略分析报告",
"description": "本报告全面分析全球AI市场的发展现状、技术趋势、应用场景、竞争格局，并提供面向企业决策者、投资者和行业研究者的未来3-5年预测与投资建议。",
"sub_chapters": [
{
"title": "全球AI市场概述与技术趋势",
"description": "回顾过去5年AI市场发展,分析当前全球市场规模、增长驱动因素及核心技术趋势,包括大模型和多模态AI的演进。",
"sub_chapters": [
{
"title": "市场发展回顾与现状",
"description": "总结过去5年全球AI市场的关键里程碑、增长数据和主要推动力。",
"sub_chapters": []
}
]
}
]
}
}示例代码
基础调用
curl -X POST "https://qianfan.baidubce.com/v2/agent/deepresearch/run" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"query": "研究AI市场",
"conversation_id": "5f54660a-4846-495e-bc99-e0c0d6db8a7d",
"interrupt_id": "83e03dfa-3077-4a3f-80cb-1ee991c219ae",
"structured_outline": {
"locale": "简体中文",
"title": "全球人工智能市场研究与战略分析报告",
"description": "本报告全面分析全球AI市场的发展现状、技术趋势、应用场景、竞争格局，并提供面向企业决策者、投资者和行业研究者的未来3-5年预测与投资建议。",
"sub_chapters": [
{
"title": "全球AI市场概述与技术趋势",
"description": "回顾过去5年AI市场发展，分析当前全球市场规模、增长驱动因素及核心技术趋势，包括大模型和多模态AI的演进。",
"sub_chapters": [
{
"title": "市场发展回顾与现状",
"description": "总结过去5年全球AI市场的关键里程碑、增长数据和主要推动力。",
"sub_chapters": []
}
]
}
]
}
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
response
object {0}
成功响应，返回SSE流式数据。
具体数据结构请参考SSE事件流格式。
可选
显示子属性
隐藏子属性
暂无参数
成功响应
{}