Skip to main content
客户案例

Q 仔群聊智能问答助手操作手册

Q仔是接入群聊的智能问答助手，只依据知识库有据才答，遇到不确定的问题自动私聊同事确认，并把确认过的答案沉淀为新知识。

一、什么是Q仔

Q仔是您团队的群聊智能问答助手。接入群聊后，团队成员有问题直接在群里提问，Q仔会自动回答。它有三个核心特点：
  • 有据才答：只基于您提供的知识库回答，不会瞎编
  • 不懂就问：遇到不确定的问题，主动找您指定的同事确认
  • 越用越聪明：同事确认过的答案自动积累，下次直接复用
image.png

二、创建与配置

2.1 创建Q仔

进入 QoderWake 控制台 → 点击"创建 Waker" → 选择 "Q仔（问答助手）" 模板 → 填写名称和描述 → 完成。 创建后，详情页会显示配置引导，按提示依次完成即可。
image.png

2.2 群聊接入

进入Q仔详情页 → 左侧"IM" → 进入 IM 渠道配置页面。 支持的渠道：
  • 钉钉（阿里team账号仅支持阿里钉机器人）
  • 飞书（集团内安全评估中暂未开放）
接入步骤：
  1. 点击对应渠道的"配置"按钮
  2. 填写 App ID 和 App Secret（或选择扫码模式）
  3. 点击“添加配对”，选择渠道并填写配对信息：
    • 会话信息：根据需要选择“单聊”或“群聊”。单聊推荐填写 Open ID；未填写 Open ID 时需填写用户 ID；显示名称可选
    • 运行配置：按需选择模型和工作目录；工作目录未选择时使用默认 IM 工作目录
  4. 点击“创建配对”，完成后开启渠道开关即可激活
Q仔默认使用工作流模式，无需手动选择。Open ID 是用户在当前应用下的身份标识，用户 ID 是企业或组织内部的账号标识；配对完成后，消息会自动进入预置的答疑流程。
接入后群成员正常提问即可，无需额外操作。可同时接入多个渠道。
image.png

2.3 配置知识库

知识库是Q仔回答的依据来源。Q仔通过绑定平台上的知识库来获取知识。 操作步骤：
  1. 进入Q仔详情页 → 左侧"知识库" → 点击"绑定知识库"
  2. 选择"选择已有"绑定平台上已有的知识库，或选择"新建并绑定"创建一个新的
  3. 可绑定多个知识库
知识库的内容管理在平台级的"知识库"模块中进行（左侧导航栏的知识库图标），在那里可以上传文件、输入网址、手动录入等。
建议：先在知识库模块中创建并上传团队现有的FAQ文档，再回到Q仔这里绑定即可。
image.png

2.4 求助同事

当Q仔遇到知识库中没有覆盖的问题时，会自动私聊您指定的同事确认答案。 进入左侧"团队协作" → 点击"添加同事" → 搜索同事姓名或工号 → 填写协作设置：
  • 擅长领域：如"报销、考勤"，Q仔会按领域匹配派发问题
  • 角色：技术负责人 / 业务负责人 等
  • 权限勾选：启用、可确认答案、可被求助
页面上会显示当前有多少问题在等待确认、多少已完成，方便您掌握进度。
image.png

2.5 回复要求

左侧"设置"页面管理Q仔的回复行为：
  • 回复风格：专业稳妥 / 简洁直接 / 活泼轻快，按群聊调性选择
  • 回复语言：跟随用户 / 固定中文 / 固定英文
  • 业务范围：告诉Q仔它负责回答哪类问题（超出范围的会拒绝回答）
  • 敏感信息：定义不可回复的内容类型（如账号密码），遇到时会引导联系负责人
  • 免责声明：对外群可开启，回复末尾自动加免责后缀
image.png

三、工作流程

Q仔的所有行为由一套预置的 WakerFlow 工作流驱动。创建Q仔时，系统会自动初始化这套默认流程。

默认流程逻辑

