配置知识库组模板和实例
智能体开发服务平台（AgentWorks）把知识处理分成两层：先在知识库管理中创建集合并入库资料，再用知识库组把一个或多个集合及检索参数提供给智能体。
想先按固定资料完成一次入库、检索、Trace 和无答案验证，参见构建可追溯的企业知识助手。需要由一位内容负责人统一更新资料，并让多个智能体复用同一项知识服务时，参见构建由平台统一维护、供多个智能体复用的知识服务。
当回答需要依据团队维护的文档，并且需要检查实际检索了哪些资料时，使用知识库组。需要查询持续变化的业务状态时，使用 MCP 或用户工具包；需要跨会话保留用户信息时，使用记忆库。开始前至少准备一个已经完成入库的 Collection；完成配置后，以回答内容和 Trace 中的检索记录作为验证结果。
这三个阶段由不同页面承接：知识库管理完成资料入库并形成 Collection，知识库组引用 Collection 并保存默认检索参数，智能体实例在回答问题时执行检索。知识库组不会复制 Collection 中的资料；最后通过 Trace检查实际调用的 Collection、参数和结果。
创建知识库集合并导入资料
在 知识库管理 中创建 collection，并通过本地文档、飞书文档、网页 URL 或 Sitemap 导入内容。完成任务和日志检查后，再把 collection 加入知识库组。
有关创建字段、文件限制、飞书授权、网页重跑、定时任务和删除后果，参见创建集合并导入知识。
理解知识库组与插件选项的关系
资料进入智能体前，会经过三个相互关联但用途不同的配置位置：
在智能体模板的 插件配置 中，知识库 RAG - 模板 对应知识库组模板，知识库 RAG - 实例 对应知识库组实例。这里的“RAG”表示智能体通过检索使用知识，不是另一种知识库资源。
知识库组模板保存：
- 名称和描述。
- 默认
top_k。 - 默认知识库集合。
知识库组实例选择模板、top_k 和知识库集合。资料导入和 Collection 生命周期在 知识库管理 中完成。将知识库组添加到智能体模板前，请先完成资料入库，并用固定问题验证检索结果。
选择知识库 RAG 模板或实例
两种方式都不会复制 Collection。区别在于多个智能体实例是共用一个知识库组实例，还是根据知识库组模板分别创建知识库组实例。
选择 知识库 RAG - 实例 时，智能体直接连接已经存在的知识库组实例。多个智能体实例选择同一个知识库组实例后，会共用相同的 Collection 范围和默认检索参数。
同一租户中具有相应访问权限的用户，可以各自创建智能体模板，并在 插件配置 中选择同一个 知识库 RAG - 实例。从这些智能体模板创建的智能体实例会共同使用该知识库组实例。需要直接复用已经验证的资料范围和检索配置时，这是更简单的选择。
选择 知识库 RAG - 模板 时，智能体模板只保存对知识库组模板的引用。每次创建智能体实例时，平台根据该模板创建一个知识库组实例。不同知识库组实例拥有各自的资源 ID 和检索配置，但仍可引用同一个 Collection。
注意
通过 /init 创建时怎样确定 Collection 和 top_k
飞书或 QQ 渠道账号使用模板绑定时，渠道用户发送 /init 只触发智能体实例及配套知识库组实例的创建。新知识库组实例直接采用知识库组模板中保存的默认 Collection 和 top_k；当前控制台提供的标准流程不会要求渠道用户在 /init 中填写这两项。
如果智能体模板还包含 MCP 等可配置参数，/init 仍可能要求填写这些参数，但不会因此开放知识库组的 Collection 或 top_k。
根据需要的结果选择：
- 多个智能体需要使用同一份资料和同一套检索配置时，选择 知识库 RAG - 实例。
- 多个智能体使用同一份资料，但需要根据统一模板为每个智能体实例分别准备知识库组实例时，选择 知识库 RAG - 模板。每个知识库组实例分别保存资源 ID 和检索配置。
- 多个智能体不能访问同一份资料时，准备不同的 Collection，并配置相应的访问权限。生成不同的知识库组实例不会自动隔离 Collection 中的资料。
重要
独立知识库组实例不等于独立资料
根据同一个知识库组模板创建的多个知识库组实例，仍可能引用同一个 Collection。它们分别保存检索配置，但检索的仍是同一份已入库资料。需要隔离资料时，请使用不同的 Collection，并配置相应的访问权限。
理解创建结果
智能体模板保存插件选择和目标资源。选择 知识库 RAG - 实例 时，创建智能体实例不会再创建知识库组实例。两个用户也可以各自创建智能体模板，并选择同一个已有知识库组实例：
用户 A 和用户 B 不需要共用同一个智能体模板。只要两人能够使用知识库组实例 G，就可以在各自的智能体模板中选择该实例；随后创建的智能体实例会共同使用 G 的检索配置和 Collection C。
选择 知识库 RAG - 模板 时，创建智能体模板不会同时创建新的知识库组实例。平台会在创建智能体实例时准备对应的知识库组实例。以下以知识库组模板 T 保存 Collection C 和默认 top_k=6 为例：
使用 知识库 RAG - 实例 不会再创建知识库组实例；用户 A 和用户 B 的智能体实例都使用已经存在的 G。使用 知识库 RAG - 模板 会得到两个知识库组实例。G-A 和 G-B 分别拥有资源 ID 并分别保存检索配置，但初始 Collection 和默认 top_k 都复制自模板 T，并且都可以检索 Collection C。
注意
不同创建用户仍可能使用同一份资料
选择 知识库 RAG - 实例 时，不同用户创建的智能体实例会共同使用所选知识库组实例及其 Collection。选择 知识库 RAG - 模板 时，不同用户会分别得到知识库组实例，但这些实例仍可引用同一个 Collection。需要隔离用户可检索的资料时，请使用不同的 Collection，并配置相应的访问权限。
创建后，在智能体模板的 插件 页签核对选择的是模板还是实例，在 知识库组 中核对实际知识库组实例和引用的 Collection，再通过 Trace 检查本次检索的 collection_name、top_k 和返回结果。
处理更新和删除
知识库组模板、知识库组实例、智能体实例和 Collection 分别管理。变更其中一个资源时，按以下方式检查相关资源：
- 修改知识库组模板：已有知识库组实例不会自动采用模板中的新配置。请检查受影响的智能体实例和知识库组实例，并用固定问题重新验证检索结果。
- 删除智能体实例：与该实例配套创建的知识库组实例需要在 知识库组 中单独检查和清理。删除智能体实例不会完成全部能力资源的清理。
- 删除知识库组模板：已经创建的知识库组实例需要在实例列表中单独检查和处理。
- 删除知识库组实例：已有 Collection 仍由 知识库管理 管理。删除不再使用的知识库组实例前，先确认没有其他智能体仍在共享该实例。
- 删除 Collection：先盘点引用该 Collection 的知识库组模板和实例。删除后，仍保留的配置将无法从该 Collection 检索资料。
完成更新或清理后，在测试智能体实例中新建会话，使用固定问题验证回答，并在 Trace 中核对实际 Collection 和检索参数。
创建知识库组资源
知识库组实例不能脱离知识库组模板直接创建。创建实例时必须选择一个知识库组模板，并选择至少一个已经登记的知识库集合。
以下流程分别说明如何保存可复用的默认配置，以及如何创建可供智能体使用的知识库组实例。
以下入口仅在租户已启用知识库能力时可用。按钮会在新标签页打开控制台。若先进入登录页，控制台目前不会在登录后自动返回目标页面；请登录后返回本文，再次选择按钮。
打开 知识库组。
也可从左侧导航进入 知识库组。
创建知识库组模板
- 选择 模板。
- 打开 新建模板 表单。
- 填写必需的 名称 * 和可选的 描述。
- 设置 默认检索条数（top_k）。
- 在 默认知识库集合 * 中选择至少一个已注册集合。
- 选择 创建。
top_k 可配置范围为 1 到 100。常见起点为 4 到 10，但应根据真实问题、文档粒度和回答质量测试。
创建知识库组实例
- 在 知识库组 中选择 实例，再选择 新建。
- 在 新建实例 中填写 名称和可选的 说明，并通过 模板 选择来源模板。
- 设置 默认检索条数（top_k），并在 知识库集合 * 中选择至少一个已注册集合。
- 选择 创建。
信息
手动选择不会变成 /init 参数
在这里选择 Collection 和 top_k，是在控制台中单独创建一个知识库组实例。它不会把这两个字段变成智能体模板的具名实例参数，也不会让渠道用户以后通过 /init 重新填写。
如果多个智能体实例应查询同一组集合，可以共享一个知识库组实例。
删除知识库组实例不会删除已有 Collection。Collection 的资料导入和生命周期仍在 知识库管理 中管理。
查看知识库组实例引用的 Collection
知识库组实例保存可供智能体检索的 Collection 范围。实例列表中的 集合数 只表示引用数量；需要确认具体 Collection 时，请打开实例详情。
如果从某个智能体开始检查，请先在智能体模板的 插件 页签中记录关联的知识库组实例名称和资源 ID。
- 在 知识库组 中选择 实例。
- 按名称或资源 ID 找到目标知识库组实例。
- 单击实例名称或所在行。
- 在 引用的知识库集合 中核对 Collection 资源 ID。
重要
记录 Collection 名称和资源 ID
实例列表只显示引用数量；实例详情按资源 ID 列出 Collection，不显示 Collection 名称，也不能从该页面直接打开对应 Collection。知识库管理 的 Collection 列表也不显示这些资源 ID，因此无法仅通过现有详情和列表完成名称与 ID 的对照。创建或选择知识库组实例时，请记录 Collection 名称和资源 ID。复用由其他负责人维护的实例时，请向负责人确认这两项信息；不要仅凭相同名称判断两个资源是同一个 Collection。
引用的知识库集合 表示该实例可供检索的 Collection 范围。某次运行实际检索了哪个 Collection，需要在智能体实例的 Trace 中查看 collection_name。一个实例引用多个 Collection 时，并不表示每次运行都会检索全部 Collection。
将知识库组添加到智能体模板
选择 知识库 RAG - 实例 时，需要继续选择一个已有的知识库组实例。
- 创建或编辑智能体模板，打开 插件配置。
- 单击 添加插件。
- 选择 知识库 RAG - 模板 或 知识库 RAG - 实例，再选择目标知识库组模板或实例。
- 保存智能体模板。
- 在智能体模板详情页的 插件 页签中确认知识库类型、名称和资源 ID。
- 创建或更新智能体实例。
创建知识库集合或知识库组后，还需要在智能体模板中添加相应的知识库插件，智能体才能使用这些知识资源。
理解一次运行时检索
创建或更新智能体实例后，知识库组为运行时检索提供 Collection 范围和默认参数。模型根据用户问题和 Collection 描述决定是否使用知识检索；发起检索时，模型选择 Collection，并提供查询文本和可选的 top_k。一次提问中的模型调用、知识检索和 Trace 记录关系如下：
结果重排由平台统一配置，用户无需在知识库组中单独设置。启用结果重排时，平台会根据问题重新排列候选结果；未启用或重排不可用时，检索仍按普通相关度排序。检索结果包含图片时，只有所选模型支持图像输入，模型才能直接理解图片内容；使用仅支持文本输入的模型时，应以文本内容和 Trace 中的检索结果完成验证。
验证检索行为
在 Playground 中用以下测试确认检索行为：
- 能被单一文档明确回答的问题。
- 跨文档问题。
- 集合中不存在答案的问题。
- 文档更新后应发生变化的问题。
同时检查 Trace，展开知识检索调用，核对 collection_name 与目标 Collection 的资源 ID，并检查实际 top_k 和检索结果。知识库组中的 top_k 是默认值；检索调用可以使用不同的值，因此应以 Trace 中的实际参数评估本次回答。
维护生产知识库
- 为集合指定内容负责人。
- 监控入库任务和定时重跑。
- 在删除集合前盘点知识库组引用。
- 文档变化后重新执行固定问答测试。
- 不把“模板已保存”当作“资料已成功入库”。