配置知识库组模板和实例
一体化智能体运行与协同平台（AgentWorks）把知识处理分成两层：先在知识库管理中创建集合并入库资料，再用知识库组把一个或多个集合及检索参数提供给智能体。
想先按固定资料完成一次入库、检索、Trace 和无答案验证，参见构建可追溯的企业知识助手。
当回答需要依据团队维护的文档，并且需要检查实际检索了哪些资料时，使用知识库组。需要查询持续变化的业务状态时，使用 MCP 或用户工具包；需要跨会话保留用户信息时，使用记忆库。开始前至少准备一个已经完成入库的 Collection；完成配置后，以回答内容和 Trace 中的检索记录作为验证结果。
这三个阶段由不同页面承接：知识库管理完成资料入库并形成 Collection，知识库组引用 Collection 并保存默认检索参数，智能体实例在回答问题时执行检索。知识库组不会复制 Collection 中的资料；最后通过 Trace检查实际调用的 Collection、参数和结果。
创建知识库集合并导入资料
在 知识库管理 中创建 collection，并通过本地文档、飞书文档、网页 URL 或 Sitemap 导入内容。完成任务和日志检查后，再把 collection 加入知识库组。
有关创建字段、文件限制、飞书授权、网页重跑、定时任务和删除后果，参见创建集合并导入知识。
理解知识库模板的范围
知识库组模板保存：
- 名称和描述。
- 默认
top_k。 - 默认知识库集合。
知识库组实例选择模板、top_k 和知识库集合。资料导入和 Collection 生命周期在 知识库管理 中完成。将知识库组添加到智能体模板前，请先完成资料入库，并用固定问题验证检索结果。
创建知识库组资源
根据复用方式创建知识库组模板或实例。以下流程分别说明如何保存可复用的默认配置，以及如何创建可供智能体使用的知识库组实例。
以下入口仅在租户已启用知识库能力时可用。按钮会在新标签页打开控制台。若先进入登录页，控制台目前不会在登录后自动返回目标页面；请登录后返回本文，再次选择按钮。
打开 知识库组。
也可从左侧导航进入 知识库组。
创建知识库组模板
- 选择 模板。
- 打开 新建模板 表单。
- 填写必需的 名称 * 和可选的 描述。
- 设置 默认检索条数（top_k）。
- 在 默认知识库集合 * 中选择至少一个已注册集合。
- 选择 创建。
top_k 可配置范围为 1 到 100。常见起点为 4 到 10，但应根据真实问题、文档粒度和回答质量测试。
创建知识库组实例
- 在 知识库组 中选择 实例，再选择 新建。
- 在 新建实例 中填写 名称和可选的 说明，并通过 模板 选择来源模板。
- 设置 默认检索条数（top_k），并在 知识库集合 * 中选择至少一个已注册集合。
- 选择 创建。
如果多个智能体实例应查询同一组集合，可以共享一个知识库组实例。
删除知识库组实例不会删除已有 Collection。Collection 的资料导入和生命周期仍在 知识库管理 中管理。
将知识库组添加到智能体模板
- 创建或编辑智能体模板，打开 插件配置。
- 单击 添加插件。
- 选择 知识库 RAG - 模板 或 知识库 RAG - 实例，再选择目标知识库组模板或实例。
- 保存智能体模板。
- 在智能体模板详情页的 插件 页签中确认知识库类型、名称和资源 ID。
- 创建或更新智能体实例。
创建知识库集合或知识库组后，还需要在智能体模板中添加相应的知识库插件，智能体才能使用这些知识资源。
理解一次运行时检索
创建或更新智能体实例后，知识库组为运行时检索提供 Collection 范围和默认参数。模型根据用户问题和 Collection 描述决定是否使用知识检索；发起检索时，模型选择 Collection，并提供查询文本和可选的 top_k。一次提问中的模型调用、知识检索和 Trace 记录关系如下：
验证检索行为
在 Playground 中用以下测试确认检索行为：
- 能被单一文档明确回答的问题。
- 跨文档问题。
- 集合中不存在答案的问题。
- 文档更新后应发生变化的问题。
同时检查 Trace，展开知识检索调用，核对 collection_name 与目标 Collection 的资源 ID，并检查实际 top_k 和检索结果。知识库组中的 top_k 是默认值；检索调用可以使用不同的值，因此应以 Trace 中的实际参数评估本次回答。
维护生产知识库
- 为集合指定内容负责人。
- 监控入库任务和定时重跑。
- 在删除集合前盘点知识库组引用。
- 文档变化后重新执行固定问答测试。
- 不把“模板已保存”当作“资料已成功入库”。