From ca3e95f89c6adc9a76bfb4306df5503debb2ec88 Mon Sep 17 00:00:00 2001 From: Wenjie Zhang Date: Sat, 11 Oct 2025 12:49:05 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=20Tavily=20=E7=BD=91?= =?UTF-8?q?=E9=A1=B5=E6=90=9C=E7=B4=A2=E5=8A=9F=E8=83=BD=E7=9A=84=E9=85=8D?= =?UTF-8?q?=E7=BD=AE=E6=AD=A5=E9=AA=A4=E5=92=8C=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/advanced/misc.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docs/advanced/misc.md b/docs/advanced/misc.md index 1bb77b41..ca4ddb23 100644 --- a/docs/advanced/misc.md +++ b/docs/advanced/misc.md @@ -6,6 +6,25 @@ 敏感词词库位于 `src/config/static/bad_keywords.txt` 文件，每行一个关键词，实时生效，无需重启服务。 +## 网页搜索 + +系统内置了基于 Tavily 的联网搜索能力，配置完成后，大模型会自动在需要时调用 `enable_web_search` 对应的工具，为回答提供实时网页信息。 + +### 配置步骤 + +1. 前往 [Tavily 官网](https://app.tavily.com/) 注册并在控制台创建 API Key。 +2. 在项目根目录的 `.env`（或 `docker-compose.yml` 中的对应环境变量段）写入： + ```env + TAVILY_API_KEY=sk-xxxxxxxxxxxxxxxx + ``` +3. 重新加载服务使密钥生效，推荐执行： + ```bash + docker compose up -d api-dev web-dev + ``` + 若服务已运行，则使用 `docker compose restart api-dev` 即可。 + +完成以上步骤后，后端会自动将 `enable_web_search` 标记为启用，在智能体的工具配置区域即可看到这个工具，展示 Tavily 返回的实时结果。若需要关闭该能力，删除或清空 `TAVILY_API_KEY` 后再次重启服务即可。 + ## 服务端口 系统使用多个端口提供不同服务，以下是完整的端口映射：