跳转到内容
For the complete documentation index, see llms.txt. This page is also available as Markdown.

网页搜索

为代理提供原生网页搜索、有依据的答案和页面阅读。TinyHumans 已包含 Exa 和 Gemini;使用你自己的密钥还可接入更多提供商。

该代理可以搜索实时网页,获取带有引用的有据可查的答案,并自行阅读页面。开箱即用时,它运行在 TinyHumans 自带的提供商上: Exa 用于搜索和页面内容,以及 Gemini 并结合 Google Search grounding 来提供答案。两者都不需要搜索 API 密钥。你可以使用自己的密钥添加更多提供商,而且可以同时启用多个。

适用于什么

  • 研究:“X 的最新进展是什么”。

  • 引用搜集:“帮我找 Y 的三个来源”。

  • 回答前的事实核查:如果代理没有把握,它会进行一次快速搜索。

  • 阅读代理或你已经找到的页面。

角色:每项任务一个工具

无论当前启用了哪些提供商,代理都会针对每个能力角色看到一个工具:

角色
代理工具
返回内容

搜索

web_search_tool

排序后的结果:标题、URL、发布日期和摘要。

答案

web_answer_tool

基于网页来源并带有引用的书面答案。使用 depth: "deep" 时,它会改为运行 Gemini Deep Research,这需要你自己的 Gemini 密钥。

内容

web_contents_tool

所给 URL 的提取文本。

每个角色都有一个有序的提供商列表。第一个可用的提供商会处理该调用。如果失败,就尝试下一个,以此类推。结果会说明由哪个提供商作答,以及哪些被跳过,例如 针对:……的答案(通过 Gemini,继 Exa 之后),聊天卡片也会在答案及其来源下方显示相同的“通过 Gemini,继 Exa 之后”说明。没有可用提供商的角色根本没有工具,因此代理永远不会看到一个无法运行的工具。

默认顺序为:

角色
默认提供商,按顺序

搜索

Exa, Brave, Tavily, Parallel, Querit, Seltz, SearXNG, TinyFish

答案

Gemini, Exa, Parallel

内容

Exa, Tavily, Parallel, TinyFish

已关闭的提供商会被跳过,因此使用默认设置时,只有 Exa 和 Gemini 会提供服务。

提供商与路由

每个提供商都有一条路由:

  • 随 TinyHumans 附带(受管理):调用会通过 TinyHumans 后端,并记入你的 TinyHumans 余额。它需要已登录会话。你的设备上不会存储任何密钥。

  • 自有密钥(直接):调用会使用你的 API 密钥直接从你的设备发往提供商。

Provider
路由
角色
说明

Exa

随附,自有密钥

搜索、答案、内容

默认开启(随附)。

Gemini

随附,自有密钥

答案

默认开启(随附)。即使在随附路由上,你自己的密钥也能解锁 Deep Research。

TinyFish

自有密钥

搜索、内容

默认关闭。没有随附的 TinyFish 路由;托管后端不会代理它。

Parallel

自有密钥

搜索、答案、内容

默认关闭。没有随附的 Parallel 路由;请自行提供 Parallel 密钥。深度答案不会使用 Parallel。

Brave

自有密钥

搜索

默认关闭。

Tavily

自有密钥

搜索、内容

默认关闭。

Querit

自有密钥

搜索

默认关闭。

Seltz

自有密钥

搜索

默认关闭。

SearXNG

自有实例

搜索

默认关闭。使用你自己的 SearXNG 实例 URL,而不是密钥。

当提供商处于开启状态、其路由可用(你已登录可使用随附路由,或已保存自有密钥路由的密钥),且搜索整体开启时,该提供商即为可用。设置页面会在每个提供商旁显示状态徽标:就绪、需要密钥、需要登录或关闭。

如果你不登录就使用 OpenHuman(本地会话),则随附路由不可用。请启用一个使用你自己密钥的提供商,以保持网页搜索可用。

