产品操作手册 / 知识与能力扩展

知识库

知识库用于把分散资料变成可搜索、可授权的组织知识。文档上传并完成索引后，用户可以直接检索；需要让数字员工在对话中使用时，还需将该知识库创建为独立的内置 MCP 服务，并明确添加到目标员工。

适用人员: 知识使用者、知识库负责人、内容维护者、平台管理员、审计人员
统一入口: 左侧导航“知识”
完成标准: 资料可检索、来源可追溯，并能在授权范围内被员工调用

开始之前

先确认权限、资料和运行条件

下面的准备项应在正式操作前完成。涉及外部发送、公开分享或高权限设置时，还需按组织流程完成审批。

本页角色分工

先按你的职责查阅；页面是否可操作，仍以账号实际权限为准。

普通业务用户: 搜索和阅读已授权知识，在对话中核对员工回答引用的文档来源。
负责人: 创建知识库、上传资料、测试检索、维护分段，并管理职责范围内的权限。
管理员: 配置知识服务、向量与重排模型、单库 MCP、平台审计和租户级治理。

01
已获得知识功能菜单权限。
02
创建者已确定访问范围、责任人和可导入资料。
03
平台管理员已配置可用的向量模型及文档处理服务。

操作前注意

导入知识库不会自动取得原文件的传播授权。
检索质量需结合真实问题测试，不能只看处理成功状态。
公共知识和高权限授权应经过审批并定期复核。

新手必学

日常工作首先掌握

进阶操作

有明确需要时使用

谨慎操作

可能影响权限、数据或运行状态

完整流程

从上传资料到数字员工引用

下面的流程适用于首次建立知识库。前三步完成资料处理和检索验证，后三步将知识库交给指定数字员工使用。

01
创建知识库
进入“知识 → 全部知识库”，点击“新建知识库”。填写名称和说明，选择访问范围，核对页面显示的平台默认 Embedding 和 Reranker 模型后保存。模型由管理员在知识服务中统一配置，不在新建对话框中切换。
02
上传文档并等待就绪
打开新建的知识库，点击“上传文档”。提交文件后等待状态从“正在建立索引”变为“已就绪”。若状态为“失败”，先查看处理任务中的错误再重试。
03
用真实问题做检索测试
在知识库详情点击“检索测试”，输入一个能在文档中找到答案的完整问题。结果应命中正确文档和原文片段；若未命中，先调整文档、切片或检索设置，不要直接进入员工绑定。
04
创建单知识库 MCP 服务
使用管理员账号进入“管理后台 → MCP 服务”，点击“新增 MCP 服务 → 添加内置 MCP”。选择刚刚验证过的知识库，确认或填写 MCP Server 名称，然后保存。
05
将 MCP 添加给目标数字员工
进入目标数字员工的员工控制台，打开“配置 → MCP”。点击“添加”，在市场中搜索上一步的 MCP Server 名称并添加。返回 MCP 服务列表，确认该服务已存在且右侧开关已开启。
06
在对话中验证调用
返回工作台，选择刚完成配置的数字员工，建立新话题并询问与上传文档直接相关的问题。展开工具调用记录，确认出现 `knowledge_search`，回答内容与原文一致并带有正确的文档来源。

完成后确认

知识库中的目标文档均为“已就绪”。
检索测试能命中正确文档和原文片段。
目标员工的 MCP 列表中已添加并启用对应知识库服务。
对话中实际调用 `knowledge_search`，回答能与原文及来源相互印证。

常见问题

MCP 创建页找不到知识库

确认知识库已创建并启用，当前管理员有权访问该库。

员工 MCP 市场找不到服务

返回管理后台确认 MCP 已保存；在员工控制台刷新目录后，按 MCP Server 名称搜索。

对话没有调用 knowledge_search

确认选中的是已绑定员工，员工实例已连接，MCP 开关已开启；新建话题后用文档中的具体事实再测。

已调用但没有结果

先用同一问题回到知识库做检索测试；检查文档状态、访问权限、相似度阈值和检索模式。

回答不准确或没有来源

