DEMO-AGENT/docs/需求分析/4.chat模块需求分析.md

Chat 模块需求分析

1. 模块定位

apps.chat 已从传统“问答页面”升级为：

审核智能体工作台

它是 V1 的主入口，负责把资料包、对话、任务模板、节点结果、结构化结论、飞书通知结果串成一个完整的人机协作界面。

2. 模块目标

本模块需要实现以下目标：

1. 让用户通过对话发起审核任务。
2. 让对话始终绑定到具体资料包和具体产品名称。
3. 让任务结果按节点展示，而不是只返回一段自然语言。
4. 让用户能直接看到 RAG 命中的法规依据、风险摘要和导出建议。
5. 支持执行完成或异常后触发飞书 @ 处理人。

3. 页面形态要求

基于最新版原型，Chat 模块页面形态固定为三栏：

3.1 左栏：对话历史

1. 按资料包会话展示历史记录。
2. 会话名称直接使用解析后的产品名称。
3. 会话至少显示时间、状态、摘要。
4. 点击会话可切换当前资料包上下文。

3.2 中栏：主对话区

1. 展示欢迎区、推荐提示词和节点导航。
2. 展示用户消息、Agent 计划、节点结果和最终结论。
3. 支持节点点击跳转。
4. 支持底部输入框继续追问。

3.3 右栏：上传栏 + 功能卡片

1. 上半区展示上传资料入口和当前会话已上传附件。
2. 下半区展示能力卡片。
3. 能力卡片随任务模板变化展示不同内容。

4. 关键业务约束

4.1 对话必须绑定资料包

用户不能在无上下文状态下执行审核。每次任务都应绑定：

1. conversation_id
2. batch_id
3. product_name
4. document_scope

4.2 对话名称必须来源于解析结果

会话标题默认使用资料包解析出的产品名称，而不是“新对话”或“注册批次审核主线”。

4.3 结果必须结构化

Chat 模块至少要展示：

1. 目录汇总结果
2. 完整性检查结果
3. 字段抽取结果
4. 一致性核查结果
5. 风险结论
6. 飞书通知结果

5. 输入需求

5.1 输入类型

1. 自然语言任务指令
2. 资料上传
3. 节点模板选择
4. 建议提示词点击

5.2 建议提示词

V1 推荐固定提供：

1. 自动汇总文件夹目录与页数
2. 执行法规完整性检查
3. 抽取字段并生成字段池
4. 解释冲突字段原因
5. 给出整改与导出建议

5.3 附件上传

Chat 模块中的上传不是独立附件功能，而是资料包流程的会话入口，因此上传后应自动触发：

1. 资料包批次创建或追加
2. 产品名称解析
3. 对话上下文绑定

6. 输出需求

6.1 节点式结果

结果不能只有长文本，必须形成节点：

1. 目录汇总
2. 完整性检查
3. 字段抽取
4. 风险结论

6.2 RAG 依据展示

当 Agent 在对话中引用法规或业务依据时，应展示：

1. 依据来源文档
2. 命中条款或切片标签
3. 解释摘要

6.3 飞书通知结果展示

当执行完成或发生异常后，Chat 模块应能展示：

1. 是否已触发飞书通知
2. 通知原因
3. 被 @ 的处理人
4. Web 详情链接
5. 发送状态或失败原因

7. 飞书相关需求

Chat 模块需要消费角色信息中的飞书字段。责任人实体至少包含：

1. owner_role
2. owner_name
3. department
4. chapter_scope
5. risk_scope
6. feishu_user_id
7. feishu_open_id
8. feishu_name
9. notify_enabled

当前 Demo 通知策略固定为：

1. 审核任务执行完成后，飞书摘要卡片 @ 处理人。
2. 审核任务执行异常后，飞书异常消息 @ 处理人。

8. 与其他模块边界

1. documents 提供资料包、产品名称、文件范围和目录事实。
2. agent_core 提供任务编排、RAG 检索和结构化输出。
3. audit 提供处理历史和通知留痕。

9. 验收标准

1. 用户能在一个会话中完成资料上传、任务发起和结果查看。
2. 对话历史以产品名称展示，而不是泛化标题。
3. 节点式结果、RAG 依据和飞书通知结果都能在页面上承载。
4. 执行完成或异常的飞书通知逻辑有明确展示位和字段依赖。