deepresearch

📌 多轮深度研究,智能生成报告大纲

agent-research榜 #1

基于文心大模型的深度研究对话能力,支持多轮流式交互、文件解析与结构化大纲生成,适用于复杂课题调研与报告撰写场景。

收藏
18.3k
安装
6.8k
版本
1.1.0
CLS 安全性认证2026-05-17
点击查看完整报告 >

使用说明

核心用法

Deep Research Conversation 是百度千帆提供的深度研究智能体对话服务,区别于普通问答,采用多步推理执行的长流程任务模式。核心交互路径分为两类:

无文件场景(Path A):直接调用 DeepresearchConversation API,自动创建会话流式返回研究结果。

带文件场景(Path B):需先创建会话 → 上传文件(本地/URL)→ 提交解析任务 → 轮询解析状态 → 最终发起研究对话。支持 10 类格式:文本(doc/pdf/ppt/txt,最大 100MB)、表格(xlsx/xls,单 Sheet)、图片(png/jpg 等,≤10MB)、音频(wav/pcm,≤10MB)。

多轮对话机制:首次调用可选 conversation_id,后续必须携带;若返回 interrupt_id(需求澄清/大纲确认),下次调用必须传入;若返回 structured_outline,需展示给用户确认修改后再提交。

显著优点

1. 双版本策略:Lite 版(10 分钟内快速响应)与 Standard 版(深度研究,质量优先)灵活切换
2. 结构化输出:自动生成符合 JSON Schema 的研究报告大纲,支持层级嵌套(title/locale/description/sub_chapters)

3. 文件生态完整:从上传到解析的全链路 API 闭环,无需外部 OCR 或文档处理工具

4. SSE 流式体验:增量返回研究过程,降低长等待焦虑

潜在局限

  • 单 Sheet 限制:Excel 仅支持单工作表,复杂多表分析需预处理
  • 轮询开销:文件解析状态需客户端主动轮询,无 WebSocket 推送机制
  • 中断依赖:interrupt_id 与 structured_outline 的传递规则较复杂,易因遗漏导致会话断裂
  • 生态锁定:深度依赖百度千帆 API 体系,迁移成本较高

适合人群

学术研究者、行业分析师、咨询顾问、内容创作者等需要系统性深度调研并输出结构化报告的专业用户;企业内部知识库构建与竞品分析团队。

常规风险

  • 数据隐私:文件上传至百度云服务,敏感文档需评估合规性
  • API 密钥管理:依赖 BAIDU_API_KEY 环境变量,多租户场景需严格隔离
  • 解析失败兜底:大文件/复杂格式解析可能超时,需设计重试与降级策略
  • 版本漂移:Lite/Standard 的输出深度差异显著,切换时需用户预期管理

安全解读

核心用法

Deep Research Conversation 是百度千帆提供的深度研究型对话服务,区别于普通问答,采用多步骤推理与执行的长流程任务模式。Skill 支持两种使用路径:

  • 纯话题讨论:直接调用 DeepresearchConversation API,系统自动创建会话
  • 带文件分析:先创建会话 → 上传文件 → 提交解析 → 轮询状态 → 进行对话

API 采用 SSE 流式传输,数据增量返回。关键机制包括:

  • 首轮后需传递 conversation_id 保持上下文
  • 若返回 interrupt_id(需求澄清/大纲确认),后续调用必须携带
  • 若生成 structured_outline,需用户确认/修改后再传递

文件支持

| 类型 | 格式 | 限制 |
|------|------|------|
| 文本 | doc/docx/txt/pdf/ppt/pptx | txt≤10MB, pdf≤100MB/3000页 |
| 表格 | xlsx/xls | ≤100MB, 单Sheet |
| 图片 | png/jpg/jpeg/bmp | ≤10MB |
| 音频 | wav/pcm | ≤10MB |

版本选择

  • Standard(默认):深度研究,耗时较长
  • Lite:快速模式,10分钟内完成

---

显著优点

1. 官方云服务背书:百度千帆官方 API,TLS 1.2+ 加密,基础设施可靠性高
2. 多模态文件解析:支持 Office 文档、PDF、表格、图片、音频的联合分析

3. 结构化输出:自动生成可编辑的研究报告大纲,支持用户干预调整

4. 流式交互体验:SSE 实时推送,长任务过程中可见中间进展

5. OpenClaw 原生集成:API Key 自动从配置加载,无需手动管理凭证

---

潜在缺点与局限性

1. 第三方依赖风险:所有数据必须发送至百度服务器,敏感内容存在合规顾虑
2. 无本地推理能力:完全依赖云端,离线环境不可用,网络波动影响体验

3. 文件解析耗时:大文件需轮询等待解析完成,非即时响应

4. 版本权衡困境:Lite 版速度优先但深度不足;Standard 版质量高但等待时间长

5. 多轮交互复杂度高:开发者需正确处理 interrupt_idstructured_outline 的状态机

---

适合人群

| 场景 | 适用性 |
|------|--------|
| 学术研究/文献综述 | ⭐⭐⭐⭐⭐ 需上传多篇论文交叉分析 |
| 商业调研报告 | ⭐⭐⭐⭐⭐ 结构化大纲直接可用 |
| 合同/法律文本审查 | ⭐⭐⭐⭐ 敏感文件需评估数据出境风险 |
| 实时客服场景 | ⭐⭐ 非设计目标,延迟较高 |
| 完全离线环境 | ⭐ 必须联网 |

---

常规风险

  • 数据隐私:查询内容与上传文件均流经百度服务器,涉及个人信息或商业机密时需审慎
  • API 配额与成本:深度研究任务消耗较多 token,需关注用量配额
  • 会话状态丢失:多轮对话依赖 conversation_id 持久化,异常中断可能需重新开始
  • 第三方服务可用性:依赖百度千帆 SLA,故障时将完全不可用

---

安全认证摘要

经 CLS-Certify v2.1.0 全面扫描,获 S 级(92/100) 认证:

  • ✅ 无危险函数(eval/exec/system/subprocess)
  • ✅ 无动态代码下载、无硬编码密钥
  • ✅ 仅访问 qianfan.baidubce.com 官方 HTTPS 端点
  • ⚠️ 信息级:依赖第三方 API;读取环境变量/配置文件获取凭证(符合安全实践)

deepresearch 内容

scripts文件夹
手动下载zip · 3.7 kB
deepresearch_conversation.pytext/plain
请选择文件