docs(需求分析): 同步Agent原型与资料包会话绑定

This commit is contained in:
2026-06-04 00:07:20 +08:00
parent fe7f1e8855
commit b489dc1b37
5 changed files with 173 additions and 44 deletions

View File

@@ -28,13 +28,31 @@ V1 采用:
当前系统围绕以下注册申报审核闭环展开:
1. 导入注册资料。
2. 汇总文件目录与页数
3. 对照法规要求检查完整性
4. 抽取产品关键信息
5. 自动填入注册申报表格或对照清单
6. 核查跨文档一致性
7. 输出风险预警与处理建议
1. 导入注册资料
2. 解析资料包并识别产品名称
3. 以解析后的产品名称创建或绑定对话会话
4. 汇总文件目录与页数
5. 对照法规要求检查完整性
6. 抽取产品关键信息
7. 自动填入注册申报表格或对照清单
8. 核查跨文档一致性。
9. 输出风险预警、处理建议和飞书通知。
## 当前产品形态
当前原型和需求文档已经统一为 Agent 化产品形态,顶层入口固定为:
1. `审核智能体`
2. `资料包`
3. `知识库`
4. `处理历史`
对应关系如下:
1. `审核智能体` 是主执行入口,承载对话、模板提问、节点跳转和结构化结果。
2. `资料包` 是主业务对象,资料包与会话绑定,对话标题采用解析后的产品名称,并支持按产品名称或批次号搜索。
3. `知识库` 负责法规资料、业务资料、RAG 切片、字段 Schema、模板映射和飞书配置治理。
4. `处理历史` 用于按批次回看历史任务、关联会话、风险状态和通知留痕。
## 模块划分
@@ -137,13 +155,14 @@ V1 暂不重点做:
拿到题目后:
1. 判断题目属于哪类模板
2. 复制最接近的 YAML 场景配置。
1. 判断资料包、规则依据和核心审核链路
2. 调整最接近的任务 YAML 配置。
3. 修改 Agent 角色、目标、指令和输出模板。
4. 上传题目材料。
5. 如需业务计算,新增一个工具函数
6. 用 2 到 3 个问题测试效果
7. 演示场景配置、知识库引用、工具调用、结构化输出和审计日志
4. 上传题目材料并生成资料包
5. 确认产品名称解析、资料包绑定和会话标题是否正确
6. 如需业务计算,新增一个工具函数
7. 用 2 到 3 个预设问题测试目录汇总、完整性检查和字段抽取
8. 演示对话节点、知识库引用、结构化输出、飞书通知和审计日志。
## 当前页面概览
@@ -151,12 +170,10 @@ V1 暂不重点做:
| 页面 | 路径 | 当前能力 |
|---|---|---|
| 场景首页 | `/` | 展示场景名称、描述、适用题型、RAG 状态、工具数和配置异常摘要 |
| 对话页 | `/chat/<scenario_id>/` | 输入问题、勾选已入库文档、查看结构化结果、引用片段、工具调用和审计入口 |
| 文档列表页 | `/documents/` | 查看文档状态、错误信息、上传时间并手动触发入库 |
| 文档上传页 | `/documents/upload/` | 选择场景并上传 `.txt``.md``.pdf``.docx` 文件 |
| 审计列表页 | `/audit/` | 查看执行摘要并按场景筛选 |
| 审计详情页 | `/audit/<log_id>/` | 查看输入、最终回答、结构化输出、引用、工具调用、原始输出和错误信息 |
| 审核智能体 | `/chat/<scenario_id>/` 或后续统一工作台入口 | 输入问题、上传附件、触发任务模板、查看节点结果、结构化输出、引用片段、工具调用和审计入口 |
| 资料包 | `/documents/` 及相关上传入口 | 查看资料包、文件状态、页数、解析结果、按产品名称搜索并跳转关联会话 |
| 知识库 | 后续治理页 / 原型页 | 管理法规资料、业务资料、切片、模板映射、责任人映射和飞书配置 |
| 处理历史 | `/audit/` 及详情页 | 查看执行摘要、最终回答、结构化输出、引用、工具调用、通知状态和错误信息 |
## 计划启动方式
@@ -249,9 +266,21 @@ docker compose config
## 文档入口
- [V1 总需求文档](docs/需求分析/1.V1总需求文档.md)
- [模块需求文档索引](docs/需求分析/2.模块需求索引.md)
- [智能体总体设计](docs/设计文档/1.智能体总体设计.md)
- [设计文档索引](docs/设计文档/0.设计文档索引.md)
- [需求重构总览与待确认事项](docs/需求分析/0.需求重构总览与待确认事项.md)
- [Config 模块需求分析](docs/需求分析/1.config模块需求分析.md)
- [Scenarios 模块需求分析](docs/需求分析/2.scenarios模块需求分析.md)
- [Documents 模块需求分析](docs/需求分析/3.documents模块需求分析.md)
- [Chat 模块需求分析](docs/需求分析/4.chat模块需求分析.md)
- [Audit 模块需求分析](docs/需求分析/5.audit模块需求分析.md)
- [Agent Core 模块需求分析](docs/需求分析/6.agent_core模块需求分析.md)
- [业务确认问答清单](docs/需求分析/9.业务确认问答清单.md)
- [资料包导入与目录汇总详细设计](docs/详细设计/1.资料包导入与目录汇总.md)
- [法规完整性检查详细设计](docs/详细设计/2.法规完整性检查.md)
- [字段抽取与统一字段池详细设计](docs/详细设计/3.字段抽取与统一字段池.md)
- [一致性核查详细设计](docs/详细设计/4.一致性核查.md)
- [风险预警详细设计](docs/详细设计/5.风险预警.md)
- [Word 回填导出详细设计](docs/详细设计/6.Word回填导出.md)
- [飞书通知详细设计](docs/详细设计/7.飞书通知.md)
- [注册审核平台整体原型设计](F:\PyCharm\DEMO-AGENT\docs\原型设计\1.整体原型设计.md)
- [原型设计目录](F:\PyCharm\DEMO-AGENT\docs\原型设计)
- [单文件演示站 HTML](F:\PyCharm\DEMO-AGENT\docs\原型设计\registration-prototype-demo.html)
@@ -262,5 +291,6 @@ docker compose config
当前仓库已补充一套围绕注册申报审核主线的原型设计资产,供复试讲解、方案评审和后续页面实现直接参考:
- 原型文档采用“总览 + 分页细设计”方式组织覆盖资料包导入、审核任务工作台、法规完整性检查、字段抽取与字段池、一致性核查、风险预警、Word 回填导出、飞书通知视图和知识库治理台。
- `docs/原型设计/registration-prototype-demo.html` 提供单文件可交互 mock 演示站,内含 8 个主页面视图和知识库 / 治理台 CRUD 抽屉
- `docs/原型设计/registration-prototype-demo.html` 提供单文件可交互 mock 演示站,当前已重构为 Agent 化界面,顶层为 `审核智能体 / 资料包 / 知识库 / 处理历史`
- 资料包与对话会话已在原型中绑定,对话标题采用解析后的产品名称,资料包页支持按产品名称搜索并跳转对应会话。
- 该演示站仅使用 mock 数据,不依赖 Django 路由或真实 Agent Core 执行结果。