进阶 opencode.ai 2026-11-11 16:13:22 · 16 阅读

第14章 OpenCode 网络搜索功能详解

网络搜索

让 OpenCode 获取当前信息,它可以搜索网络、阅读结果,并在响应中包含来源链接。

查找最新版本的 Bun 并总结变更内容。

首次搜索时,系统会提示你授权网络搜索并选择一个提供商。OpenCode 会记住你的选择,以便在后续会话中使用。

OpenCode 包含五个搜索提供商:

提供商 ID 环境变量
Exa exa EXA_API_KEY
Firecrawl firecrawl FIRECRAWL_API_KEY
Parallel parallel PARALLEL_API_KEY
Tavily tavily TAVILY_API_KEY
TinyFish tinyfish TINYFISH_API_KEY(可选)

在 TUI 中通过 /connect 连接账户,或在启动 OpenCode 前设置提供商的环境变量。

Terminal
$ TAVILY_API_KEY=your-key opencode

在 opencode.jsonc 中设置提供商,可跳过选择提示。

opencode.jsonc
{ "$schema": "https://opencode.ai/config.json", "websearch": { "provider": "tavily", }, }

使用 "random" 可自动选择可用的提供商。每个会话将持续使用其选定的提供商,直到该提供商达到速率限制。

opencode.jsonc
{ "$schema": "https://opencode.ai/config.json", "websearch": { "provider": "random", }, }

当提供商返回 HTTP 429 时,随机选择机制会使用其他可用提供商重试搜索。达到速率限制的提供商将等待其 Retry-After 期间;若响应中未包含有效时间,则等待 60 秒。

Exa 返回 HTTP 429 → Exa 进入冷却期 → OpenCode 使用其他提供商重试

如果所有提供商都处于冷却期,搜索将立即失败。移动会话或重启其服务器会清除记忆中的提供商设置;同一工作区内的会话共享冷却状态。

网络搜索使用 websearch 权限动作,并以搜索查询作为资源。对于未明确允许的搜索,系统会提前询问。

opencode.jsonc
{ "$schema": "https://opencode.ai/config.json", "permissions": [ { "action": "websearch", "resource": "*", "effect": "ask", }, ], }

关于规则顺序和匹配逻辑,请参阅“权限”部分。

将 websearch 设置为 false,可从模型请求中移除网络搜索工具。

opencode.jsonc
{ "$schema": "https://opencode.ai/config.json", "websearch": false, }

评论 (0)