当你的 TinyHumans 余额耗尽时,随附提供商会停止响应,聊天中失败的工具调用会提示这一点。请充值,或将提供商切换为你自己的密钥。

设置

一切都在 连接 → 搜索:

  • 网页搜索:一个开关即可启用或禁用所有搜索工具。

  • 提供商:每个提供商一张卡片,包含开关、路由选择(适用于支持两种路由的提供商)、自有密钥路由的 API 密钥字段,以及 SearXNG 的实例 URL。Gemini 始终会显示其密钥字段,因为该密钥用于启用 Deep Research。

  • 角色:Search、Answer 和 Contents 的提供商顺序,以及当前由哪个提供商负责各角色。你可以上移或下移提供商、移除回退项、重新添加提供商,或将某个角色重置为默认顺序。

  • 允许的网站:助手可以通过网页抓取和浏览器工具打开并阅读哪些网站。此列表不限制网页搜索。

  • 高级 → 为每个提供商公开其自己的工具**:为代理提供每个可用提供商各自的工具(例如 Brave 新闻或图片搜索,或 Exa 的 find-similar),而不是每个角色一个工具。这会占用更多上下文窗口。

密钥存储在 config.toml中。启用机密加密时,OpenHuman 会将它们存储为密文。操作系统钥匙串保护的是主加密密钥,而不是提供商密钥本身。

配置文件与环境变量

相同的设置也位于 [search] 在 config.toml:

不要提交明文 API 密钥。直接输入到 config.toml 中的密钥会保持明文,直到 OpenHuman 在下次启用机密加密保存配置时才会加密。

环境变量覆盖:

变量
效果

OPENHUMAN_SEARCH_ENABLED

开启或关闭搜索。

OPENHUMAN_SEARCH_PROVIDERS

替换提供商集合,例如 exa:managed,gemini,brave.

OPENHUMAN_SEARCH_ROUTES

更改路由,例如 exa=direct,gemini=managed.

OPENHUMAN_SEARCH_ROLES

设置角色顺序,例如 search=brave|exa;answer=gemini.

OPENHUMAN_EXA_API_KEY, OPENHUMAN_GEMINI_API_KEY, OPENHUMAN_BRAVE_API_KEY, OPENHUMAN_TAVILY_API_KEY, OPENHUMAN_QUERIT_API_KEY, OPENHUMAN_PARALLEL_API_KEY, OPENHUMAN_SELTZ_API_KEY

提供商密钥。不带前缀的名称(EXA_API_KEY, GEMINI_API_KEY,……)也同样有效。

将环境提供的密钥视为机密。

通过 RPC 和 MCP 使用 SearXNG

除了提供 Search 角色外,一个已启用的 SearXNG 实例还会作为 openhuman.tools_searxng_search (searxng_search 暴露给 MCP 客户端(在 MCP 目录中),这会将调用固定到 SearXNG。其 [searxng] 部分在 config.toml 以及其运行时所采用的 OPENHUMAN_SEARXNG_* 变量(ENABLED, BASE_URL, MAX_RESULTS, DEFAULT_LANGUAGE, TIMEOUT_SECONDS)用于配置该实例。

Parallel 仅支持自有密钥

Parallel 仅能与你自己的 Parallel 密钥一起使用。升级时,在此更改之前保存的 Parallel 密钥会被沿用;如果它曾是你选定的引擎,Parallel 在搜索中仍保持优先。若某个设置曾在没有密钥的情况下使用随附的 Parallel 路由,则会改用随附的 Exa 和 Gemini 提供商。 OPENHUMAN_PARALLEL_ROUTE 会被忽略。

它与通用 HTTP 的区别

普通的 http_request 工具可以抓取一个 URL,但不能找到 URL。网页搜索会找到正确的 URL,而 Contents 角色(或 网页抓取器)会读取它们。

另请参阅

最后更新于