技能介绍

要解决什么问题

Agent 或对话流程里经常需要联网检索：用户问的是当下网页上的事实、新闻或文档，纯本地模型答不了。豆包侧提供 WebSearch 能力，但接口是异步任务——先提交再查状态，自己写轮询和超时很容易漏边界。

本技能把「提交 → 轮询 → 出结果」封装成固定脚本流程，让调用方只关心搜索关键词和最终 JSON，而不是反复对接 HTTP 细节。

如何工作

提取意图：从用户自然语言里抽出 inquiry_text，作为搜索查询。
异步提交：向红狐网关 POST /story/api/doubaoSearch/submit，请求体含 inquiry_text 与来源标识 source（如 豆包websearch-SkillHub_P），响应里拿到 taskId。
自动轮询：每 5 秒调用 POST /story/api/doubaoSearch/result，直到状态为 completed；轮询期间通过 stderr 输出等待进度，最长约 5 分钟。
结构化输出：完成后在 stdout 输出完整 JSON；展示时通常读 data.content（豆包回答正文）和 data.result（引用来源）。

鉴权依赖环境变量 REDFOX_API_KEY，需在红狐 hub 申请。

边界与注意点

| 情况 | 含义 |
|------|------|
| 未配置 API Key | 应引导用户去红狐 hub 配置 |
| 提交失败 | 记录错误，可重试 |
| 轮询超时 | 5 分钟内未 completed 即超时 |
| status=failed | 需输出任务失败详情，勿当作成功结果解析 |

本技能不负责替你做关键词质量优化或二次摘要；它保证的是豆包联网搜索链路的可靠调用与可解析输出。