使用 HTTP Request 工具为 n8n AI Agent 实现网页搜索

为什么用 HTTP Request 节点而不是自定义节点？

因为 API 只需要一个带 header 和四个查询参数的 GET 请求。n8n 的文档说明，HTTP Request 节点既能作为普通节点运行，也能作为工具挂到 AI agent 上，而且有些选项只在工具形式下才存在。

我们的东西不需要安装或更新，API 密钥存放在 n8n 的凭证库中而不是工作流里。给 n8n 单独配一个密钥。为每个 agent、应用或团队成员各建一个 API 密钥，并可在控制面板中吊销其中任意一个，而不影响其他密钥。

模型如何写出搜索查询？

通过 n8n 的 $fromAI() 函数写在 q 字段的值里。文档给出的形式是 $fromAI(key, description, type, defaultValue)：使用键 query，一个描述比如 "What to search for on the web"，以及类型 string。n8n 指出 $fromAI() 只在连接到 AI Agent 节点的工具中有效。

也用平实的语言描述这个工具本身，例如 "Searches the web and returns sources with their page text; cite the URLs"。agent 根据这段文字决定何时搜索。

为什么要开启优化响应？

因为工具返回的所有内容都会进入模型的上下文。优化响应是一个仅用于工具的选项，用于减少传给模型的内容。选择 JSON 类型后，把包含数据的字段设为 results，然后只包含 title、url 和 content。

这样 agent 只会看到一份简短的来源列表及其文本，别无其他。在我们这边用 max_chars 限制长度，它会在每个页面离开 API 之前进行裁剪。

可以不借助 agent 定时运行搜索吗？

可以。把 HTTP Request 节点作为普通节点放在 Schedule Trigger 后面，使用固定查询。加上 topic=news 和 time_range=day 来收集某主题当天的文章，然后把标题和 URL 发送到聊天、表格或邮件。

每天一次定时新闻搜索每月大约消耗 30 积分，所以 5,000 次搜索（US$9.25）可以长期覆盖很多主题。查询积分永不过期：这个月没用完的，明年还在。

页面被拒绝时，工作流会收到什么？

搜索仍然成功。被拒绝的结果保留标题和 URL，没有 content，其 content_status 说明原因，例如 blocked_by_robots。我们的读取器遵守 robots.txt：它会以 LLMWebSearch 表明身份，遵守网站为它或为所有机器人写下的规则，并排除任何它无权读取的页面内容。

HTTP 错误则不同：密钥错误返回 401，余额为空返回 402，调用过多返回 429。在 agent 中，让工具把错误返回，以便模型能够解释它。在定时工作流中，把错误路由到记录它们的分支。错误页面 列出了所有错误码。

在构建工作流之前如何测试调用？

用 curl 从 curl 示例 运行同样的请求。如果在终端中能正常工作而在 n8n 中失败，原因就在节点设置里。常见嫌疑是凭证值缺少 Bearer 前缀，或 q 字段为空。