深度研究对话

此功能允许OpenClaw代理与用户就给定主题进行深入的研究讨论。API密钥会自动从OpenClaw配置中加载——无需手动设置。

API 表格

工作流程

路径A：不涉及文件的主题讨论

1. 调用深度研究对话直接响应用户查询。系统将自动创建新对话。

路径B：涉及文件的主题讨论

1. 调用创建对话以获取对话ID。
2. 调用文件上传接口并携带对话ID以上传文件。
3. 调用文件解析提交接口并携带返回的文件ID。
4. 轮询文件解析查询每几秒重试直至解析成功。
5. 调用DeepresearchConversation接口时需携带查询内容、会话ID与文件标识符参数。

多轮对话规则

• DeepresearchConversation API 为SSE流式传输接口，采用增量数据返回机制。
• 首次调用后，必须在后续所有调用中传递会话ID。
• 若响应包含中断标识符（用于"需求澄清"或"大纲确认"场景），则下次调用必须携带该标识符。interrupt_id.
• 如果响应中包含structured_outline，请将其呈现给用户以进行确认/修改，然后在下次调用中传递最终的大纲。
• 持续迭代调用 DeepresearchConversation，直到用户对结果满意为止。

API接口

ConversationCreate API

参数

无参数

执行 shell

curl -X POST "https://qianfan.baidubce.com/v2/agent/deepresearch/create" \
  -H "X-Appbuilder-From: openclaw" \
  -H "Authorization: Bearer $BAIDU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

FileUpload API

参数

• agent_code: 固定值"deepresearch"(必需)
• conversation_id: 来自 ConversationCreate 响应 (必需)
• file: 本地文件二进制数据 (与 file_url 互斥)。最多 10 个文件。支持格式:
  • 文本：.doc、.docx、.txt、.pdf、.ppt、.pptx（txt ≤ 10MB，pdf ≤ 100MB/3000页，doc/docx ≤ 100MB/2500页，ppt/pptx ≤ 400页）
  • 表格：.xlsx、.xls（≤ 100MB，仅限单个工作表）
  • 图像：.png、.jpg、.jpeg、.bmp（每个 ≤ 10MB）
  • 音频：.wav、.pcm（≤ 10MB）
• 文件URL：文件的公开URL（与文件上传互斥）

本地文件上传

curl -X POST "https://qianfan.baidubce.com/v2/agent/file/upload" \
  -H "Authorization: Bearer $BAIDU_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -H "X-Appbuilder-From: openclaw" \
  -F "agent_code=deepresearch" \
  -F "conversation_id=$conversation_id" \
  -F "file=@local_file_path"

文件URL上传

curl -X POST "https://qianfan.baidubce.com/v2/agent/file/upload" \
  -H "Authorization: Bearer $BAIDU_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -H "X-Appbuilder-From: openclaw" \
  -F "agent_code=deepresearch" \
  -F "conversation_id=$conversation_id" \
  -F "file_url=$file_url"

文件解析提交API

参数

• 文件ID：来自文件上传响应（必需）

执行shell

curl -X POST "https://qianfan.baidubce.com/v2/agent/file/parse/submit" \
  -H "Authorization: Bearer $BAIDU_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Appbuilder-From: openclaw" \
  -d '{"file_id": "$file_id"}'

文件解析查询API

参数

• 任务ID：来自文件解析提交响应（必需）

执行shell

curl -X GET "https://qianfan.baidubce.com/v2/agent/file/parse/query?task_id=$task_id" \
  -H "Authorization: Bearer $BAIDU_API_KEY" \
  -H "X-Appbuilder-From: openclaw"

深度研究对话API

参数

• 查询：用户的问题或研究主题（必需）
• conversation_id: 首次调用时可选（自动生成）。后续调用时必需。
• file_ids: 已解析文件ID列表（可选，仅在讨论文件时使用）
• interrupt_id: 当回应上一轮的“需求澄清”或“大纲确认”时必需。可在上一轮SSE响应的content.text.data中找到。
• structured_outline: 研究报告大纲。如果上一轮生成了大纲，则后续调用时必需。结构：

{
    "title": "string",
    "locale": "string",
    "description": "string",
    "sub_chapters": [
        {
            "title": "string",
            "locale": "string",
            "description": "string",
            "sub_chapters": []
        }
    ]
}

• version:"Lite"（更快，10分钟内）或"Standard"（更深入，较慢）。默认："Standard"。

执行shell

python3 scripts/deepresearch_conversation.py '{"query": "your question here", "version": "Standard"}'

包含所有参数的示例

python3 scripts/deepresearch_conversation.py '{"query": "the question", "file_ids": ["file_id_1"], "interrupt_id": "interrupt_id", "conversation_id": "conversation_id", "structured_outline": {"title": "Report Title", "locale": "zh", "description": "desc", "sub_chapters": [{"title": "Chapter 1", "locale": "zh", "description": "chapter desc", "sub_chapters": []}]}, "version": "Standard"}'