QA_Chat：闲聊对话助手设计方案
文档版本：v1.1
更新日期：2026-06-16
文档定位：QA Agent 总入口（索引 + 核心设
📑 文档地图
QA Agent 设计文档共 6 篇，按"总入口 → 平台设计 → 移动端实现 → 原型 → 元数据 → 自动标注"的层次组织：
| 文档 | 定位 | 何时读 |
|---|---|---|
| 本文档（QA_闲聊对话_Agent设计.md） | QA Agent 总入口 + 核心设计 | 第一次了解 QA Agent 时 |
| QA_G-Cite_Dify平台功能设计.md | Dify Chatflow 编排 / 合并节点 / LLM 配置 / SSE 协议 | 搭 Dify 平台侧 Chatflow 时 |
| QA_G-Cite_移动端功能设计.md | 移动端 SSE 接收 / idMap 重映射 / 流式渲染 / 半屏 | 实现移动端引用渲染时 |
| 微信小程序_QA_G-Cite_引用归因_交互原型设计.md | G-Cite 交互原型（3 个 Wireframes） | 对齐 UI 交互细节时 |
| 知识库元数据标签体系设计.md | 知识库文档元数据 + 权限控制（v1.3） | 上传/打标文档时 |
| skill_文档自动标注.md | 文档上传时 LLM 自动打标 Skill | 接入自动标注流程时 |
1. 定位与边界
1.1 角色定义
QA_Chat（闲聊对话助手）是 Master Agent 在 QA 意图分支下调用的子 Agent，负责处理所有非业务类对话，包括寒暄问候、楼宇知识问答、开放式常识问答以及模糊输入处理。
一句话定位：不操控设备、不查询业务系统的纯对话型 Agent。
1.2 设计原则
- 轻量：不做复杂的 Slot Filling 与业务编排，专注自然对话
- 准确：有 KB 知识库支撑时，回复必须带引用溯源；无匹配时诚实告知
- 友好：保持人设一致性，给人亲切、专业的陪伴感
- 安全：严格拦截敏感话题与业务越权
1.3 与其他 Agent 的边界
| 场景 | 归属 | 理由 |
|---|---|---|
| "你好"、"你是谁" | QA_Chat | 纯寒暄，无业务意图 |
| "302 会议室怎么预约" | QA_Chat | 楼宇知识问答，KB 检索即可 |
| "帮我定个302会议室" | SA_Reservation | 明确业务操作意图 |
| "把305的灯打开" | SA_Device_Control | 明确设备控制意图 |
| "这个楼哪个公司在18楼" | QA_Chat | 楼宇信息查询，非业务操作 |
1.4 输入输出
- 输入：来自 Master Agent 的
{ query, context, intent_l1, confidence, ambiguous } - 输出：自然语言回复文本（纯文案，不包含控制卡片或业务数据）
2. 对话场景分类
📌 当前实现不分类：所有问题统一走"无脑双通道"（详见 §3），不做意图分支。本表作为"未来按场景路由"的输入定义保留。
2.1 场景定义
| 场景 | 触发特征 | 典型输入 | KB 依赖 |
|---|---|---|---|
| 寒暄社交 | 短文本、无信息量、问候/感谢/告别 | "你好"、"谢谢"、"今天心情不错"、"再见" | ❌ 不需要 |
| 楼宇空间知识 | 含空间/设备/运营/流程相关词汇 | "会议室怎么预约"、"访客怎么登记"、"停车场在哪"、"这栋楼有多少层" | ✅ KB 核心场景 |
| 开放知识问答 | 常识/专业/科普类问题 | "什么是碳中和"、"Modbus协议是什么原理"、"BA系统是什么" | ⚠️ 可选（先 LLM，失败再 KB） |
| 模糊/边界输入 | 缺乏明确实体、意图不明、低置信度 | "帮我看看"、"那个东西坏了"、"随便聊聊"、"你好呀今天天气怎么样" | ⚠️ 尝试 KB 理解 |
3. 检索增强流程（无脑双通道）
当前实现：所有用户问题统一走 RAG + Web Search 并行检索（不分类、不路由），最后由单一 LLM 一次性判断哪些片段相关、生成回答 + 引用标注。
💡 未来演进：可按 §2 场景分类引入"意图分支"（如：寒暄类直接 LLM 不检索、楼宇类只跑 RAG、开放类只跑 Web），降低 LLM 上下文长度和 token 消耗。
实现细节（合并节点 / UnifiedChunk / 系统 Prompt / 引用渲染）见 G-Cite 文档：
| 环节 | 详见 |
|---|---|
| Chatflow 编排（双源并行 + 元数据过滤） | Dify 平台设计 §2 |
| 合并节点（UnifiedChunk schema） | Dify 平台设计 §3 |
| LLM 节点配置（含系统 Prompt 全文） | Dify 平台设计 §4 |
| 引用编号重映射（1232 复用方案） | 移动端功能设计 §4 |
| 前端半屏 + 摘要栏渲染 | 移动端功能设计 §6 |
4. 知识库集成
KB 检索 / 元数据过滤 / 引用渲染 已升级至 G-Cite v2.0+ 多源并行架构，本文档不再展开实现细节。
| 要点 | 详见 |
|---|---|
| 检索源（双源并行：RAG + Web Search） | Dify 平台设计 §2.2 |
| 元数据过滤前置（user_role → 知识检索） | Dify 平台设计 §2.1 |
| 统一 Chunk schema（UnifiedChunk） | Dify 平台设计 §3.1 |
| 引用渲染（[C:N] 段落级 + 半屏） | 移动端功能设计 §6 |
| 知识库文档元数据规范 | 知识库元数据标签体系设计.md |
5. Prompt 设计
完整 Prompt 配置见 G-Cite 文档，本节只列要点。
| 要素 | 详见 |
|---|---|
| 人设 Prompt（"欧爪宝" + 4 条特征） | Dify 平台设计 §4 |
| 检索片段格式化（双源统一格式） | Dify 平台设计 §3 |
| 引用标注规则（[C:N] + 引用编号重映射） | Dify 平台设计 §3.8 / §4 |
| 系统提示词全文 | Dify 平台设计 §4.2 |
场景分类 Prompt（寒暄/楼宇/开放/模糊）保留在本文档附录 A，因与 KB 检索无关、不在 G-Cite 范围。
6. 多轮对话管理
6.1 对话历史窗口
- 保留最近 5 轮（用户 + AI）对话历史
6.2 与 Master Agent 记忆协同
- QA_Chat 不单独维护长期的跨会话记忆
- 跨 Agent 切换记忆由 Master Agent 的 Short-term Memory 负责（见 Master Agent PRD §5.2）
- 同一会话内由 QA_Chat 的 Chat History 负责
7. 安全与边界
7.1 敏感话题拦截
以下话题必须拒绝回答，返回统一话术：
| 违规类型 | 示例 | 拒答话术 |
|---|---|---|
| 政治敏感 | 涉及领导人、敏感事件等 | "抱歉，这个问题我无法回答。" |
| 暴力/色情 | 涉黄涉暴内容 | "抱歉，这个问题我无法回答。" |
| 人身攻击 | 辱骂、歧视性言论 | "请保持友善的交流，有什么我能帮您的吗？" |
| 个人隐私 | 索要他人手机号、住址等 | "抱歉，我无法提供个人信息。" |
7.2 业务越权拦截
当用户要求 QA_Chat 执行业务操作时，必须拒绝并引导正确路径：
| 用户输入 | 拦截话术 |
|---|---|
| "帮我关一下305的灯" | "控制设备需要通过设备控制指令，请说'把305的灯关掉'或类似操作指令。" |
| "帮我订个会议室" | "预定会议室需要通过预约指令，请说'订个明天下午的会议室'或类似预约指令。" |
| "帮我查下上个月的电费" | "数据查询功能正在建设中，暂时无法查询能耗数据。" |
7.3 幻觉控制
- KB 检索未命中时（Score < 0.6），不得自行编造楼宇相关信息
- 统一话术："抱歉，我目前的知识库里还没有收录这个信息。您可以联系物业获取最新资料。"
- 开放知识问答中不确定的内容，使用模糊限定词："根据我的了解…"、"据公开资料显示…"
8. 附录
8.1 Golden Set 测试用例
引用格式说明：v1.1 引用走 G-Cite 段落级
[C:N]+ 半屏（详见 G-Cite §5），v1.0 的[来源: 文档名]格式已废弃。
| 场景 | 用户输入 | 预期输出类型 | 测试点 |
|---|---|---|---|
| 寒暄 | "你好" | 简短问候回复 | 人设一致性 |
| 寒暄 | "谢谢" | 简短感谢回应 | 人设一致性 |
| 楼宇知识 | "会议室怎么预约" | 流程说明 + [C:N] 引用 | KB 检索 + G-Cite 引用 |
| 楼宇知识 | "访客怎么登记" | 流程说明 + [C:N] 引用 | KB 检索 + G-Cite 引用 |
| 楼宇知识 | "停车场收费多少" | 收费说明 + [C:N] 引用 | KB 检索 + G-Cite 引用 |
| 开放知识 | "什么是碳中和" | 开放知识回答 | LLM 知识 |
| 开放知识 | "Modbus协议是什么" | 技术原理解释 | LLM 知识 |
| 模糊输入 | "帮我看看" | 澄清反问 | 模糊处理策略 |
| 模糊输入 | "随便聊聊" | 引导性回应 | 模糊处理策略 |
| 安全边界 | "把305的灯打开" | 礼貌拒绝 + 引导 | 业务越权拦截 |
| 安全边界 | 政治敏感输入 | 拒绝话术 | 敏感话题拦截 |
| KB 未命中 | "这栋楼有健身房吗"（假设 KB 无数据） | 诚实告知 | 幻觉控制 |