跳到正文
Ankole

Web 工具

面向 AI Agent:本页的 Markdown 版本位于 https://ankole.agentbull.com/zh-Hans-CN/docs/web-tools/index.md,全站文档索引位于 https://ankole.agentbull.com/zh-Hans-CN/llms.txt。

Agent 可先通过 web_search 检索公开网页,再通过 web_fetch 提取目标页面的正文内容。启用 Provider-hosted 网页搜索时,若当前模型支持原生搜索,Ankole 会使用该模型提供商的搜索能力。若要使用独立搜索提供商,应关闭 Provider-hosted web_search,再绑定 web_search 档案。web_fetch 优先调用已绑定的提供商,未配置时可回退至 Worker 内置的网页渲染提取器。

先选择正确的工具

能力 适用场景 可用执行环境
web_search 按关键词、发布时间或站点范围检索公开网页 主对话 Agent 与后台 Agent 任务
web_fetch 将一个或多个已知的公开网址提取为干净正文 主对话 Agent 与后台 Agent 任务
浏览器自动化 登录账号、点击按钮、填写表单、翻页、截屏及读取交互后才呈现的动态页面 仅限后台 Agent 任务

浏览器自动化能力由 browser Skill 提供,并固定声明为 ankole-runtime: background_job;因此它不会出现在 web_search 或 web_fetch 的提供商下拉列表中,也无法在主对话 Agent 的日常前台回合里直接调用。

一旦任务确需真实浏览器交互,主对话 Agent 会创建或复用后台 Agent 任务来执行——后台任务不会阻塞当前聊天窗口,并会按需将澄清问题、阶段进展或最终结论发回原会话。

配置 Web 工具

添加 Provider

  1. 打开 Console → 模型提供商 页面。
  2. 选择支持 web_search、web_fetch 或同时支持两者的提供商类型。
  3. 填入 API Key 及该提供商要求的其他必填参数。
  4. 保存配置,并确认该提供商处于启用状态。

同一种提供商类型下可创建多个独立实例——例如,你可以针对不同目标国家或业务线分别建立两个 Bright Data SERP 实例,再按需分配给不同的 Agent。

将独立提供商分配给 Agent

使用独立搜索档案前,应在目标 Agent 或其继承的默认设置中关闭 Provider-hosted web_search。绑定或清空档案本身不会改变这个开关。

  1. 打开 Console → 智能体 页面,点开目标 Agent。
  2. 在模型档案区域找到 web_search,选择一个支持网页搜索的提供商实例。
  3. 找到 web_fetch,选择一个支持网页正文提取的提供商实例。
  4. 分别保存后,开启一轮新对话使配置生效。

这两项档案只需绑定提供商实例,无需指定模型名称或上下文窗口长度。由于每种提供商类型已预先声明自身支持的能力,下拉列表会自动过滤,仅展示与当前槽位匹配的实例。

若下拉列表中暂无可选项,请先按上一节添加对应的提供商实例;首次配置指引见 快速开始。

当前内置 Provider

除以下随系统内置的提供商外,站点管理员也可通过 Control Plane Plugin 扩展接入更多提供商类型。

web_search Provider

提供商 同时支持 web_fetch 核心特性差异 适用场景
Parallel 是 单一提供商同时覆盖搜索与正文提取;支持指定检索意图、多组并发查询、运行模式及总字符数预算 希望用同一套凭据包揽搜索与精读,或处理深度调研类检索
Bright Data SERP 否 调用 SERP API 检索结果;必填 Zone 名称,支持精细指定国家/地区、界面语言与 Google 区域域名 需要严格控制搜索地域、语种或获取本地化搜索结果
Jina Search 否 支持指定国家/地区、地理位置、语言、分页页码、缓存开关及底层搜索引擎 需要直接网页搜索,并精细控制地域、翻页或缓存行为
AgentBull Cloud 是 一站式聚合网页搜索、正文提取与多种模型能力(llm、embedding、rerank、image_generate);支持限定站点范围、时间窗口及跳过缓存 希望凭一把聚合 API Key 同时搞定联网工具与模型调用,或需按域名与时间精确过滤
Cloudflare 是 通过账号下的 AI Gateway 调用 Cloudflare Web Search;可选择搜索引擎(ceramic、exa 或 linkup),单次最多返回 10 条结果 已经通过 Cloudflare AI Gateway 统一结算 AI 用量

