Skip to main content
能力扩展

@Waker

将多个 Waker 接入群聊或单聊,让它们按任务智能分工并持续沉淀工作上下文。

@Waker 把团队讨论直接变成可执行任务:它会参考群聊或单聊的近期上下文,自动选择合适的 Waker,并把进度、结果和文件送回原会话。 群里只需保留一个统一入口,成员不用搬运聊天记录、添加多个机器人或判断该找谁;同一任务可以持续修改和跟进,不同任务也能交给不同专业 Waker 并行处理。 开启 @Waker 后,团队可以:
  • 在原群接住工作:无需反复搬运聊天背景、附件和已经确认的约束。
  • 用一个入口连接多位专业 Waker:项目协调、研发、测试或运营各自负责擅长的工作,系统按职责和路由规则分派任务。
  • 持续推进同一项任务:第一版完成后可以继续补充、修改或查询进度,不必每次从头说明。
  • 同时处理不同任务:彼此独立的任务可以分别交给不同 Waker,结果仍回到团队正在使用的会话。
  • 沉淀可复用的工作上下文:任务、话题和群聊记忆保留已经形成的结论与协作习惯,并按会话隔离。
例如,在研发群中,可以先让项目协调拆分需求,同时让研发执行定位构建失败,再让测试验收补充用例;涉及代码合并、生产变更或对外发布时,Waker 可以先返回方案和风险,等待人确认后再继续。
@Waker 背后的 Router 会调用 Qwen3.7 识别任务意图并选择响应 Waker,因此每次触发路由都会产生相应的模型额度消耗。
第一次体验时,选择一项已经在群里讨论过、需要交付具体结果且后续可能继续修改的工作,最容易看出 @Waker 与普通问答机器人的区别。
《@Waker》页面
@Waker 会话 中开通、查找和管理已接入的会话。

准备 Waker

开始前确认:
  • 至少有一个已启用且可运行的 Waker。多个 Waker 的名称和职责应清楚区分,便于系统正确分派任务。
  • 已确定各 Waker 可以访问的工作目录,以及是否允许成员通过 IM 修改 Waker 配置。

配置和维护 IM 连接

进入主导航 IM,选择 IM 连接。这里管理 QoderWake 用于接收和回复消息的渠道身份。当前支持以下连接类型;账号、版本或功能配置不同,页面实际显示的类型可能有所不同。

支持的连接类型

连接类型使用方式支持 @Waker
钉钉机器人通过机器人身份接收和回复消息。支持
钉钉用户通过已登录用户账号接收群聊和单聊消息,回复以该账号身份发出。支持
飞书机器人通过飞书机器人接收和回复消息。支持
微信扫码连接微信账号,通过微信机器人接收和回复消息。暂不支持
企业微信通过企业微信群机器人接收和回复群消息。暂不支持
QQ 机器人接收 QQ 单聊消息和群聊中的 @ 消息。暂不支持

添加连接

  1. IM 连接 中选择页面提供的连接类型,然后单击添加或配置。
  2. 按弹窗完成授权:机器人或 AI 助理通常需要填写对应平台的应用凭据;支持扫码的渠道按页面提示扫码确认。
  3. 如果页面提供准入策略,按使用范围选择:
    • 配对模式:新会话通过审核后才能接入,适合需要控制使用范围的场景。
    • 开放模式:符合条件的会话可以直接使用。仅在明确了解开放范围时启用;并非所有渠道都提供该选项。
  4. 如果页面提供回复样式、过程消息或默认回复设置,根据接收方体验选择。不同渠道提供的配置项可能不同。
  5. 保存后返回列表,确认连接处于可用或 已连接 状态。
除在 QoderWake 中完成配置外,机器人和 AI 助理还需要在对应 IM 平台完成身份创建、消息权限或事件接收配置,并加入目标会话。钉钉用户以本人身份代发回复,只接入确实需要自动响应的会话,并在启用前确认 AI 回复标识和人工审核责任。
不要在截图、任务、文档或日志中展示 AppSecret、App Secret、Secret Key、Token 等凭据。请在 IM 平台中按最小权限配置消息范围和安全策略。

编辑、停用或删除连接

