百度千帆官方 DeepResearch Agent API 封装，支持多轮对话、SSE 流解析与报告生成，适合企业级深度研究集成场景。
说明：
## 核心功能与用法
本技能封装了百度千帆深度研究（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 配置和底层模型，建议对关键场景人工复核大纲
