Kimi 联网搜索

要解决什么问题

Agent 或对话助手在回答「今天发生了什么」「某产品最新版本」这类问题时，往往只能依赖训练数据 cutoff，无法直接访问网页。若你已经在用 Kimi 的联网能力，但希望把提交任务、等结果、解析 JSON封装成可重复调用的技能流程，就需要一条明确的调用链，而不是每次手写 HTTP 与轮询逻辑。

技能如何工作

本技能通过红狐 Hub 的 Kimi WebSearch 接口，把用户自然语言里的搜索意图转成 inquiry_text，再交给脚本完成后续步骤：

1. 异步提交：POST /story/api/kimi/submit，请求体含 inquiry_text 与固定 source 字段，成功则得到 taskId，调用方不必阻塞等待。
2. 自动轮询：每 5 秒 POST /story/api/kimi/result 查状态，最长约 5 分钟；等待期间经 stderr 输出进度，便于在终端或日志里看到「还在搜」。
3. 结果交付：当状态为 completed 时，完整 JSON 写到 stdout；Agent 侧通常从 data.content 取 Kimi 回答，从 data.result 取引用来源，再整理成可读回复。

鉴权依赖环境变量 REDFOX_API_KEY（在红狐 Hub 申请）。脚本对 Key 缺失、提交失败、轮询超时、任务 failed 四类情况都有对应提示。

适用边界与注意点

• 适合需要联网实时信息、且希望结果以结构化 JSON 交给下游解析的场景；不适合离线知识库检索或纯本地文档问答。
• 轮询有上限，长时间无 completed 会超时，需用户稍后重试或缩小问题范围。
• 引用与正文质量取决于 Kimi 搜索与模型本身，技能只负责可靠地「提交—等待—输出」，不保证事实正确性，重要结论仍应核对来源链接。