为 RikkaHub 消息启用网页搜索 · 实时信息注入

为什么需要网页搜索

大模型的训练数据有截止日期——它不知道"昨天发生了什么"、"最新的 API 文档是什么"、"当前的价格是多少"。网页搜索让 AI 能获取实时、最新的信息。

RikkaHub 的网页搜索通过工具调用（tool calling）实现——模型决定要不要调用 search_web 工具、搜什么关键词、是否还需要 scrape_web 抓取页面完整内容。

启用方式

1. 在聊天界面，找到输入工具栏（文字输入框上方的图标行）
2. 点击地球仪 / 搜索图标，开关高亮表示已激活
3. 正常输入你的问题，发送即可

模型会判断这个问题是否需要搜索。如果需要，它会发出 search_web 工具调用，RikkaHub 用你配置的搜索服务获取结果后注入上下文，模型整合后生成回复。

搜索在后台的流程

1. 你发送消息（搜索开关已开）
2. RikkaHub 把 search_web 工具注册到模型
3. 模型判断这个问题需不需要搜索
   ❌ 不需要 → 直接用训练数据回答
   ✅ 需要 → 发出 search_web 工具调用（带 query 参数）
4. RikkaHub 调用你配置的搜索服务 → 获取结果列表
5. 结果（标题 + URL + 摘要）作为工具输出返回给模型
6. 某些服务还支持 scrape_web（抓取单页完整内容）
7. 模型整合搜索结果到最终回复中

整个搜索过程在后台静默进行。你可能看到对话里短暂出现"处理中"状态提示，然后模型直接给出包含搜索结果引用的回复。

哪些问题模型会触发搜索

取决于模型的判断能力。典型会触发的：

• "XXX 的最新版本是多少"
• "2025 年 AI 行业有哪些突破"
• "当前 XX 股票价格"
• "查一下 RikkaHub v2.5.6 更新了什么"
• "最新的 Python 安装教程"

典型不会触发的（模型认为自己已知）：

• 编程基础语法、通用算法
• 常识性问题
• 训练数据截止日期之前的信息

让模型"必须"搜索

如果你确定这个问题需要搜索，想让模型一定去搜：

• 在提示词里明确要求："请搜索最新信息后回答"
• 或用专用搜索页面（见下节）手动搜索后把结果作为上下文发给模型

搜索结果里的引用链接

模型回复中通常会包含搜索结果的来源链接。点击可以在浏览器中打开。这是 RikkaHub 内置的行为，不需要额外配置。

搜索 vs 不用搜索的对比

常见问题

模型不搜索，直接用旧数据回答

可能是：

1. 模型判断这个问题"不需要搜索"（它以为自己知道）
2. 搜索服务配置有问题（返回错误）
3. 没有配置任何搜索服务（工具栏开关开了但底层没服务可用）

排查：设置 → 搜索 → 检查是否配置了至少一个搜索服务、是否设为激活。

搜索结果太多，Token 爆了

在搜索服务配置里把"结果数量"设小一些（比如 3-5 条），或者用专用搜索页手动筛选后再发给模型。