群消息到达后，WakerFlow 按以下顺序决策：
  1. 主决策：判断消息意图——是正常提问、噪声、超出范围、还是专家回复
  2. 任务执行：
    • 正常提问 → 检索知识库 → 有答案就回复
    • 知识库无匹配 → 升级为专家求助 → 私聊对应同事
  3. 专家回复处理：同事确认答案 → 自动回复到原群 → 知识沉淀入库
核心循环： 提问 → 知识库检索 → 不确定时求助同事 → 确认后沉淀为知识 → 下次直接答 用得越久，Q仔能独立回答的问题越多，需要打扰同事的频率越低。 以下是Q仔在飞书群中实际回复的效果：
image.png

查看和编辑工作流

进入Q仔详情页 → 左侧"工作流"标签，可以看到Q仔的工作流脚本：
  • 画布：可视化查看整个流程结构，拖拽修改节点
  • 脚本：直接编辑 JavaScript 代码
  • 运行记录：查看每条群消息的处理过程和各步骤耗时
除了默认的答疑流程，您还可以自己创建新的 WakerFlow，让Q仔执行更多自定义任务。比如：每天自动汇总未解决问题发报告、定时检查知识库是否过期等。点击"新建 WakerFlow"按钮，通过指定画布节点对话式编辑或手写脚本定义流程即可。
提示：如果您不需要自定义流程，保持默认即可。默认流程已经覆盖了绝大多数群聊答疑场景。
image.png

四、效果查看

答疑记录

左侧"答疑记录"展示Q仔的工作数据：提问总数、回复率、求助数、失败数。支持按群聊筛选。哪类问题答不上来一目了然，针对性补充知识即可。
image.png

五、常见问题

问题回答
Q仔回答准确吗？Q仔会优先基于知识库内容回答，没把握的问题会转交同事确认。但底层是大模型，建议先小范围试用，观察回答质量后再扩大使用。
不懂技术能用吗？能。知识库只需上传文档，其他配置项按首页引导逐步完成即可。
支持图片提问吗？支持接收图片，但当前主要依赖图片中的文字信息，复杂界面、图表或仅靠图片表达的问题可能理解不准确，建议同时补充文字说明。
会频繁打扰求助同事吗？同类问题确认一次后会沉淀为知识，下次不会重复派发。可在协作设置中调整派发规则。
发现回答不准确怎么办？在知识库中补充或修正对应内容，或在“设置”中调整业务范围说明。
怎么看回答效果？查看左侧“答疑记录”，可按群筛选提问数、回复率、求助数等数据。
已添加机器人，但群聊列表为空，怎么办？通常是钉钉事件订阅未配置成功。删除当前钉钉渠道后，运行 qoderwake channel dingtalk qr-start，用手机钉钉扫码授权，再把新机器人加入群聊。扫码流程会自动配置事件订阅。
私聊求助失败并出现 HTTP 403 - IpNotInWhiteList，怎么办？到钉钉开放平台打开对应应用，在“权限管理 / 开发配置”或“应用安全设置”中，把运行 QoderWake 的服务器出口 IP 加入白名单。
更新后原来的知识库看不到了，是不是丢失了？知识库仍与平台账号关联，数据没有丢失。升级到最新版本后，重新绑定原知识库即可。
钉钉文档链接加入知识库后变成 404，怎么办？钉钉文档受访问限制，不能作为知识源直接绑定读取。请先导出为受支持的文件后上传，或转成可公开访问的内容再导入。
Q仔回答了业务范围外或其他版本的内容，怎么办？在“设置”中明确业务范围和适用版本，并只绑定对应产品、版本的知识库；及时清理或更新过期内容，减少无关信息召回。
Q仔回答异常时怎么定位原因？进入“工作流 → 运行记录”，查看对应消息的处理过程、知识库召回和工具调用情况，再根据结果调整知识库或回复设置。
更多企业解决方案请咨询 ➔
产品概述
快速入门
动态与公告
账户
事件