对照命中片段检查原文；先调整 Top N、置信度或重排设置并直接复测。只有分段需重处理、Embedding 模型变更或索引需修复时，才发起对应处理或全量重建。

文档更新后仍返回旧内容

等待新版文档重新索引为“已就绪”，先做检索测试，再新建对话话题验证。

本页术语

先看懂页面里的名称

遇到下列名称时，按这里的含义理解。具体按钮和字段仍以当前页面为准。

知识库: 按业务主题组织文档、检索设置和权限的知识空间。
知识文档: 上传到知识库并经过解析、分段和索引的资料。
分段: 从原文切出的检索单元，员工检索时返回相关片段而不是整份文件。
全文检索: 按关键词匹配原文，适合名称、编号和固定表述。
向量检索: 按语义相似度匹配内容，适合自然语言问题和近义表达。
重排: 对初步召回的结果再次排序，提高最相关片段的优先级。
MCP 服务: 把指定知识库作为可调用工具添加给数字员工的连接方式。
知识引用: 回答中展示的文档和片段来源，用于核对答案依据。

知识库与范围

创建知识库，设置目录、责任人和访问范围。

知识概览

进阶操作建议操作人普通业务用户

汇总知识库、文档、最近使用、最近文档和待处理任务，并提供快捷入口。

从哪进入: 知识页“概览”
何时使用: 用户需要快速了解知识资产和待处理事项时使用。

按顺序操作

进入知识页并停留在概览。
查看统计、最近使用和待处理任务。
通过快捷入口打开知识库或新建知识库。

看到什么算完成

通过快捷入口打开知识库或新建知识库。

全部知识库与目录树

谨慎操作建议操作人普通业务用户

通过目录树、共享与归档虚拟目录、名称搜索和知识库卡片组织可访问知识库。

从哪进入: 知识页“全部知识库”
何时使用: 用户需要浏览个人、团队或公共知识库时使用。

按顺序操作

打开“全部知识库”。
在目录树选择全部、共享、已归档或具体业务目录。
按名称搜索或刷新列表。
核对卡片的归属、当前权限、文档数和生命周期后打开目标库。

看到什么算完成

按名称搜索或刷新列表，核对卡片的归属、当前权限、文档数和生命周期后打开目标库。

知识库目录创建、重命名与移动

谨慎操作建议操作人负责人 / 管理员

创建和重命名目录，把知识库移入指定目录，并允许永久删除空目录。

从哪进入: 全部知识库的目录树和知识库操作菜单
何时使用: 知识库数量较多，需要按业务、部门或项目归类时使用。

按顺序操作

新建目录并填写业务名称。
将目标知识库移到目录。
返回目录树检查归类，只删除已确认为空的目录。

看到什么算完成

返回目录树检查归类，只删除已确认为空的目录。

操作限制与风险

目录只用于组织和查找，不替代知识库 ACL；非空目录不允许删除。

已就绪文档统一视图

谨慎操作建议操作人普通业务用户

将授权范围内已就绪文档汇总在一个列表中，并保留所属知识库和处理状态。

从哪进入: 知识页“全部资料”或“已就绪”
何时使用: 用户需要跨知识库查看已可检索文档时使用。

按顺序操作

打开已就绪文档视图。
按文档名或所属知识库定位资料。
打开文档并核对原文、版本和权限。

看到什么算完成

打开文档并核对原文、版本和权限。

新建与编辑知识库

新手必学建议操作人普通业务用户

创建知识库并维护名称、说明、责任人、目录和基础设置。

从哪进入: 全部知识库“新建知识库”、知识库设置
何时使用: 新的业务主题需要建立独立知识边界时使用。

按顺序操作

填写名称和业务说明。
选择目录位置与访问范围。
创建后进入详情。
检查基础信息并按需编辑。

看到什么算完成

创建后进入详情，检查基础信息并按需编辑。

个人、团队与公共访问范围

谨慎操作建议操作人负责人 / 管理员

按知识库设置个人、团队和公共范围，并与细粒度授权共同生效。

从哪进入: 新建知识库“访问范围”、权限设置
何时使用: 知识需要限定为个人使用、团队协作或组织公开时使用。

按顺序操作

