deepresearch

核心用法

Deepresearch-conversation 是百度千帆平台提供的深度研究型对话技能，区别于常规问答，采用多轮流式交互模式完成长周期研究任务。核心工作流包括：

1. 会话管理：首次对话自动创建会话，或主动调用 ConversationCreate 获取 conversation_id
2. 文件处理：支持本地文件或 URL 上传（最多10个），涵盖文档、表格、图片、音频四类格式，单文件最大100MB；上传后需轮询 FileParseQuery 确认解析状态
3. 深度对话：通过 Python 脚本调用 SSE 流式接口，支持中断续传（需携带 interrupt_id）、大纲确认与修改、Lite/Standard 两档生成策略
4. 结构化输出：生成符合 JSON Schema 的研究报告大纲，可迭代优化直至用户满意

显著优点

• 深度研究能力：专为复杂课题设计，非简单问答，支持多步推理与执行
• 多模态文件支持：覆盖办公文档、数据表格、图像音频，满足多元化研究素材需求
• 流式交互体验：SSE 实时返回，支持中断恢复与大纲确认，人机协作紧密
• 弹性生成策略：Lite 模式10分钟内快速出稿，Standard 模式追求深度准确

潜在局限

• 流程复杂度高：文件场景需串行调用 4-5 个接口（创建→上传→提交解析→轮询查询→对话），开发成本较高
• 状态管理负担：需持久化 conversation_id、interrupt_id、structured_outline 等状态，中断续传逻辑繁琐
• 文件解析不确定性：解析任务需主动轮询，失败场景需额外容错处理
• 平台绑定：深度依赖百度千帆生态，迁移成本较高

适合人群

• 需要撰写行业研究报告、学术论文、商业分析的用户
• 企业知识库问答、竞品调研、政策解读等场景
• 具备一定开发能力、能接受多轮交互复杂度的团队

常规风险

• 数据合规：上传文件可能涉及敏感信息，需确认百度千帆的数据处理协议
• API 稳定性：流式接口与轮询机制对网络稳定性要求较高
• 成本控制：Standard 模式生成时间较长，需关注计费策略与超时配置
• 状态丢失风险：interrupt_id 等关键参数若未妥善保存，将导致对话无法续接

核心用法

deepresearch-conversation 是百度千帆（Qianfan）平台提供的 Deep Research 智能体对话封装工具，专为长流程、多步骤的深度研究任务设计。与传统即时问答不同，该工具支持多轮流式对话，通过反复验证与修正直至生成满意的研究报告。

典型工作流程：
1. 纯对话模式：直接调用 DeepresearchConversation 接口开启新话题
2. 带文件研究：先创建会话 → 上传文件 → 提交解析任务 → 轮询解析状态 → 启动深度对话
3. 断点续谈：携带 interrupt_id 和 conversation_id 恢复中断对话
4. 大纲确认：若生成结构化大纲，用户需确认或修改后继续

文件支持：文本（DOC/DOCX/TXT/PDF/PPT，最大100MB/3000页）、表格（XLSX/XLS，最大100MB）、图片（PNG/JPG等，10MB）、音频（WAV/PCM，10MB），单次最多10个文件。

---

显著优点

• 企业级可靠性：百度千帆官方服务，TLS 1.2+ 加密，T2 可信来源认证
• 深度研究能力：支持"澄清需求→生成大纲→确认大纲→输出报告"的完整研究闭环
• 灵活文件处理：多格式支持 + 自动解析任务队列管理
• 版本控制：Lite（10分钟内快速生成）/ Standard（深度质量优先）双模式
• SSE流式响应：实时反馈研究进度，用户体验流畅
• 零第三方依赖：仅使用 Python 标准库 + requests，供应链攻击面极小

---

潜在局限与风险

| 局限类型 | 具体说明 |

|---------|---------|

| **学习曲线陡峭** | 需理解 conversation_id、interrupt_id、structured_outline 等状态的流转逻辑 |

| **状态管理复杂** | 多轮对话需人工维护会话上下文，出错概率较高 |

| **文件解析延迟** | 大文件解析需轮询等待，无推送通知机制 |

| **API 调用成本** | Deep Research 为长流程任务，token 消耗显著高于普通问答 |

| **服务商锁定** | 深度绑定百度千帆生态，迁移成本较高 |

---

适合人群

• 学术研究者：需系统性文献综述、课题深度分析
• 企业分析师：行业报告、竞品研究、政策解读
• 内容创作者：长文专题策划、知识库构建
• 开发集成者：需在自有产品中嵌入 AI 研究能力的工程师

---

常规风险提示

1. API 密钥安全：apiKey 通过环境变量注入，避免硬编码或日志泄露
2. 文件内容敏感：上传文件解析后存储于百度云服务，需确认合规性
3. 长任务超时：Standard 模式下报告生成可能耗时较长，需设置合理超时
4. 大纲依赖：若未携带前序大纲继续对话，将触发错误中断