工具管理

简述

工具管理列出挂载在当前 Agent 上的工具实例：系统工具由平台预置；自定义工具可由您在租户内新增，并在详情页完成绑定知识库、检索模式与筛选规则等配置。表格中的启用开关用于控制在对话链路里是否允许调用该工具实例。自定义工具可移除实例本身（仅从当前 Agent 解绑），不改变底层知识库或文档资源。

功能位置

在某一 Agent 详情页的左侧二级菜单中选择 工具管理。列表区内上方区块为 系统工具，下方为 自定义工具及 添加工具 按钮。

配置与规则

列表与分区

• 系统工具：表格列出名称、类型、描述、状态与操作列；类型徽章文案固定为 系统工具。行内提供启用开关，单击数据行不会进入详情编辑。
• 自定义工具：点击某一自定义工具所在行会打开该工具的详情配置页。行尾提供启用开关与移除图标。

表格 描述 为空时展示「—」。状态 列用双色区分 已启用 与 已禁用。

启用与禁用

切换开关后立即提交；成功时分别提示「工具已启用」或「工具已禁用」。

添加自定义工具

1. 点击 添加工具，在弹窗中选择 工具类型，填写 工具名称 与 工具描述，再点 添加 提交。
2. 工具类型：界面以卡片呈现可选类型；新建成功后不同类型的详情页标题与分区会有所差异。
3. 工具名称：必填，首尾空格在提交前去掉；长度上限 128 字符；在同一 Agent 的工具列表中不可与其它工具重名，冲突时提示「工具名称已存在」。
4. 工具描述：选填，面向模型说明调用场景，便于对话时被选中。
5. 未选择类型时点 添加 会提示「请选择工具类型」；
6. 添加成功后提示「工具已添加」，并自动进入该工具的详情页。

以下按类型说明表单。搜索工具与文档查询提供完整分区；其它类型的分区布局以进入详情页后的界面为准。

移除自定义工具

点击移除图标后弹出确认框 移除工具，正文询问是否从当前 Agent 移除该工具名称引用；确认按钮为 确定移除。成功后提示「工具已移除」，该行从列表消失。

工具详情

工具详情用于把列表里的工具实例落实为可稳定执行的检索策略：您在此指定知识来源、召回方式与返回内容形态，并界定模型在一次调用中可使用的筛选维度。这样做能让 Agent 在对话中有据可查地引用知识，同时在效果、耗时与 Token 成本之间取得平衡；借助固定筛选等能力，还可以缩小可被检索的数据范围，满足对内对外资料隔离等要求。

以下小节展开 切片搜索工具与文档查询工具的主要分区名称与用途。

切片搜索工具

1. 基础信息

   • name：调用标识名称；字段下方说明供模型发起调用时使用。
   • description：工具意图与用途说明；字段下方说明供模型选择工具时参考。
   • LLM 可调用的 filter 维度：三组开关，用于决定在自动生成且只读的 parameters 预览里是否向模型暴露文档 ID、文档元数据、切片元数据三类结构化筛选能力；关闭后模型无法在调用参数里写入对应维度，固定筛选与工具输入变量不受影响。
   • parameters (只读，自动生成)：展示依据前述选项生成的参数结构预览。

2. 知识库绑定

   • 知识库：选择要绑定的知识空间。
   • 启用 ID引用：开关副文案说明启用后搜索结果会落库并生成引用编号。

3. 固定筛选条件
   说明文案表述检索始终附带此处配置的结构化条件且不暴露给模型；可按「文档 / 切片」两级维度添加多条条件，支持字段联想与运算符随字段类型变化，亦可手动填写字段名。界面提供 添加条件 维护各行。

4. 工具输入变量
   展示系统自动分配的变量槽名称（形如界面中以 tool_ 前缀开头的标识）；说明其它组件可向该槽写入合并所需的筛选结构，且此机制对模型透明。

5. 检索配置

   • 检索模式：单选 混合搜索、BM25、向量搜索。混合模式下额外暴露 BM25 与向量两套权重输入框。
   • 重排序：开关控制是否启用；启用后可填写 Reranker Top N、最小评分阈值，阈值说明中指出取值范围为 0.00～1.00，留空代表不设下限。
   • 返回条数：限制单次检索返回的最大条目数，设有上下界。

6. 分类搜索
   顶部开关启用后，可按「分类组」并行维护多组名称与内部筛选条件；每组下方同样提供「添加条件」。启用说明中提到分组召回与普通检索并行。

7. 响应元数据
   说明勾选字段越多，返回给模型的附带信息与占用越高。doc_id、slice_id 以锁定标签形式固定展示不可移除；其余字段可通过 添加字段 交互分别从文档元数据、切片元数据或系统额外字段集合挑选。

文档查询工具

与搜索工具一致的 基础信息（此处不包含面向模型的 filter 维度开关）、知识库绑定、固定筛选条件（限定为文档级元数据维度）、工具输入变量（文案侧重文档筛选结构）。其后分区为：

1. 检索配置：包含 搜索返回条数 与 筛选返回条数 两套上限输入框；辅助说明指出分别在「有关键词检索」与「纯筛选」场景生效，各自带有取值区间约束。
2. 响应元数据：拆成 搜索响应元数据 与 仅筛选响应元数据 两块，各自维护返回字段列表；doc_id 在两段列表中都以锁定标签呈现。

注意事项

• 自定义工具名称在同一 Agent 内需唯一，改名请在详情页 保存 生效后再同步更新引用该名称的外部编排。
• 绑定知识库后，固定筛选与响应字段下拉依赖知识空间的元数据结构；若 Schema 尚未就绪，可先同步文档或在知识空间中维护字段再返回配置。
• 禁用工具后，核心引擎-基础设定 中的勾选不会自动清除，但运行时不会再触发调用；

与其他功能的关系

• 核心引擎-基础设定：通过「使用工具 / Tools」多选框决定 Agent 默认挂载哪些工具实例；此处停用会导致勾选仍存在但不可调用。
• 核心引擎-预召回：仅能选取类型为 搜索工具 且处于启用状态的实例。
• 知识空间：搜索与文档查询工具均需绑定具体知识空间后方可检索切片或文档。
• 会话记录：可按会话回放模型调用工具的记录，便于核对启用策略是否生效。

业务场景示例

两条搜索工具区分对内对外资料

角色与目标
您是知识管理员，既希望客服 Agent 能搜面向客户的帮助文档，又要隔离尚未发布的内部制度 PDF。

系统配置
添加两条 搜索工具，名称分别指向外部可见库与内部库；在 固定筛选条件 或分类搜索中为内部工具追加文档级标签约束，并把外部工具的 返回条数 控制在更易阅读的区间。回到 核心引擎-基础设定 勾选两条工具，按需在提示词里交代调用优先级。

场景效果
模型可在对话中分别触发两套检索路径；停用内部工具行开关即可临时下线内部检索来源。