选择个人、指定团队或公共范围。
核对范围内主体和默认权限。
使用不同角色账号验证可见性和检索权限。

看到什么算完成

使用不同角色账号验证可见性和检索权限。

操作限制与风险

公共范围扩大了可见面，重要公共知识库可能需要审核；范围设置不能替代文档级权限。

文档处理

上传资料并检查解析、分段、版本和处理结果。

知识文档上传与格式识别

谨慎操作建议操作人负责人 / 管理员

上传文档并识别格式、大小和安全限制，建立知识文档记录。

从哪进入: 知识库详情“上传文档”
何时使用: 已有文件需要进入知识处理流水线时使用。

按顺序操作

选择或拖入受支持文件。
检查文件名、格式和目标知识库。
提交后进入文档列表查看处理状态。

看到什么算完成

提交后进入文档列表查看处理状态。

同名文件自动重命名、跳过或替换

谨慎操作建议操作人负责人 / 管理员

为同名文件选择自动重命名、跳过或替换原文件，并在上传前显示处理结果。

从哪进入: 知识文档上传抽屉
何时使用: 上传批次中出现与已有文档同名的文件时使用。

按顺序操作

查看同名提示和已有文档。
根据是否需要保留旧版选择处理方式。
上传后检查文档名、版本和处理任务。

看到什么算完成

上传后检查文档名、版本和处理任务。

操作限制与风险

“替换”会用新原文件发起新版本处理；资料尚未审核时建议先自动重命名。

解析、清洗、分段与索引

新手必学建议操作人负责人 / 管理员

执行解析、文本清洗、分段、向量化和索引，并在文档列表、上传摘要和知识任务中展示处理状态。

从哪进入: 知识库详情文档状态、文档处理设置
何时使用: 导入文件需要转化为可搜索内容时使用。

按顺序操作

上传后查看文档的等待、解析、入库、向量处理和就绪状态。
在“文档处理”中核对允许格式和当前分段大小。
失败时打开知识任务的阶段、诊断码和尝试历史，修正后重试。

看到什么算完成

失败时打开知识任务的阶段、诊断码和尝试历史，修正后重试。

图片与扫描件识别

谨慎操作建议操作人管理员

以租户级处理开关和内容模型支持图片理解、OCR、扫描 PDF 识别和文本清洗。

从哪进入: 管理后台的知识服务设置
何时使用: 图片、扫描件或缺少文本层的 PDF 需要提取内容时使用。

按顺序操作

管理员进入知识服务的“处理设置”。
核对所需内容模型已配置。
启用相应处理能力。
上传一份可复核的扫描件。
检查处理任务、抽取内容和检索结果。

看到什么算完成

上传一份可复核的扫描件，检查处理任务、抽取内容和检索结果。

操作限制与风险

这些是租户级处理能力，不是单个知识库抽屉中的独立开关。低清晰度、手写体和复杂版式仍需人工对照原件。

知识服务 Adapter 与连接测试

谨慎操作建议操作人管理员

配置租户使用的知识库 Adapter 地址，并进行连接和服务能力检查。

从哪进入: 管理后台“知识服务”
何时使用: 私有化环境或租户需要指定知识处理服务端点时使用。

按顺序操作

输入经审批的 Adapter 地址。
执行连接测试并检查返回状态。
保存后用小文件完成上传、处理和检索回归。

看到什么算完成

保存后用小文件完成上传、处理和检索回归。

操作限制与风险

更换 Adapter 会影响整个租户的处理和检索链路，应在维护窗口内变更并保留旧配置。

文档搜索、筛选与批量操作

新手必学建议操作人普通业务用户

在文档列表按名称、状态和处理结果筛选，并对选中文档执行界面开放的批量操作。

从哪进入: 知识库详情的文档列表
何时使用: 单个知识库内文档较多，需要按名称和状态批量管理时使用。

按顺序操作

输入文档名称或选择状态筛选。
核对匹配数量和目标文档。
批量操作前再次确认影响范围。

看到什么算完成

批量操作前再次确认影响范围。

文档重命名、替换、重处理与删除

谨慎操作建议操作人负责人 / 管理员

