Waker 管理

本章说明如何创建和配置 Waker；群聊答疑专员的专项配置集中在本章末尾。

​

Waker 管理列表

入口： 左侧主导航 →「Waker 管理」。 页面以卡片展示 Waker 的名称、简介、运行环境、在线状态和任务入口。

可切换「我的Wakers / 我的群组」，并按状态、环境或名称筛选；没有结果时先清空筛选条件。 发起任务前确认本机/远端标记和在线状态，不要仅凭名称判断执行位置。

​

创建 Waker

创建时选择角色模板并填写基本信息；项目、技能和连接器可在创建后配置。

​

使用预置角色模板创建

入口： Waker 管理 → 右上角「新建Waker」。

操作步骤：

1. 选择最接近目标职责的模板。
2. 填写名称、头像和简介；简介写清职责、输入、输出和边界。
3. 页面显示运行环境时，选择具备所需项目和依赖的设备。
4. 点击「保存并启用」。

完成判断：

• 新 Waker 出现在管理列表中，名称、简介和运行环境正确。
• 进入详情页后可以看到配置菜单。

模板可能带入默认能力。创建后进入详情页核对并补充配置。

​

创建自定义角色模板

适用场景： 预置角色不符合长期职责，需要保存可复用的角色配置。 入口： 「新建Waker」窗口 →「自定义角色」。 操作步骤：

1. 填写角色名称、描述和头像。
2. 配置核心职责（IDENTITY.md）、工作风格（PERSONA.md）和工作规范（BIBLE.md）。
3. 按需选择 Skill 或 MCP；凭据只通过安全授权入口配置。
4. 保存模板，返回角色列表选择该模板，再创建 Waker。

完成判断： 自定义模板出现在角色列表中；用它创建的 Waker 已带入角色上下文和所选能力。修改模板不会自动更新既有 Waker。

​

查看 Waker 详情并选择配置项

入口： Waker 管理 → 点击目标 Waker 卡片。

先确认页面显示的是目标 Waker，再根据要完成的操作选择左侧菜单：

群聊答疑专员用户：该角色还会出现「答疑记录」「专家配置」等专用入口；知识库和群聊能力也可能受功能开关控制。

普通 Waker 的 IM 渠道新增、配对审批和全局配置在主导航「IM」中完成。群聊答疑专员统一在 Waker 首页的快速配置中完成机器人和群聊接入；应按最小范围配置并先在测试群验证。

​

查看状态并维护基础信息

1. 进入 Waker 详情 →「首页」，核对名称、ID、本机/远端标记和在线状态。
2. 点击「编辑」修改名称、头像或简介；简介应写清职责、输入、输出和边界。
3. 保存后回到首页和管理列表确认展示已更新。

完成判断： 页面显示目标 Waker，状态与实际环境一致，修改已经保存。

​

分享、导出和导入 Waker

分享会生成一个可撤回的链接，不会下载本地文件。可在 Waker 管理卡片中点击「更多操作」→「分享」，也可以在 Waker 首页右上角点击分享图标。 生成分享链接

1. 选择分享内容。基础名片和「关于我」必须包含；Skill、连接器配置、自动任务配置和项目历史按需选择。
2. 设置有效期（1、3、7 或 30 天）和使用次数（仅一次或不限次数），点击「下一步」。
3. 阅读风险提示并勾选确认，点击「开始导出」，复制生成的链接。需要再次复制或提前撤回时，在 Waker 管理页点击「导出记录」。

通过分享链接导入

1. 进入「Waker 管理」，点击「导入 Waker」。
2. 粘贴完整分享链接或 shareId，点击「导入」。
3. 导入完成后打开新建的 Waker，检查角色、Skill、项目、连接器和自动任务。导入不会覆盖现有 Waker，名称可能与已有 Waker 相同。

导入后检查： 连接器凭据不会随链接迁移；导入的 Skill、连接器和自动任务默认停用，补充授权并验证后再启用。Memory、权限、会话和自动任务运行记录也不会迁移。 分享或删除前检查私密项目、自动任务、连接器以及流程、群组和 IM 引用；删除前先暂停外部触发。

​

配置可复用工作上下文

项目用于保存可复用的工作上下文。「公开项目」可供多个 Waker 使用；Waker 详情中的私密项目仅供当前 Waker 使用。

1. 根据使用范围选择公开项目或私密项目入口。
2. 填写名称和简介，添加工作路径。
3. 确认设备和环境正确后保存，并在目标 Waker 中选择该项目。

