版本：2.0.x

在业务函数中调用 AI 知识库检索和维护资料

AI 知识库不仅可以被 Agent 查询，也可以在后端可视化编程函数中直接调用。开发者可以在服务函数、模型函数、任务函数或事件函数中使用知识库完成语义检索、关键词检索、按业务 ID 新增文档和按业务 ID 删除文档。

语义检索适合用户自然语言提问，例如“退货超过 7 天还能处理吗”；关键词检索适合已经明确关键词的场景，例如先由大模型提取退货、7天、售后政策，再用关键词查询缩小范围。

这里的关键词查询是业务函数中显式调用的知识库方法。它和知识库设置中的启用关键词召回相关，但不是同一个入口：关键词查询由开发者在函数流程中主动调用；关键词召回是在知识库查询链路中自动补充候选片段，通常由 Agent 查询知识库或调用“查询”方法时触发。

在后端可视化编程中调用 AI 知识库

在后端可视化编程函数（服务函数/模型函数/任务函数/事件函数）中，知识库元素提供了“查询”“新增文档”“删除文档”“关键词查询”4 个方法。

在函数面板的空白语句处点击请选择，选择知识库 - 【知识库名称】 - 查询，生成 AI 知识库查询函数；可在查询函数的输入框中设置查询内容。

在函数面板选择知识库 - 【知识库名称】 - 新增文档，生成新增文档函数；点击函数中的文档添加配置打开新增文档的详细配置。

填入业务ID、文档文件及其它向量化配置后点击保存。其中业务ID是当前添加文档的业务标识，后续可据此删除同一业务对象关联的文档；文档文件支持附件字段中的多个文件。

提示

其它配置参考向量化配置。

在函数面板选择知识库 - 【知识库名称】 - 删除文档，生成删除文档函数；填入业务 ID，运行后会删除该业务 ID 下的所有文档。

在函数面板选择知识库 - 【知识库名称】 - 关键词查询，生成关键词查询函数；配置关键词列表与查询数量后，返回对应的查询结果。

提示

可先用大模型从问题中提取关键词，再进行关键词查询。

关于知识库查询流程的详细说明，包括向量检索、关键词召回、可选重排和参数配置，请参见创建可被 Agent 检索的 AI 知识库 - 检索机制。

如果在业务函数中调用“查询”方法，知识库会按当前 Knowledge Settings 执行检索：未开启关键词召回时走向量检索和可选重排；开启关键词召回且配置了重排模型时，会同时执行向量召回和关键词召回，再合并去重并重排。

如果在业务函数中调用“关键词查询”方法，则只按你传入的关键词列表进行关键词检索，不会自动执行语义向量召回。开发者可以根据业务需要，把“关键词查询”的结果与其它业务逻辑自行组合。