第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,
}