IM 连接 列表中:
  • 单击编辑图标可修改凭据以及该渠道提供的消息处理和默认回复设置。
  • 关闭连接开关会停止接收和回复消息,但保留连接配置;重新开启后再用测试会话验证。
  • 删除机器人或 AI 助理连接会立即停止消息处理,已有会话可能保留为 已失效。重新添加同一身份后,检查会话是否恢复为 已暂停,并手动启用。
  • 删除个人账号连接会停止代发,并清除该连接的会话监控。删除前先确认没有仍在使用的会话。

开通 @Waker

会话可以通过主动开通、群内申请审批或配对码三种方式接入。不同 IM 渠道提供的方式可能不同,以页面实际选项为准。

方法一:从 @Waker 会话主动开通

进入主导航 IM,在 @Waker 会话 中单击 开通 @Waker。开通过程分为两步。

选择 IM 连接

  1. 选择用于接收和回复消息的 IM 连接。
  2. 如果列表中没有需要的身份,单击 添加更多连接,按页面要求完成授权或填写机器人凭据。
  3. 确认连接处于可用状态,然后单击 下一步
一个连接可以用于多个会话。不要重复添加同一身份;需要调整凭据、启停状态或连接参数时,在 IM 连接 中维护原连接。

接入会话并配置响应 Waker

  1. 选择 单聊群聊,搜索并选择要接入的会话。
  2. 响应 Waker 中选择一个或多个 Waker。
  3. 将最适合处理通用请求的 Waker 设为默认。用户没有指定角色、路由规则也没有明确命中时,由默认 Waker 响应。
  4. 逐个选择已添加的 Waker,并配置以下项目:
    • 响应模型:只应用于当前 Waker。
    • 允许修改 Waker 配置:开启后,成员可以通过 IM 消息修改该 Waker 的配置;没有明确需要时保持关闭。
    • 会话文件防护:开启后,只允许访问工作目录及已添加目录中的文件,并阻止访问范围外的文件和命令。
    • 工作目录:选择执行任务时使用的目录;需要额外访问范围时单击 添加目录
  5. 根据团队分工填写 自定义路由规则。规则对当前会话中的全部响应 Waker 生效,并优先用于判断新任务由谁执行。例如:
    需求分析、PRD 和发布沟通交给产品经理;接口、服务端代码和 CI/CD 交给后端工程师;页面和交互实现交给前端工程师。
    
  6. 检查会话、默认 Waker、模型、权限和目录后,单击 开通 @Waker
配置会话和响应 Waker
选择会话和响应 Waker,并为每个 Waker 设置默认角色、模型与权限。
@Waker 暂不支持新添加群组或群聊答疑专员作为响应对象;已有的会话连接仍可查看和编辑。群聊答疑专员的创建和配置流程仍在 Waker 管理页面中完成。

方法二:在群内 @ 机器人后审批

使用配对模式的机器人可以由群成员主动发起申请,再由管理员审批:
  1. 确认机器人连接处于可用状态,并将机器人加入要接入的群聊。
  2. 群成员在群内 @ 机器人并发送一条消息。尚未配对时,机器人会提示申请已经提交。
  3. 回到 QoderWake,进入 IM@Waker 会话,单击页面右上角的 待处理
  4. 核对机器人、会话名称、会话类型和申请人,选择响应 Waker,并检查默认 Waker、模型、工作目录和权限。
  5. 确认来源可信且配置无误后单击 允许。审批通过后,触发申请的消息会分配给所选 Waker;在已开通列表中确认会话状态为 活跃
来源不明或不应接入的申请应选择 忽略。被忽略后,只有群成员再次发送消息,页面才会出现新的配对申请。

方法三:通过配对码接入

页面提供配对码时,可以先在 QoderWake 中指定响应配置,再由目标会话完成配对:
  1. @Waker 会话 中单击添加或开通入口,选择 IM 连接和响应 Waker。
  2. 在添加方式中选择 通过配对码添加生成配对码,并检查模型、工作目录等配置。
  3. 复制页面生成的完整配对码消息,在 10 分钟内发送到需要接入的群聊或单聊。不要只转发截图,也不要发到无关会话。
  4. 会话收到“配对成功”提示后,回到 @Waker 会话,确认会话已经出现且状态正常。
