qoderwake执行任务时必须显式启用知识库检索，否则仅使用通用模型；需确认知识库已挂载并显示“已连接并同步中”，cli提交需带--knowledge-id和--retrieval-enabled=true参数，桌面端需勾选「启用知识库检索」并选择对应知识源。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让QoderWake在执行任务时能实时调用你公司内部的Confluence文档、钉钉知识库或Notion空间里的最新政策、接口规范、SOP流程——这要求任务提交时明确告知Agent“本次推理必须基于已挂载的知识库”，否则它默认只使用内置通用语料。
确认知识库已成功挂载
进入QoderWake控制台 →「知识库配置」→ 查看状态栏是否显示“已连接并同步中”。若显示“待授权”或“同步失败”，说明挂载未完成，后续所有任务都无法命中本地知识。
【未完成此步时提交的任务将完全忽略你的私有文档，仅依赖云端通用模型】
在CLI中提交带知识库约束的任务
方法一：显式指定知识库ID并启用检索增强
1、执行qoderwake submit命令，必须携带--knowledge-id参数，值为你在「知识库配置」中看到的唯一标识（如kb-confluence-prod-7a3f）。
2、添加--retrieval-enabled=true开关，强制Agent在生成前先向该知识库发起语义检索，而非仅靠缓存摘要。
3、输入完整指令示例：qoderwake submit --event-type=document-review --target-context="git:org/repo:main:docs/api-spec.md" --knowledge-id=kb-confluence-prod-7a3f --retrieval-enabled=true。
这一步必须做，否则即使知识库已挂载，Agent也不会主动查询——它默认走无上下文推理路径。
在QoderWork桌面端发送任务
第一步：打开QoderWork客户端，确保左下角状态栏显示“知识库已就绪”图标（蓝色书本+绿色对勾）。
第二步：点击新建任务按钮 → 在任务描述框中输入自然语言指令，例如：“对照《2026版API安全规范》检查pr-892中的token鉴权逻辑”。
第三步：在右侧高级选项面板中，手动勾选「启用知识库检索」，并从下拉菜单选择对应知识源（如“钉钉文档-安全中心”）。
第四步：点击提交。系统会在任务卡片右上角自动标记【KB】图标，表示本次执行已绑定知识库上下文。
