deepresearch

核心功能与用法

本技能封装了百度千帆深度研究（DeepResearch）Agent 的完整 API 调用流程，实现从创建会话到获取 HTML 报告的全自动化。核心流程分为五步：创建会话 → 发起查询 → [可选]处理需求澄清 → 提取大纲数据 → 确认大纲生成报告。支持 SSE 流式响应实时解析，可识别需求澄清、大纲生成、中断等待、文件生成等关键阶段。

显著优点

1. 官方原生能力：直接调用百度千帆企业级 DeepResearch Agent，非第三方封装，数据可靠性高
2. 完整流程覆盖：内置多轮对话状态机，自动处理 interrupt、大纲确认等复杂交互
3. 生产级健壮性：明确规避 HTTP/2、gzip 压缩、整体超时等常见 SSE 陷阱，提供 10 分钟空闲超时建议
4. 即开即用脚本：附带 scripts/deepresearch.py 完整实现，标准库+requests 即可运行，无需额外依赖

潜在局限

1. 参数门槛：需用户自备千帆 API Key（bce-v3/ALTAK-...格式）和 Agent ID，对个人开发者有一定获取成本
2. 长连接维护：SSE 流可能持续数分钟至数十分钟，对客户端网络稳定性要求较高
3. 黑盒交互：需求澄清阶段的对话逻辑由 Agent 内部控制，用户侧仅能选择"跳过"或响应澄清问题，可控性有限
4. 输出格式固定：报告最终输出为 HTML 文件，如需其他格式需二次转换

适合人群

• 需将深度研究能力集成至自有产品的开发团队
• 企业用户已有百度智能云/千帆平台账号，希望自动化调用 DeepResearch
• 需要进行批量研究任务或压测的技术运维人员

常规风险

• 密钥泄露风险：API Key 需在环境变量或命令行中传递，共享环境时注意权限隔离
• 成本不可控：长时运行的研究任务可能产生较高 Token 消耗，建议设置预算告警
• 流解析失败：网络抖动可能导致 SSE 连接中断，需实现断点重连或失败重试机制
• 输出质量波动：深度研究质量取决于 Agent 配置和底层模型，建议对关键场景人工复核大纲

核心功能与用法

DeepResearch Skill 是百度千帆深度研究Agent的完整API调用封装，实现从创建会话到生成最终报告的全自动多轮对话流程。核心流程包含5个步骤：创建会话→发起查询→处理需求澄清→提取并确认大纲→生成报告。支持SSE流式响应解析，可自动识别大纲生成、中断等待、文件输出等关键阶段。

显著优点

1. 官方API直连：仅调用百度千帆官方域名(qianfan.baidubce.com)，TLS加密传输，无中间人风险
2. 安全评分S级：静态分析98分，无危险函数、无eval/exec/system调用、无硬编码密钥
3. 依赖极简：仅需标准库+requests，无供应链攻击风险
4. 流程完备：完整覆盖DeepResearch Agent的5步对话状态机，含需求澄清、大纲确认等分支处理
5. 生产就绪：提供可直接运行的Python脚本，支持环境变量和命令行两种参数传递方式

潜在局限

1. 输入验证待增强：当前仅检查参数存在性，未对API Key格式(bce-v3/ALTAK-前缀)、UUID格式进行校验
2. 响应Schema验证缺失：关键字段(conversation_id/interrupt_id)解析失败时缺乏优雅降级
3. 重试机制简单：网络异常场景未实现指数退避，生产高并发场景需自行增强
4. SSE长连接管理：推荐10分钟空闲超时，但未内置连接保活机制

适合人群

• 需要集成深度研究能力的企业开发者
• 构建自动化研报生成系统的金融/咨询团队
• 对百度千帆生态有依赖的AI应用开发者
• 追求S级安全评分的合规敏感型组织

常规风险提示

• API密钥管理：需妥善保管BAIDU_API_KEY，建议通过KMS或密钥管理服务注入
• 成本管控：DeepResearch为多轮Agent调用，单条查询可能消耗较高token，需监控用量
• 输出内容审核：生成报告由大模型产生，关键业务场景建议增加人工复核环节
• SSE流稳定性：网络波动可能导致长连接中断，关键任务建议实现断点续传机制