完成判断： 公开项目出现在公开项目列表中，私密项目出现在目标 Waker 的「项目」页；两者都能在对应 Waker 或 Chat 的工作区选择器中找到。 使用项目时，在 Waker 详情 →「项目」中选择或创建项目；发起任务时再次选中，并先用只读任务验证路径。创建项目后不会自动用于后续任务。

​

配置权限

入口： Waker 详情 →「权限」。 权限页当前包含：

• 工具防护
• 文件防护
• 内置工具
• 模型安全

推荐配置顺序：

1. 先明确 Waker 的职责和必须执行的操作。
2. 在文件防护中只开放任务需要的目录范围。
3. 在工具防护和内置工具中只保留必要工具。
4. 在模型安全中按组织要求配置可用范围。
5. 保存后执行只读测试任务。
6. 再执行一次需要授权的操作，确认高风险动作会被阻止或请求用户确认。

完成判断： 普通授权范围内的任务可以完成；越界访问、高风险工具或受限操作会按规则阻止或要求确认。

生产目录、敏感数据和外部写入操作应采用最小权限。遇到任务失败时，不要先关闭所有防护；应根据失败提示补充完成任务所需的最小权限。

​

群聊答疑专员

群聊答疑专员会结合已绑定知识、群聊上下文和已确认口径回答问题；无法确定时可向专家求助。

建议按“创建群聊答疑专员 → 配置机器人 → 接入测试群 → 补充知识库和专家 → 完善基础设置和回复设置 → 验证与查看记录”的顺序完成；上线后继续通过答疑记录检查运行状态。 先在测试群完成验收，再逐步扩大使用范围。

​

创建群聊答疑专员

1. 进入「Waker 管理」→「新建 Waker」，选择「群聊答疑专员」。
2. 填写名称，按需调整模板带入的头像和简介，并选择运行环境。
3. 点击「保存并启用」。创建成功页会展示专员的核心能力，并提供「稍后配置」和「去完成配置」。
4. 点击「去完成配置」，进入“配置机器人 → 接入群聊 → 其他设置（可选）”三步快速上手。

创建成功不代表已经可以在群内答疑；至少完成机器人和一个测试群的配对后，再进行问答验证。

​

配置群聊机器人并接入群聊

快速上手分为“配置机器人、接入群聊、其他设置（可选）”三步。机器人与至少一个群聊是开始服务的必要条件；知识库、专家和回复要求用于提升答案质量，其中“其他设置”可以稍后补充。

1. 在快速上手第 1 步点击「添加机器人」，可直接打开机器人管理后台或查看配置文档。
2. 在钉钉创建群聊机器人，将消息接收模式设为 Stream，并在「安全设置」中删除白名单里的默认 1.1.1.1。
3. 复制 AppKey 和 AppSecret；回到 QoderWake 填写机器人展示名称和凭证。展示名称只用于 QoderWake，建议与钉钉中的真实名称一致。
4. 准入策略保持「配对模式 / Approval Required」。保存后确认状态为“已连接”且开关已启用。
5. 进入第 2 步，将机器人加入测试群并在群内 @机器人；回到「配对申请」，核对来源、会话名称和类型后通过申请。
6. 也可使用「手动配对」：在 IM「添加配对」中选择渠道和响应 Waker。手动搜索会话要求 DWS 版本可用；或生成 10 分钟有效的配对码并发送到目标会话。

完成判断：机器人显示“已连接”且渠道已启用；“已配置群聊”表格中能看到机器人、响应 Waker、群聊名称和状态；至少一个测试群配对成功，群内 @机器人后消息能够进入答疑流程。

​

补充知识库

1. 进入快速上手第 3 步，或打开群聊答疑专员详情 →「知识库」→「绑定知识库」。
2. 从「我创建的 / 共享的 / 精选」选择已有知识库；也可以切换到「新建并绑定」，填写名称后直接创建。
3. 新建后点击「添加资料」。可上传小于 500 MB 的常见文档、表格、演示、文本或图片，也可粘贴一个或多个网页链接。
4. 等待资料处理完成，再回到 Waker 知识库页确认状态为“已连接”并核对资料数量。

知识库页用于绑定和解绑；快速上手中的“已添加的知识库”会显示名称、资料数量和更新时间，并可直接“添加资料”。解绑只会停止该专员使用知识库，不会删除知识库及其中资料。 完成判断：知识内问题可以依据资料回答；资料不足时不会把猜测当作已确认事实。