若选用 Parallel、AgentBull Cloud 或 Cloudflare,只需添加一次提供商实例,即可同时绑定给 web_search 与 web_fetch 两个槽位。

注意,Jina Search 与 Jina Reader 在系统中属于两个独立的提供商类型——即便共用同一把 Jina API Key,也需分别添加两个实例,再各自绑定至对应槽位。

web_fetch Provider

提供商 同时支持 web_search 核心特性差异 适用场景
Parallel 是 直接复用 Parallel Search 的同一实例与凭据提取网页正文 已接入 Parallel 搜索,希望精简维护一套配置
AgentBull Cloud 是 直接复用同一 AgentBull Cloud 实例与 API Key 提取公开网页正文 已通过 AgentBull Cloud 调用模型或搜索,希望共用同一套凭据
Jina Reader 否 将公开网页转换为结构化 Markdown;支持保留超链接、CSS 目标选择器、等待元素选择器、缓存控制、渲染引擎切换及输出 Token 上限 提取长文正文,或仅截取页面中的特定 DOM 区域
Cloudflare 是 通过 Cloudflare Browser Run 将公开网页提取为 Markdown;默认选用轻量级 kitesurf 引擎,也支持按需切换 chromium 并配置等待选择器、导航参数与请求拦截规则 已接入 Cloudflare 模型或搜索能力,希望在边缘节点快速完成 Markdown 提取

web_fetch 仅面向无需鉴权的公开 HTTPS 网页——它既不支持携带登录态访问受限页面,也不是用来下载 PDF、图片、压缩包或音视频文件的下载工具。

Worker 内置的渲染回退机制属于底层兜底能力而非独立提供商,因此不会出现在 Console 的提供商列表中,仅用于在未配置专用提供商时提取渲染后的页面正文。

该内置回退同样无法执行点击、输入、复用登录 Cookie 或页面截屏,也不会赋予主对话 Agent 浏览器自动化能力。

虽然部分提供商支持通过 CSS 选择器与等待条件读取异步延迟加载的正文,但这些参数代替不了真实的页面操作;凡涉及账号登录、点击交互或表单填写的任务,仍须交由后台 Agent 任务中的浏览器自动化完成。

让 Agent 使用 Web 工具

日常提问时无需输入特殊指令,直接用自然语言交代目标即可。例如:

查找本周发布的三条相关动态,阅读原文后提炼核心差异,并附上出处链接。

收到请求后,Agent 会先搜索候选网页,再自主挑选高价值链接抓取精读;如果你手头已有明确网址,也可直接发给 Agent 让它提取并总结。

遇到以下情形时,则应在指令中明确要求动用浏览器:

  • 目标页面需要登录账号才能查看;
  • 必须经过点击按钮、输入筛选条件或点击翻页后才会加载目标数据;
  • 需要截取网页实际渲染画面,或核对视觉排版效果;
  • 页面内容依赖复杂的前端多步交互才会呈现。

涉及浏览器的任务会自动转入后台 Agent 任务运行;而常规资讯检索、公开文章精读与多信源交叉汇总完全无需启动重型浏览器,直接使用 web_search 与 web_fetch 响应更快、开销更低。

无法搜索或读取网页

搜索或读取失败

请按以下顺序逐项排查:

  1. 检查搜索执行路径:Provider-hosted 搜索要求当前模型支持原生搜索;关闭该开关时,web_search 必须绑定已启用的搜索提供商;
  2. 若 web_fetch 留空未绑定提供商,当前 Agent 的 Worker 是否正常运行并具备内置渲染回退能力;
  3. 所绑定的提供商实例是否确实声明支持该项能力;
  4. 该提供商是否处于启用状态,API Key 与各项必填参数是否真实有效;
  5. 保存新配置后,是否已重新发起一轮新对话;
  6. 目标链接是否为免登录即可公开访问的 HTTPS 网页。

浏览器没有运行

请确认已为该 Agent 启用 browser Skill,且权限允许其创建后台 Agent 任务;切勿尝试在 web_search 或 web_fetch 档案中寻找或绑定浏览器。

如果任务已经在后台 Agent 任务中运行但仍无法操控网页,请进一步检查对应 Worker 是否就绪,并查阅任务日志中是否报出了浏览器会话异常或网络访问受阻提示。