QoderWake数字员工需挂载私有知识库才能理解内部文档，支持三种方式：一、控制台上传本地文件（≤500页/200MB）；二、Connector接入Confluence等第三方系统实现同步；三、CLI工具批量注入结构化文档并支持标签检索；四、通过测试查询验证挂载效果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望QoderWake数字员工能准确理解并调用您组织内部的私有知识，例如技术文档、产品手册或流程规范，则必须将这些本地文档挂载至其知识库。以下是完成知识库挂载的具体操作路径：
一、通过QoderWake控制台上传文档
该方式适用于中小规模文档集合（单次上传≤500页，总容量≤200MB），系统自动执行文本提取、分块与向量化，确保语义检索准确性。
1、登录QoderWake官网控制台，进入「数字员工管理」页面。
2、选择目标数字员工实例，点击右侧「知识库配置」按钮。
3、在知识库面板中点击「新增数据源」，选择「本地文件上传」选项。
4、拖入PDF、Markdown、Word（.docx）、纯文本（.txt）格式文件，支持批量上传。
5、上传完成后，系统自动启动解析流程；状态栏显示“已就绪”即表示文档已嵌入向量索引，可即时响应相关提问。
二、通过Connector接入企业知识库系统
该方式适用于已部署Confluence、Notion、语雀、钉钉文档或自建Wiki的企业，实现知识变更实时同步，避免手动更新滞后。
1、在「知识库配置」页面点击「新增数据源」，选择「第三方系统接入」。
2、从列表中选择对应平台（如Confluence），点击「授权连接」。
3、按提示跳转至目标系统完成OAuth 2.0授权，授予QoderWake读取指定空间/知识库的权限。
4、勾选需同步的文档空间或标签分类，设置更新频率为“实时监听”或“每小时同步”。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
5、点击「启用同步」，状态栏显示“已连接并同步中”即表示挂载成功。
三、使用CLI工具批量注入结构化文档
该方式适用于研发团队需将API文档、数据库Schema、YAML配置说明等机器可读内容注入知识库，支持元数据标注与字段级检索。
1、在终端执行qoder-cli login，使用管理员账号完成本地认证。
2、运行命令qoder-cli knowledge ingest --source ./docs/api/ --format openapi3 --tag "backend-api-v2"，指定文档路径、格式及业务标签。
3、CLI自动校验文档有效性，对OpenAPI 3.0文件提取端点、参数、响应示例并生成语义锚点。
4、执行完成后返回提示：“37个端点已注册，关联标签 backend-api-v2 生效”。
5、在数字员工对话中提及“backend-api-v2”，即可触发限定范围的知识召回。
四、验证知识挂载效果
该步骤用于确认文档内容已被正确解析与索引，排除格式兼容性或权限配置问题。
1、在控制台「知识库配置」页面，点击目标数据源右侧的「测试查询」按钮。
2、输入典型业务问题，例如“支付回调超时重试机制如何配置？”。
3、观察返回结果是否包含来自已上传文档的精确段落，并标注来源文件名与页码（PDF）或标题（Markdown）。
4、若返回空或无关内容，点击「查看检索日志」，检查是否出现“无匹配分块”或“权限拒绝访问原始文件”提示。
