核心要点：每个Waker都必须显式绑定独立知识库，全局知识库无法复用——这一点至关重要。如果跳过配置步骤，系统将默认使用空上下文或公共语料，业务问答失准只是时间问题。好在QoderWake提供了两种绑定方式：通过控制台单个配置，或使用CLI批量绑定，并附带调试沙盒验证机制，确保隔离准确无误。

每个Waker（数字员工实例）需要挂载专属知识库，以防止知识混用、权限越界或响应混乱。QoderWake不支持全局知识库自动复用，因此每个Waker必须显式绑定独立知识源，否则业务问答将出现偏差。

通过控制台为单个Waker绑定知识库

此方法适用于已创建多个Waker、需要快速为某一特定Waker指定私有文档集合的场景。操作步骤简单直接：

1、登录Qoder CN管理控制台，进入「数字员工管理」页面。

2、在Waker列表中找到目标实例，点击其右侧「知识库配置」按钮。

3、在知识库面板中点击「新增数据源」→ 选择「本地文件上传」或「第三方系统接入」。

4、完成上传或授权后，系统自动生成唯一知识源ID（如kb-7f3a9b2e），并立即关联至当前Waker。

【注意：此操作不会影响其他Waker的知识库配置，但若误选“全部Waker共享”选项（该选项仅存在于旧版UI残留路径），将导致知识污染】

批量为多个Waker分配差异化知识库

当管理5个以上Waker，且需要按岗位、客户或业务线划分知识边界时，手动逐个配置效率低下且易出错。推荐使用CLI工具进行结构化注入，以下两种方法任选其一。

方法一：按Waker ID绑定知识源

1、在终端执行qoder-cli login完成管理员认证。

2、运行命令：
qoder-cli knowledge bind --waker-id wkr-prod-pay-01 --kb-id kb-pay-v3
qoder-cli knowledge bind --waker-id wkr-prod-crm-02 --kb-id kb-crm-q2
qoder-cli knowledge bind --waker-id wkr-dev-test-03 --kb-id kb-test-sandbox

每条命令单独执行，不可合并为一行；【waker-id与kb-id必须全小写、无空格、且已在系统中存在】

方法二：通过CSV批量映射

1、准备mapping.csv文件，内容格式为两列：waker_id,kb_id
wkr-prod-pay-01,kb-pay-v3
wkr-prod-crm-02,kb-crm-q2
wkr-dev-test-03,kb-test-sandbox

2、执行命令：
qoder-cli knowledge batch-bind --csv ./mapping.csv

该命令会逐一校验每一行ID是否存在，任何一条失败则整批回滚，不写入任何绑定关系，有效避免部分绑定成功导致的混乱。

验证知识库是否正确分配

绑定完成后务必验证，以确认Waker已正确加载目标知识库。验证步骤至关重要，不可省略。

第一步：触发测试查询

在Qoder CN控制台中，打开目标Waker的「调试沙盒」，输入典型业务问题，例如：“支付网关超时重试次数是多少？”

第二步：检查响应溯源

查看返回结果底部的[来源：kb-pay-v3 §3.2.1]标记——括号内知识源ID必须与您绑定的一致，章节编号应指向原始文档真实位置。

第三步：对比未绑定Waker的响应

用相同问题向另一个Waker（如wkr-prod-crm-02）提问，若返回“未找到相关信息”或引用错误知识源ID，则证明隔离生效。此步骤可确认知识库是否真正独立运作。