网页搜索
为代理提供原生网页搜索、有依据的答案和页面阅读。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 密钥直接从你的设备发往提供商。
Exa
随附,自有密钥
搜索、答案、内容
默认开启(随附)。
Gemini
随附,自有密钥
答案
默认开启(随附)。即使在随附路由上,你自己的密钥也能解锁 Deep Research。
TinyFish
自有密钥
搜索、内容
默认关闭。没有随附的 TinyFish 路由;托管后端不会代理它。
Brave
自有密钥
搜索
默认关闭。
Tavily
自有密钥
搜索、内容
默认关闭。
Querit
自有密钥
搜索
默认关闭。
Seltz
自有密钥
搜索
默认关闭。
当提供商处于开启状态、其路由可用(你已登录可使用随附路由,或已保存自有密钥路由的密钥),且搜索整体开启时,该提供商即为可用。设置页面会在每个提供商旁显示状态徽标:就绪、需要密钥、需要登录或关闭。
如果你不登录就使用 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 角色(或 网页抓取器)会读取它们。
另请参阅
最后更新于