​

配置专家

1. 先接入至少一个可用群聊，再进入快速上手第 3 步「专家配置」或 Waker 详情 →「专家配置」。
2. 点击「添加专家」，选择 IM 渠道和机器人。专家将通过所选机器人接收求助并参与纠错，不同机器人需分别配置。
3. 按渠道能力选择搜索添加或手动添加；阿里钉使用手动添加，填写专家工号和昵称。钉钉机器人还需开通单聊权限。
4. 选定专家后添加简短的「专业标签」，并确认启用、可被求助和可确认答案等协作设置。

专家用于处理专员不确定的问题；专家在群内纠正答案后，系统还可通过私聊请其确认并修正知识。专家列表会显示专家、IM 渠道和专业标签；移除专家只会停止向该专家求助。

​

完善基础设置和回复设置

进入群聊答疑专员详情 →「设置」。设置页包含「基本设置」和「回复设置」两个页签，应先明确专员是谁、按什么原则答题，再规定输出方式。 在「基本设置 → 身份」中核对称谓、头像和主要职责；名称、头像和主要职责可以修改，简介由角色模板提供，仅供查看。 在「基本设置 → 人设」中编辑语气、详略、是否使用 Markdown、如何处理不确定问题等行为要求。编辑框支持 Markdown，保存后会作为该专员持续遵守的人设。 在「基本设置 → 设定集」中分别维护“敏感边界、答题依据、额外补充”：敏感边界规定不能披露的内容，答题依据规定优先使用哪些证据，额外补充用于加入团队特有口径。三个区域需分别保存。 切换到「回复设置」：回复风格可选“专业稳妥 / 简洁直接 / 活泼轻快”；回复语言可选择跟随用户提问、中文或 English。继续填写业务范围说明、敏感信息处理和回答内容格式，并按需开启 11 位手机号、6 位及以上数字工号、邮箱的发送前隐藏规则；确认后点击「保存更改」。 修改回复设置后，只有点击「保存更改」才会生效；需要放弃本次编辑时使用「重置」。回答内容格式最多 1000 字，应写成可执行的回复规则，不要把测试账号、密钥或真实敏感信息填入示例。 在已配对的测试群中依次验证知识内问题、知识外问题、敏感问题和超出业务范围的问题。

知识内问题应依据已绑定资料回答；证据不足时应说明不确定或发起专家协助；敏感内容应按设置拒答或脱敏。

完成判断：回答语气和语言符合设置，已知问题引用当前口径，未知和越界问题不会被当作已确认事实回答。

​

查看答疑记录并持续优化

进入群聊答疑专员详情 →「答疑记录」。顶部可按“全部记录 / 处理中 / 已处理 / 专家协助 / 失败”筛选，也可搜索提问、群聊或单聊、状态和用户；左侧选择群聊，右侧查看所选记录的处理详情。

选择群聊和具体记录，查看原始问题、处理状态、回复详情、专家协作或失败原因；修正知识或设置后，用同类问题再次验证。 定期抽查失败、未回复和专家协助记录，按机器人连接、群聊配对、知识检索或专家链路定位问题。

​

验证配置是否生效

1. 打开群聊答疑专员「首页」，在「快速配置」卡片中确认「配置机器人」和「接入群聊」均为“已完成”。「其他设置（可选）」可以稍后补充。
2. 如有未完成项，点击「去配置」。机器人未完成时，检查凭证、连接状态和启用开关；群聊未完成时，重新完成配对，直至状态显示“已配对”。
3. 在测试群 @机器人发送一条已知问题，然后进入「答疑记录」。确认能够看到原问题、处理状态和回复内容。

​

更新或移除配置

修改后验证：回到测试群，至少验证一条已知问题和一条未知问题；再到「答疑记录」确认消息已收到、回答符合预期。

​

上线前验收

• 基础配置：机器人显示“已连接”且已启用，至少一个测试群显示“已配对”。
• 消息验证：从测试群发送消息后，能够在「答疑记录」中找到该消息并查看处理结果。
• 回复设置：身份、人设、回复语言、业务范围和敏感信息处理规则均已保存。
• 知识库（按需）：已绑定包含有效资料的知识库，并用一条知识内问题验证回答。
• 专家协助（按需）：专家、IM 渠道、专业标签和单聊权限配置正确，并用一条未知问题验证求助流程。
• 上线范围：先在小范围群聊试用并抽查答案质量，再逐步扩大使用范围。