必须绑定知识库，否则waker只能基于通用模型作答；创建时同步绑定可一步到位，创建后可通过控制台或cli追加绑定，并需验证retrieval_score＞0.75且响应含原文引用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让QoderWake创建的Waker（数字员工）能准确调用内部文档、SOP或产品手册等私有知识，就必须在创建过程中或创建后立即绑定对应的知识库——不绑定，Waker只会基于通用模型作答，无法回答“我们公司报销流程第3步要找谁签字”这类问题。
创建Waker时同步绑定知识库
该方式适用于新员工从零构建，可在初始化阶段一步到位，避免后续手动挂载遗漏。
1、进入QoderWake管理后台 → 点击左侧「我的员工」→「新建模板」→ 选择「后端工程师」「客服专员」等预置角色，或点击「自定义创建」。
2、填写基础信息（姓名、岗位、部门）后，向下滚动到「知识接入」区域 → 点击「绑定知识库」按钮。
3、弹窗中选择「已有知识库」→ 在下拉列表中勾选目标知识库（如“支付模块知识库”或“反洗钱合规知识集”）→ 若列表为空，请先返回「知识管理」完成创建。
4、勾选「启用实时同步」开关 → 这确保Waker后续能感知知识库内容更新，例如文档修订后无需重新部署Waker。
【必须确认知识库状态为“已就绪”】——若显示“解析中”或“同步失败”，Waker将加载空上下文，首次提问必返回泛化答案。
Waker创建完成后追加绑定
适用于已上线但未挂载知识库的Waker，或需临时切换知识源的调试场景。
方法一：控制台图形界面绑定
1、在「我的员工」列表中找到目标Waker → 点击右侧「配置」图标（齿轮）→ 进入「知识库配置」页。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
2、点击「新增数据源」→ 选择「本地文件上传」或「第三方系统接入」→ 按向导完成文档导入或Confluence/钉钉文档授权。
3、上传或接入成功后，页面自动刷新，状态栏显示“✅ 已嵌入向量索引”，此时Waker即可响应相关提问。
方法二：CLI命令行强制挂载（适合批量操作）
在终端执行：qodercli waker attach --id wkr-7a8b9c --kb kb-3x4y5z → 其中wkr-7a8b9c为Waker唯一ID，kb-3x4y5z为知识库ID，ID均可在控制台URL路径中直接复制。
这一步操作起来很简单，直接把命令粘贴进终端回车就行。但注意：若ID输错，系统不会报错，而是静默忽略，Waker仍无知识可用。
验证绑定是否生效
绑定不是终点，必须验证Waker能否真正读取并理解知识内容。
第一步：在Waker对话框输入一个明确来自知识库的短句提问，例如“故障复盘记录里提到的三次重试机制适用哪些接口？”
第二步：观察响应中是否出现原文引用、章节标题或具体条款编号——若只回复“我需要更多信息”或泛泛而谈，说明绑定未生效或知识块未被正确分段。
第三步：打开Waker的「调试日志」面板 → 查看最近一次查询的retrieval_score值，高于0.75才表示知识片段被有效召回；低于0.6则需检查文档格式（扫描版PDF不可读）、分块策略或关键词匹配度。