配对码在成功使用后即失效,超过 10 分钟也会过期。失效或过期时重新生成,不要继续转发旧配对码。

在会话中使用 @Waker

开通后,在 已开通的 @Waker 列表中确认目标会话状态为 活跃,并打开该会话的 @Waker 觉醒 开关。 在 IM 会话中按以下方式发起工作:
  • 直接描述目标、范围和期望结果,系统会选择与任务最匹配的 Waker。
  • 需要指定执行者时,在消息中明确写出 Waker 名称或职责。
  • 对原任务进行补充或修改时,说明是在继续当前任务;需要新建任务时明确写出“另起一个任务”及新目标。
  • 查询进度或取消任务时,说明对应任务或话题,避免与新的执行请求混淆。
不同 IM 渠道对 @ 机器人的要求可能不同。发送测试消息时,按渠道规则 @ 机器人或授权账号,并确认 @Waker 觉醒 已开启。

管理已开通的会话

@Waker 会话 提供表格和卡片两种视图。可以按会话或 Waker 搜索,也可以按响应 Waker 和聊天类型筛选。 对单个会话可以执行以下操作:
  • 编辑:调整响应 Waker、默认 Waker、模型、目录、权限和路由规则。
  • 暂停:暂时停止该会话接收任务,保留现有配置。
  • 删除:解除会话连接。以后需要使用时必须重新开通或配对。
  • @Waker 觉醒:单独控制该会话是否启用智能分派。
列表中的常见状态包括:
状态含义与处理
活跃连接和会话均可用,可以接收任务。
已暂停配置仍保留,但暂不接收任务;确认配置后重新启用。
渠道关闭对应 IM 连接已关闭;先在 IM 连接 中启用连接。
已失效原连接已经被删除或无法识别;重新添加同一连接后再检查会话。

配置 @Waker 专家

为每个 @Waker 会话配置真人专家后,@Waker 会依据配置的规则,在合适的时机主动向合适的专家求助;收到专家回复后,工作会继续推进,结果也会回到原来的任务和群聊。
  1. 进入 @Waker,打开目标会话详情页并切换到 配置专家
  2. 单击 添加专家,搜索并选择专家;无法搜索时,手动填写专家 ID 和名称。
  3. 填写 专家求助规则,然后单击 添加规则 保存。
管理员可以根据实际工作的难点和卡点设置专家求助规则。过于宽泛的规则容易模糊 @Waker 求助的边界,例如“困难问题问专家”。更合适的规则包括:
  • 账号登录、组织权限和企业认证
  • 所有代码交付前找专家 Review
为 @Waker 会话配置专家
为当前 @Waker 会话添加专家,并填写具体的专家求助规则。

专家如何与 @Waker 良好协作

专家会在与机器人的私聊中收到求助。推荐的回复方式是:引用 @Waker 发来的求助消息,再给出结论。 专家第一次回复后,还可以继续补充、追答或纠正,只需继续引用同一条消息。 更多配置说明和使用场景见《@Waker 专家配置最佳实践》

验证并上线

先在测试群或测试单聊中完成以下检查,再扩大使用范围:
  1. 发送一个职责明确的任务,确认由预期 Waker 响应。
  2. 发送一个未明确指定角色的任务,确认由默认 Waker 响应。
  3. 补充原任务、另起一个任务、查询进度和取消任务,确认没有错误创建或串联任务。
  4. 验证工作目录、文件防护和配置修改权限,确认 Waker 不能访问或修改未授权内容。
  5. 检查消息发送身份、回复内容和产物是否符合团队要求。
以上检查通过后,再逐步扩大到正式群聊。以后修改连接、响应 Waker、模型、目录、权限或路由规则,也应先用一条新消息重新验证。 如果没有收到回复,按以下顺序排查:
  1. IM 连接是否可用;
  2. 会话状态是否为 活跃
  3. @Waker 觉醒 是否开启;
  4. 响应 Waker 是否在线且已启用;
  5. 渠道是否要求 @ 机器人或授权账号;
  6. 模型、工作目录和权限是否可用。
使用钉钉个人账号时,如果联系人或群聊搜索不可用,根据页面提示完成 DingTalk DWS 连接和登录后再试。