千帆深度研究 API 一键调用

百度千帆官方 DeepResearch Agent API 封装，支持多轮对话、SSE 流解析与报告生成，适合企业级深度研究集成场景。

基本信息

• 技能名称?deepresearch
• 中文名称?千帆深度研究 API 一键调用
• 作者?ide-rea
• 分类?其他
• 版本?1.1.3
• 标签?baidu-qianfan, deep-research, agent-api, sse-streaming, automation, enterprise-integration, api-wrapper

使用方法

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

1. 官方原生能力 ：直接调用百度千帆企业级 DeepResearch Agent，非第三方封装，数据可靠性高
2. 完整流程覆盖 ：内置多轮对话状态机，自动处理 interrupt、大纲确认等复杂交互
3. 生产级健壮性 ：明确规避 HTTP/2、gzip 压缩、整体超时等常见 SSE 陷阱，提供 10 分钟空闲超时建议
4. 即开即用脚本 ：附带 scripts/deepresearch.py 完整实现，标准库+requests 即可运行，无需额外依赖
   潜在局限
5. 参数门槛 ：需用户自备千帆 API Key（bce-v3/ALTAK-...格式）和 Agent ID，对个人开发者有一定获取成本
6. 长连接维护 ：SSE 流可能持续数分钟至数十分钟，对客户端网络稳定性要求较高
7. 黑盒交互 ：需求澄清阶段的对话逻辑由 Agent 内部控制，用户侧仅能选择"跳过"或响应澄清问题，可控性有限
8. 输出格式固定 ：报告最终输出为 HTML 文件，如需其他格式需二次转换
   适合人群
   需将深度研究能力集成至自有产品的开发团队
   企业用户已有百度智能云/千帆平台账号，希望自动化调用 DeepResearch
   需要进行批量研究任务或压测的技术运维人员
   常规风险
   密钥泄露风险 ：API Key 需在环境变量或命令行中传递，共享环境时注意权限隔离
   成本不可控 ：长时运行的研究任务可能产生较高 Token 消耗，建议设置预算告警
   流解析失败 ：网络抖动可能导致 SSE 连接中断，需实现断点重连或失败重试机制
   输出质量波动 ：深度研究质量取决于 Agent 配置和底层模型，建议对关键场景人工复核大纲