将本地技术文档、产品手册或流程规范成功挂载至QoderWake知识库后，数字员工能否准确理解并调用这些私有内容，是决定后续基于知识的问答、根因分析或代码补全是否正常工作的核心前提。以下三步验证方法，可确保知识库真正生效，避免返回空结果或出现幻觉响应。
在控制台发起测试查询
这是最直接、无需额外工具的验证方式，适用于所有上传或接入方式（本地文件、Confluence、CLI注入）。
- 登录QoderWake正式控制台，进入「数字员工管理」→ 选择目标实例 → 点击「知识库配置」。
- 在知识库面板右上角，点击「测试查询」按钮。
- 输入一个明确指向已上传文档中特有术语或段落的问句，例如：“支付网关超时重试策略中最大重试次数是多少？”——该问题必须能在原始文档中找到唯一、具体的答案，不能是泛泛而问。
- 点击发送，观察返回结果：若首条回答包含原文摘录、页码或章节引用（如“见《支付模块规范_v2.3》第5.2节”），且答案与文档一致，则表示知识库已成功生效；若返回“未找到相关信息”或给出编造内容，说明挂载失败或文档未被正确解析。
小提示：如果测试时发现答案不准确，可检查知识库中的文档格式是否被正确解析（如PDF中的表格、图片文字需额外处理）。
通过qoder-cli执行命令行验证
该方法绕过图形界面，直接调用底层检索服务，适合CI/CD集成或批量验证多个知识库。
方法一：基础语义检索测试
在终端执行：qoder-cli knowledge query --query "幂等键生成规则"
方法二：带来源锚点的精准验证
运行：qoder-cli knowledge query --query "订单状态机流转条件" --with-source，输出中应包含匹配文档名、块ID及置信度分数。
注意：必须先完成qoder-cli login认证，否则命令将拒绝执行并提示401错误。
常见问题：CLI返回“未找到匹配文档”时，应如何排查？
答：首先确认知识库已正确挂载，可使用qoder-cli knowledge list查看已挂载的库列表；其次检查文档解析是否成功，若文档为扫描件或图片，需先转换为可索引文本。
用实际业务场景触发数字员工行为
真实任务流是最严苛的测试——只有当知识真正融入决策链路，才算完全生效。
- 第一步：在已接入的代码仓库中创建一个issue，标题为“【知识库验证】订单创建失败时缺少幂等校验”，描述中引用你刚挂载文档里的原句：“幂等键必须包含tenant_id+order_no+timestamp”。
- 第二步：等待30秒，检查QoderWake是否自动生成PR，并在diff注释中写出：“依据《支付模块规范_v2.3》第4.1节，补全IdempotentKeyGenerator.validate()对timestamp字段的非空校验”。
- 第三步：打开该PR的评论区，确认QoderWake回复中引用了知识库文档的精确段落，而非通用建议。
小提示：如果数字员工未自动生成PR，请检查是否已为目标代码仓库开启了“知识库辅助代码补全”功能，且issue标签与被监控的触发器匹配。
通过以上三步——控制台测试、CLI验证、实际业务触发，即可全面确认数字员工对私有知识库的调用准确性与完整性。建议在每次知识库更新后，至少执行一次流程验证，确保新文档内容被正确索引并生效。