对单篇知识文档管理名称、原文件、处理流程和删除生命周期。

从哪进入: 知识文档操作菜单、文档详情
何时使用: 文档名需要修正，原文更新，处理异常需重试，或文档到期时使用。

按顺序操作

打开文档操作菜单并确认当前版本。
执行重命名、替换原文件或重新处理。
等待新任务就绪后复测检索。
删除前完成备份和确认。

看到什么算完成

等待新任务就绪后复测检索；删除前完成备份和确认。

操作限制与风险

当前删除是不可恢复的物理删除，会同时移除文档和检索索引。

文档详情与分段维护

谨慎操作建议操作人负责人 / 管理员

查看文档信息、分段和权限，并对分段进行搜索、新增、编辑、停用或删除。

从哪进入: 知识文档详情
何时使用: 需要检查实际参与检索的内容，或修正不合适的分段时使用。

按顺序操作

打开已就绪文档。
在分段页查看参与检索的正文。
调整后用原问题重新检索。

看到什么算完成

调整后用原问题重新检索。

操作限制与风险

编辑分段只改变检索内容，不会回写原始文件。

原文预览、处理状态与使用记录

新手必学建议操作人负责人 / 管理员

查看支持在线呈现的原文、当前处理阶段、文档能力和相关操作记录。

从哪进入: 知识文档详情“预览”和“操作记录”
何时使用: 需要核对检索内容是否来自正确原文，或追踪文档处理与使用情况时使用。

按顺序操作

打开文档详情并切换到预览。
对照原文和分段。
检查缺失或错乱。
查看处理和操作记录。
确认最近变更。

看到什么算完成

查看处理和操作记录，确认最近变更。

文档版本比较、恢复与下载

谨慎操作建议操作人负责人 / 管理员

保留不可变的文档版本，支持预览、下载和基于历史版本创建新恢复版本。

从哪进入: 知识文档详情“版本”
何时使用: 替换原文件后需要比较历史，或恢复早期有效内容时使用。

按顺序操作

打开版本列表并对比时间、状态和原文。
需要留档时下载目标版本。
执行恢复后等待新版本就绪。
再进行检索回归。

看到什么算完成

执行恢复后等待新版本就绪，再进行检索回归。

操作限制与风险

恢复不会改写历史版本，而是基于选定版本新建一个版本。

检索与模型

使用固定问题测试召回，并维护检索参数和模型。

全局知识搜索

谨慎操作建议操作人普通业务用户

在授权范围内跨知识库检索，并按相关性展示命中文档和片段。

从哪进入: 知识页“全局搜索”
何时使用: 用户不确定答案位于哪个知识库或文档时使用。

按顺序操作

输入具体问题或关键词。
查看命中知识库、文档和高亮片段。
打开原文核对上下文和来源。

看到什么算完成

打开原文核对上下文和来源。

从搜索结果定位原文或让员工回答

新手必学建议操作人普通业务用户

从命中片段打开文档对应位置，或把当前问题和来源交给已选员工继续回答。

从哪进入: 全局知识搜索结果
何时使用: 用户已找到相关片段，需要阅读完整原文或进一步追问时使用。

按顺序操作

在搜索结果中选择原文定位或员工回答。
检查打开的文档和高亮位置。
进入对话后核对带入的问题和来源范围。

看到什么算完成

进入对话后核对带入的问题和来源范围。

检索测试

进阶操作建议操作人负责人 / 管理员

对单一知识库执行测试检索，展示命中片段、分数和排序结果。

从哪进入: 知识库详情“检索测试”
何时使用: 知识库上线前需要用真实问题验证召回质量时使用。

按顺序操作

输入真实业务问题。
选择检索模式并执行。
检查 Top N 结果、分数和原文，记录缺失或误召回。

看到什么算完成

检查 Top N 结果、分数和原文，记录缺失或误召回。

混合检索、重排与置信度

进阶操作建议操作人普通业务用户

配置全文与向量权重、Top N、置信度和重排策略。

从哪进入: 知识库设置“检索设置”
何时使用: 召回结果过宽、排序不准或需要兼顾关键词与语义时使用。

