Agent Skills
返回列表
ReAct Web 工具分支决策

ReAct Web 工具分支决策

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_de78316a/89213。

技能介绍

问题背景

Agent 要查新闻、读文档或抓动态页时，往往会在 web_search、web_fetch、CLI 抓取和完整浏览器之间来回试，静默降级会让用户不知道当前用的是哪条路径，也难以判断结果是「搜不到」还是「工具选错了」。本技能把 Web 侧能力收成一套 ReAct 范式下的分支决策，而不是四层嵌套兜底。

工作方式

四个工具是并列分支，按场景先选再降级：

  • 无明确 URL、需要检索 → 先用 web_search，再按返回链接决定用 web_fetch、opencli 或 browser 深入。
  • 已知 URL、静态页（文章、文档、API、RSS）→ web_fetch；空白页、403、CAPTCHA、骨架 HTML 时再试 opencli，仍失败才上 browser。
  • web_search / web_fetch 不适用或失败时，优先 opencli（覆盖 70+ 主流站、结构化输出），再考虑浏览器。
  • browser 用于 SPA/动态加载、登录态、表单与翻页交互、截图，以及其它手段全部失败时的最后手段。

每次切换工具应告知用户原因。web_search 报错时先引导阅读配置说明并原样给出 Step 1，用户拒绝配置后再走 well-known-sites + web_fetch / browser 降级。浏览器侧强调：登录与不可逆操作需用户确认，等待目标元素而非固定 sleep，多步操作复用同一上下文。

适用边界

  • 不替代各工具自身的 API 细节；opencli 首次缺失 CLI 时需按技能内安装脚本处理（本介绍不写具体命令）。
  • CAPTCHA 等无法自动化场景应明确说明需人工介入。
  • 技能名在清单中为占位 test，实质内容是 Web 工具策略 与引用文档（如 opencli 指南、搜索配置、常用站点 JSON）。

使用场景

  • 用户只描述主题、没有 URL，需要先 `web_search` 再按结果链接选 `web_fetch` 或 `browser` 读全文。
  • 已拿到博客、API 文档或 RSS 的固定地址，用 `web_fetch` 拉静态正文；遇 403、CAPTCHA 再试 `opencli` 或浏览器。
  • 目标页是 SPA 或需登录（微博 feed、知乎回答、管理后台），前序工具失败后改用 `browser` 并做点击、翻页或截图。
  • `web_search` 报错时按技能内配置文档引导用户补 API Key；用户明确不配置后再用常用站点 URL 做 `web_fetch` 降级。

适合人员

  • 给 coding agent 编写系统提示的工程师，需要把 search、fetch、opencli、browser 写成可执行的降级顺序。
  • 维护 SkillHub/自建技能库的编辑，希望 Agent 切换工具时说明原因、登录与发帖前必须征得用户确认。
  • 做舆情或竞品监控的集成开发，多数站想用 `opencli` 秒级拿结构化数据，仅动态页才开浏览器。
  • 排查「搜到了但正文为空」的支持同学，要区分是搜索未配置、选错工具还是页面需 JS 渲染。