104、【Agent】【OpenCode】webfetch 工具提示词
【声明】本博客所有内容均为个人业余时间创作，所述技术案例均来自公开开源项目（如Github，Apache基金会），不涉及任何企业机密或未公开技术，如有侵权请联系删除
背景
上篇 blog
【Agent】【OpenCode】task 工具提示词（参数内容）
接着分析了 Task 工具的另一个例子greeting-responder（可以进行人设隔离），然后分析了 Task 工具的参数内容：description（任务简述，必选项，为了人机交互体验设计的，是给人类用户看的 UI 标签），prompt（详细指令，必选项，给 AI 看的完整剧本，内容高度自包含），subagent_type（专家类型，必选项，指定要使用的特定类型的专业智能体），task_id（会话锚点，可选项，可以让任务在之前同一个子智能体会话中继续），command（触发源，可选项，触发此任务的原始命令，用来审计与调试），下面继续分析
OpenCode
下面看下一个工具 WebFetch
其提示词路径在opencode/packages/opencode/src/tool/webfetch.txt
这里的WebFetch 工具不是一个简单的网页抓取器，而是在 AI 编程工具生态中一个非常讲究内容净化与标准化的接口，下面从几个角度进行分析
- 网页内容净化器：工具默认将网页内容转换为 Markdown 格式，网页原始的 HTML 一般充满着大量的
<div>，<span>，CSS 样式和各种 JavaScript 脚本，这些内容对于浏览器渲染页面非常重要，但对 AI 来说全是噪声干扰，而 Markdown 格式则剥离了这些干扰，只保留标题，段落，列表和代码块等语义结构，可以大幅减少 AI 需要处理的 Token 数量，并提升 AI 对网页核心信息的理解准确率，相当于在 AI 读取网页前，先安排了一个排版编辑把 HTML 清洗成干净的纯文本 - 通用兜底方案：Usage notes 这里提到，如果系统中存在更专业的工具，比如专门用来搜索全网的 GeneralSearch，或者专门用来读取特定文档库的插件，如果这些专业的工具能解决问题，就优先用它们，只有当那些专业工具都不适用，或者明确知道一个 URL 需要读取时，才轮到 WebFetch 工具出场，WebFetch 只是一个通用的兜底工具，AI 应该根据任务的最优解来动态选择工具，而不是盲目迷信单一工具，WebFetch 的存在，是为了保证 AI 在面对任何未知 URL 时，都有一个保底的手段去获取信息
安全与容错机制：这里提到了几个关键的细节
- HTTP 自动升级为 HTTPS：这是个强制性的安全策略，防止 AI 在抓取信息时因为访问不安全的 HTTP 协议而遭到中间人攻击，或者被目标网站直接拦截
- URL 必须完整有效：要求传入的必须是带有
https://的完整链接，避免 AI 因为传入相对路径（比如/about）而导致抓取失败 - 只读属性（Read Only）：明确声明该工具不会修改任何文件
- 应对海量信息自动总结：大模型的上下文窗口虽然越来越大，但依然是昂贵有限的，如果 WebFetch 抓回来一本几十万字的在线电子书，直接塞给 AI 会导致上下文爆炸，所以这里做了防溢出提示，当检测到内容过长时，应该自动进行截断，或总结摘要处理
有了这个工具，OpenCode 就可以直接阅读互联网上任意公开的 URL，获取最新信息，OK，下面看下参数内容
url（目标地址，必填项）：信息获取的唯一坐标，必须是完整的合法路径format（输出格式，必填项）：默认为 Markdown 格式，还可以选 Text（纯文本），HTML（原始源码），通过将格式设置为必填，强制 AI 根据不同任务性质选择合适的数据格式，养成按需索取的习惯timeout（超时控制，可选项）：防止任务无限挂起，防止网络问题或目标服务器无响应导致工作流卡死，默认 120s（两分钟）
OK，本篇先，到这里，如有疑问，欢迎评论区留言讨论，祝各位功力大涨，技术更上一层楼！！！更多内容见下篇 blog