按顺序操作

记录当前检索测试基线。
调整全文/向量权重、Top N 和置信度。
启用重排后用同一问题复测并比较。

看到什么算完成

启用重排后用同一问题复测并比较。

向量模型与重排模型配置

谨慎操作建议操作人管理员

管理向量模型、重排模型、提供方凭据和连接测试，并同步知识处理配置。

从哪进入: 管理后台知识服务设置
何时使用: 平台需要选择向量化和重排提供方并验证连接时使用。

按顺序操作

选择提供方和目标模型。
填写受保护的连接参数并执行连接测试。
保存后用小型知识库验证处理和检索。

看到什么算完成

保存后用小型知识库验证处理和检索。

操作限制与风险

更换向量模型可能要求全量重建索引；凭据只应由授权管理员维护。

检索设置保存与索引重建

进阶操作建议操作人普通业务用户

保存全文权重、向量权重、召回数量和置信度等参数；只有更换 Embedding 模型时，才需要对全部文档重建索引。

从哪进入: 知识库“检索设置”
何时使用: 需要调整检索效果，或更换 Embedding 模型时使用。

按顺序操作

先保存检索参数并用固定问题复测。
更换 Embedding 模型时确认维护窗口。
在处理任务中跟踪全量重建。
完成后回归检索。

看到什么算完成

在处理任务中跟踪全量重建，完成后回归检索。

操作限制与风险

普通检索参数保存后立即生效，不会触发全量重建；重建期间应避免高频变更。

权限与治理

控制访问权限，跟踪处理任务、审计和生命周期。

知识库与文档细粒度权限

谨慎操作建议操作人负责人 / 管理员

支持知识库权限继承和文档独立权限，以及查看、使用、操作、管理等级和到期时间。

从哪进入: 知识库设置“权限”、文档权限
何时使用: 不同用户、角色、团队或租户需要不同使用范围时使用。

按顺序操作

选择用户、角色、团队或租户主体。
分配权限等级并按需设置到期时间。
保存后用目标主体验证查看、检索和管理操作。

看到什么算完成

保存后用目标主体验证查看、检索和管理操作。

操作限制与风险

文档启用独立权限后，只按文档自身 ACL 判断，不再回退使用知识库 ACL；高权限授权应设置责任人和到期复核。

知识处理任务与错误定位

新手必学建议操作人负责人 / 管理员

按知识库、类型和状态筛选处理任务，并展示阶段、错误和可重试操作。

从哪进入: 知识页“处理任务”
何时使用: 批量导入或索引任务需要查看进度和失败原因时使用。

按顺序操作

进入处理任务并选择状态筛选。
打开失败任务查看文档、阶段和错误。
修正问题后重试。
检查最终就绪状态。

看到什么算完成

修正问题后重试，并检查最终就绪状态。

任务取消、重试、尝试历史与诊断码

谨慎操作建议操作人负责人 / 管理员

对可中止任务执行取消，对可恢复任务重试，并展示每次尝试、诊断码和错误详情。

从哪进入: 处理任务详情
何时使用: 处理任务长时间无进展，或失败后需要精确判断错误阶段时使用。

按顺序操作

打开任务详情并检查当前阶段。
根据诊断码和尝试历史修正原因。
取消或重试后检查新状态和最终文档版本。

看到什么算完成

取消或重试后检查新状态和最终文档版本。

管理员浏览模式

进阶操作建议操作人管理员

以明确的管理员视图浏览知识库和文档，同时对不允许的业务操作给出限制提示。

从哪进入: 知识页管理员浏览提示
何时使用: 管理员需要在不代替业务用户操作的情况下检查知识资产时使用。

按顺序操作

确认页面已显示管理员浏览提示。
仅查看定位问题所需的信息。
需要验证普通用户权限时。
使用实际目标账号重测。

看到什么算完成

需要验证普通用户权限时，使用实际目标账号重测。

操作限制与风险

管理员浏览模式不能作为普通用户可见、可检索或可管理的验收证据。

知识操作审计

谨慎操作建议操作人管理员

记录知识库和文档关键操作，并按主体、动作、对象和时间查询。

