为已有qoderwake数字员工挂载知识库有三种方式：控制台上传（支持pdf/markdown等格式，单文件≤5mb）、cli工具批量注入（需绝对路径，可打标签如“finance”）、connector接入钉钉文档（依赖mcp协议，首次同步需10–30分钟）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你已创建好QoderWake数字员工（Waker），现在需要为其补充内部业务知识，让它能准确回答“报销流程怎么走”“接口超时如何重试”这类具体问题。这一步不是重新建Waker，而是向已有实例注入结构化文档内容，操作路径清晰但有硬性约束——文件格式、编码、大小任一不满足都会导致上传静默失败。
通过控制台为已有Waker挂载知识库
这是最常用的方式，适合中小规模文档（单次≤500页/200MB），系统自动完成解析、分块与向量化。
1、登录QoderWake官网控制台，进入「数字员工管理」页面。
2、在列表中找到目标Waker，点击其右侧的「知识库配置」按钮。
3、在知识库面板中点击「新增数据源」→ 选择「本地文件上传」。
4、拖入PDF、Markdown、Word（.docx）、纯文本（.txt）格式文件；支持批量上传，但【单个文件不得超过5 MB】，否则会被前端直接拦截且无错误提示。
5、上传完成后，状态栏显示“解析中”→“构建索引”→最终变为“已就绪”，此时该Waker即可基于新知识响应提问。
用CLI工具批量注入并打标签
当文档量大、需按岗位或模块精细分类时，控制台上传不够灵活。CLI方式支持结构化注入、自定义标签、跳过重复文件校验，适合运维、研发等高频更新场景。
方法一：基础注入
1、确保已安装Qoder CLI（v2.6.0+），并在Waker所在机器执行：qoder knowledge inject --waker-id WAKER-XXXXX --path ./docs/
2、【路径必须为绝对路径，相对路径会导致扫描失败】，例如/home/user/kb/payroll/而非./payroll/。
方法二：带标签注入
1、在待注入文件夹内新建.qoder-tags.yaml，写入：
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
tags: ["finance", "reimbursement-v2.3"]
2、执行命令：qoder knowledge inject --waker-id WAKER-XXXXX --path /full/path/to/docs/ --with-tags
3、注入完成后，可在控制台该Waker的知识库详情页看到对应标签，后续问答可限定范围，如“只查reimbursement-v2.3相关流程”。
通过Connector接入钉钉文档知识库
若企业知识已沉淀在钉钉文档中，无需下载再上传，直接打通实时同步链路。此方式依赖MCP协议，需提前完成凭证配置。
第一步：确认前置条件已就绪
1、检查钉钉开放平台中该企业应用是否已开通「文档管理」权限，并获取Client ID与Client Secret；
2、确认钉钉MCP Server已在后台部署并运行，且环境变量中已注入上述凭证；
3、在QoderWake控制台中，已配置名为dingtalk-docs-mcp的MCP连接器，且测试连通状态为✅。
第二步：绑定钉钉知识库空间
1、进入目标Waker的「知识库配置」→「新增数据源」→ 选择「MCP Connector」；
2、在下拉菜单中选择已就绪的dingtalk-docs-mcp连接器；
3、点击「空间选择」，勾选需同步的钉钉文档知识库空间（如“财务制度中心”“研发规范库”）；
4、点击「启用同步」，系统立即拉取文档元数据，【首次同步需10–30分钟，期间不可中断网络】，完成后状态栏显示“同步完成（N篇文档）”。
