核心功能与用法
本技能封装了百度千帆深度研究（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 配置和底层模型，建议对关键场景人工复核大纲