网页搜索与 URL 读取

让 Google Search 提供来源，读取具体网页并了解目标校验和审批。

This page has not been translated into English yet. The original Chinese version is shown below.

需要寻找当前资料时使用 google_web_search，已有具体网页地址时使用 web_fetch。两者返回经过处理的结果，不代表已取得网页每一行原文。

搜索

google_web_search 的参数为必需的 query。Gemini API 处理 Google Search 结果并给出综合说明，附 source URI 与标题。检查引用是否直接支持所需事实，尤其是版本、配置或实时状态。

web_fetch 的必需参数 prompt 同时包含 URL 和处理要求，最多 20 个 http:// 或 https:// 地址。可以要求摘要、提取特定字段或比较不同来源。

先用 Gemini API 的 urlContext；失败后可尝试从本地机器直接取得原始内容。返回仍为带来源的综合处理结果，不是保证逐字原文。

工具校验 URL 和解析出的 IP，限制私有、保留、loopback 和内部网络地址，并将连接固定到已解析目标 IP；本地回退也应用校验。不能把 web_fetch 当作不受限的内网代理。

执行会显示转换后 URL 的确认，在 Plan Mode 中仍可用，但始终要求明确的用户确认。网页访问批准与后续修改网页、发送消息或调用写工具是不同动作。

先搜索目标库与版本，定位官方文档；再给出明确 URL 和需要核对的 API/迁移问题，最后将结论用于代码修改并执行相应验证。比较版本时，可同时提供两个版本的文档地址，要求列出行为差异。

教程用“搜索—读取—实现”串联工具。带有搜索来源仍需要核对来源与目标版本，不能将 grounding 描述为保证不会产生错误结论。