核心引擎-预召回

简述

预召回在访客发送会话中的第一条用户消息时，自动用这条消息的全文发起一次「文档切片」检索，并把结果交给您在 核心引擎-基础设定 的系统提示词中编排引用。开启后可减轻首轮从零复述知识的负担，适合常见问题已由知识库覆盖的场景。本页的改动在您点击 保存 并成功写入后对该 Agent 生效。

功能位置

进入某一 Agent 的详情后，在左侧二级菜单打开 核心引擎，再选择三级菜单 预召回。

配置与规则

启用预召回

开关旁标题为 启用预召回。在会话首轮用户消息时，自动执行一次文档切片搜索，将结果注入系统提示词。

• 关闭：不进行首轮自动检索；不要求必选搜索工具。
• 开启：保存前必须在下方选定一项搜索工具；

开启后出现区块 预召回使用的文档切片搜索工具，副文案说明：仅展示已启用且类型为搜索的工具实例。

若当前 Agent 下尚无任何符合条件的搜索工具，页面会提示先到 工具管理 添加并启用搜索工具；界面提供快捷入口便于跳转。

若已列出可选工具但未选定条目，保存仍为不可用状态；表单下方会出现红色提示 请选择一个搜索工具。若在启用状态下点击保存仍未选定工具，会弹出提示：请先选择文档切片搜索工具。

保存行为

有合法改动且满足启用开关与工具的校验后，保存可点击；提交中按钮文案为 保存中…。成功后提示「保存成功」。保存仅提交本页的 预召回 配置，与该 Agent 在 核心引擎-基础设定、其它引擎子页中已保存的内容不会互相覆盖整块引擎配置。

提示词变量说明

页面底部的说明卡片标题为 提示词变量说明，内容与运行时写入规律摘要如下：

• {{first_search}}：展开为首轮预召回的检索文本；若无检索结果则为空字符串。
• {{#first_search}}…{{/first_search}}：条件区块：检索不到有效内容时，整块不参与注入。

可按需在 基础设定 的「提示词 / System Prompt」中沿用或改写。

注意事项

• 首轮预召回使用的检索用语为您的访客第一条消息的完整文本，建议在知识库侧兼顾口语提问与同义词覆盖。
• 必须先有可用的「搜索」类工具实例并完成启用；仅有其它类型的工具时列表会持续为空，请先前往 工具管理 配置。
• 核心引擎-基础设定 的系统提示词中应包含 {{first_search}} 或对应的条件块占位，首轮检索结果才会按约定写入提示词并参与本轮推理。

与其他功能的关系

• 核心引擎-基础设定：系统提示词中写入 {{first_search}} 或条件块后，预召回注入才有承载位置；模型与其它表单仍以基础设定为准。
• 工具管理：搜索工具在此新增、编辑或停用后会直接影响本页下拉里可选条目。
• 知识库：搜索工具通常绑定具体知识空间，切片内容由知识侧的文档与同步策略决定。
• 会话记录：首轮问答可走预召回链路；复盘时请结合当时的提示词与工具绑定理解上下文来源。

业务场景示例

常见问题先入为主的导购助手

角色与目标
您是运营管理员，希望访客第一句就问「这款手机防水吗」时，答复先引用说明书条款，而不是纯靠模型臆测。

系统配置
在 工具管理 中为该 Agent 配置并启用绑定说明文档知识空间的搜索工具。打开 预召回 启用开关并选定该工具。在 基础设定 的提示词中加入 {{#first_search}} 条件块与标题「参考文档摘录」，引导模型优先依据摘录作答。

场景效果
首轮用户提问触发检索后，系统提示词中自动带入相关切片；后续轮次仍按对话流程与工具策略执行，首轮体验更贴近知识库事实。