从哪进入: 知识页“审计”
何时使用: 负责人或管理员需要追溯创建、授权、导入、设置和生命周期变化时使用。

按顺序操作

进入审计并设置时间或动作筛选。
打开记录查看操作者、对象和变更详情。
按项目要求导出或留存核查结论。

看到什么算完成

按项目要求导出或留存核查结论。

归档、取消归档与生命周期

谨慎操作建议操作人负责人 / 管理员

控制知识库活跃与归档状态，并保留权限、文档和审计记录。

从哪进入: 知识库设置“生命周期”
何时使用: 知识不再日常使用但仍需保留，或归档后需要恢复时使用。

按顺序操作

在设置中确认知识库当前状态。
执行归档并返回列表检查筛选结果。
需要恢复时选择取消归档。
再验证搜索可用性。

看到什么算完成

需要恢复时选择取消归档，再验证搜索可用性。

操作限制与风险

当前正式能力为归档和取消归档，不把尚无服务接口的回收站写入交付范围。

员工调用

创建知识库 MCP 服务，添加给员工并在对话中验证引用。

让数字员工使用知识库

谨慎操作建议操作人管理员

将指定知识库创建为单库 MCP 服务，再从目录添加给目标数字员工，使其可以通过 `knowledge_search` 检索文档并引用来源。

从哪进入: 管理后台“MCP 服务”、员工控制台“配置 → MCP”和工作台
何时使用: 知识库已完成资料上传和检索测试，需要让指定数字员工在对话中检索该库时使用。

按顺序操作

确认知识库内的目标文档为“已就绪”，且“检索测试”能命中正确原文。
进入“管理后台 → MCP 服务”。
点击“新增 MCP 服务 → 添加内置 MCP”。
选择目标知识库。
填写或确认 MCP Server 名称。
点击“保存”。
进入目标员工的控制台。
打开“配置 → MCP”。
确认员工实例已连接。
点击“添加”，在“目录”中搜索刚创建的 MCP Server 名称。
将其添加到该员工。
返回 MCP 服务列表。
确认服务已存在且启用开关已打开。
回到工作台新建话题，向该员工询问文档中的具体问题，展开工具调用记录检查 `knowledge_search`、回答内容和文档来源。

看到什么算完成

目标员工的知识库 MCP 服务已启用；对话中出现 `knowledge_search` 调用，回答与已上传的原文一致并能追溯到正确文档。

操作限制与风险

创建内置 MCP 需要管理员权限；MCP 只添加给具体员工，不会自动扩大知识库 ACL，也不会自动添加给其他员工。文档更新后应等待索引重新就绪，先复测检索，再新建话题验证对话。

知识库 MCP 标识

谨慎操作建议操作人管理员

为单个知识库识别独立 MCP 地址和 Registration ID，用于管理后台注册、员工安装和故障定位。

从哪进入: 知识库详情的 MCP 信息、管理后台 MCP 服务
何时使用: 管理员需要确认某个知识库对应的服务身份，或排查员工绑定错库时使用。

按顺序操作

在知识库信息中核对 MCP 地址和 Registration ID。
在管理后台确认对应的内置 MCP 服务。
对照员工 MCP 列表检查安装对象。

看到什么算完成

对照员工 MCP 列表检查安装对象。

操作限制与风险

MCP 地址和 Registration ID 用于识别服务，不替代知识库权限，也不应作为对外公开链接。

对话中的企业知识引用与实时权限校验

谨慎操作建议操作人负责人 / 管理员

在回答中展示来自知识库的文档和片段来源，并在每次检索时重新校验当前用户权限。

从哪进入: 对话回复的知识来源和工具记录
何时使用: 用户需要确认回答依据，或知识权限在会话期间发生变化时使用。

按顺序操作

展开回答的工具记录和文档来源。
打开原文核对引用片段。
修改授权后用同一目标账号重新发起检索。
检查新权限结果。

看到什么算完成

修改授权后用同一目标账号重新发起检索，检查新权限结果。

操作限制与风险

历史回复是生成当时的记录；权限收回后应通过新检索验证，不应以旧回复判断当前权限。