联网检索

Brave Search 联网检索让 AI 聊天具备实时上网能力。开启后，AI 会在需要时自动调用 Brave Search API 检索互联网，将搜索结果融入回答，无需用户手动触发。

---

一、为什么需要联网检索？

大语言模型的知识存在训练截止日期，对截止日期之后发生的事件一无所知。例如：

• 今年上映了哪些电影？
• 最新的 JeecgBoot 版本是什么？
• 今天股市有什么重要消息？

这类问题若不联网，模型只能回答"不知道"或给出过时信息。开启 Brave Search 后，模型会自动搜索互联网并基于最新结果作答。

---

二、后端配置

编辑 application-dev.yml（或对应环境的配置文件），在 jeecg.ai-rag 下添加以下配置：

jeecg:
  ai-rag:
    # Brave Search 联网检索配置
    brave-search:
      api-key: 你的BraveSearchApiKey                            # API Key（必填）
      endpoint: https://api.search.brave.com/res/v1/web/search  # 默认即可，无需修改
      count: 5                                                   # 每次搜索返回的结果条数
      timeout: 15                                                # 请求超时秒数

如何获取 API Key？ 前往 https://brave.com/search/api/ 注册并创建订阅，即可获得 X-Subscription-Token（即 API Key）。免费套餐每月提供 2000 次请求，满足小规模使用。

配置完成后重启服务即可生效，无需修改任何代码或前端配置。

---

三、工作原理

聊天模式下，Brave Search 以 AI Agent 工具（Tool） 的形式自动挂载到大模型上，对默认聊天应用和自定义 App 均生效。

用户提问 → 模型分析意图 → 判断是否需要联网
                              ├── 需要 → 调用 brave_web_search → 获取搜索结果 → 结合结果回答
                              └── 不需要 → 直接基于训练知识回答

模型会根据问题自动决策是否搜索，用户无需任何额外操作。

---

四、使用效果

配置生效后，用户只需在聊天框选择联网搜索后，正常提问即可。涉及实时信息时，AI 会自动发起搜索，回答中通常会附带参考来源链接。

需要注意的是，如果您是流程编排，这里是不生效的。请使用流程搜索节点

典型问题示例：

问题类型	示例	是否触发搜索
实时新闻	"今天有什么重要新闻？"	✅
近期影视	"2026年有哪些好看的动作片？"	✅
通用知识	"Java 和 Python 有什么区别？"	❌
数学计算	"1024 的平方根是多少？"	❌

---