docs(project): 同步注册审核系统的项目定位说明

This commit is contained in:
2026-06-02 23:08:39 +08:00
parent e64dca551c
commit 59d522be0c
2 changed files with 50 additions and 40 deletions

View File

@@ -4,14 +4,18 @@
## 项目定位
Universal Agent Demo Framework 是一个用于复试展示的通用 AI Agent Demo 框架。
当前项目已根据真实笔试题切换为:
```text
试剂盒临床注册文件准备与审核智能体平台
```
优先目标:
- 快速适配未知复试题
- 围绕 NMPA 体外诊断试剂注册申报资料场景完成可演示闭环
- 保证本地可运行。
- 保证代码结构清楚,方便讲解。
- 避免为了平台完整性牺牲改题速度
- 允许在保留主架构边界前提下进行大幅度业务重构
## 架构原则
@@ -36,23 +40,23 @@ Django 单体 + 独立 Agent Core + Docker Compose
### apps.scenarios
负责场景列表、场景配置读取、场景元信息展示。
负责注册审核任务列表、任务配置读取、任务元信息展示。
### apps.documents
负责文件上传、文件记录、文件状态和触发 RAG 入库。
负责注册资料上传、文件记录、章节点归类、页数与文本处理状态和触发 RAG 入库。
### apps.chat
负责对话页面、用户输入表单、调用 Agent Core 和展示结果。
负责审核工作台、用户输入表单、调用 Agent Core 和展示结构化审核结果。
### apps.audit
负责审计日志模型、日志写入服务、日志列表和详情页。
负责审计日志模型、日志写入服务、日志列表和详情页,以及审核留痕展示
### agent_core
负责 Agent 编排、RAG、工具注册、LLM Provider结构化输出和 Adapter 扩展
负责注册审核 Agent 编排、RAG、工具注册、规则执行、LLM Provider结构化输出。
## 开发顺序
@@ -72,10 +76,10 @@ Django 单体 + 独立 Agent Core + Docker Compose
当前仓库状态说明:
- Django 单体骨架已完成。
- 5 个预置场景 YAML 已接通首页和对话页
- 通用场景 YAML、Chat、Documents、Audit 和 Agent Core 已具备可重构基础
- Agent Core 已具备 Prompt 编排、结构化解析、工具注册和 RAG fallback / Chroma 双路径。
- Chat、Documents、Audit 页面已经可以形成完整演示闭环。
- 全量测试已覆盖主要模块行为,并默认隔离真实 LLM 网络调用。
- 当前需求文档已按真实笔试题重写到 `docs/需求分析/`
## 编码约定

View File

@@ -1,13 +1,13 @@
# Universal Agent Demo Framework
# 试剂盒临床注册文件准备与审核智能体平台
用于复试展示的通用 AI Agent Demo 框架
用于复试展示的体外诊断试剂注册申报资料准备与审核系统
项目目标不是提前猜中某一个具体业务题,而是先准备一个可快速改题的基础平台。拿到复试题目后,可以通过修改场景配置、上传知识库、补充少量工具函数,快速完成一个可演示的企业业务 Agent
当前项目已根据真实笔试题重构目标定位,重点服务于 NMPA 境内第三类体外诊断试剂注册申报场景,覆盖资料整理、目录汇总、法规完整性检查、关键信息抽取、跨文档一致性核查、风险预警和审计留痕
## 核心理念
```text
业务 Agent = 场景配置 + 知识库 + 工具集 + 输出模板 + 审计日志 + 模型适配器
注册审核 Agent = 任务配置 + 资料库 + 法规规则 + 工具集 + 输出模板 + 审计日志 + 模型适配器
```
## 技术路线
@@ -24,18 +24,16 @@ V1 采用:
默认不强依赖 Dify。系统预留 Adapter 设计,后续可以接入 Dify、OpenAI Agents SDK 或其他 Agent 编排平台。
## 适用复试题型
## 当前业务主线
| 题型 | 推荐场景模板 |
|---|---|
| SOP 问答 | `knowledge_qa` |
| 制度问答 | `knowledge_qa` |
| 文档审核 | `document_review` |
| 客服工单 | `ticket_assistant` |
| 质量异常分析 | `quality_analysis` |
| 财务审核 | `risk_audit` |
| 采购审核 | `risk_audit` |
| 合同风险分析 | `document_review``risk_audit` |
当前系统围绕以下注册申报审核闭环展开:
1. 导入注册资料。
2. 汇总文件目录与页数。
3. 对照法规要求检查完整性。
4. 抽取产品关键信息。
5. 核查跨文档一致性。
6. 输出风险预警与处理建议。
## 模块划分
@@ -79,11 +77,11 @@ universal-agent-demo/
schemas/
configs/
knowledge_qa.yaml
document_review.yaml
ticket_assistant.yaml
quality_analysis.yaml
risk_audit.yaml
registration_overview.yaml
registration_completeness_check.yaml
registration_field_extraction.yaml
registration_consistency_review.yaml
registration_risk_report.yaml
data/
uploads/
@@ -96,20 +94,21 @@ universal-agent-demo/
V1 需要完成:
- 场景列表。
- Agent 对话页
- 文件上传
- 文档入库。
- RAG 检索
- 内置工具调用
- 结构化输出展示
- 审计日志
- 注册审核任务列表。
- 审核工作台
- 资料上传与管理
- 文档解析与入库。
- 目录与页数汇总
- 法规完整性检查
- 关键信息抽取与回填预览
- 一致性核查
- 风险预警与审计日志。
- 模型 API 可配置。
- Docker 一键启动。
当前代码基线已经落地的能力:
当前代码基线已经落地的通用能力:
- 首页支持展示场景摘要、适用题型、RAG 状态、工具数量。
- 首页支持展示场景摘要、RAG 状态、工具数量。
- 非法 YAML 场景配置会被自动跳过,并在首页展示错误摘要。
- 对话页支持问题输入、文档范围选择、结构化结果、引用片段、工具调用和审计入口展示。
- 文档页支持上传、列表查看、手动入库、失败原因提示和重试。
@@ -117,6 +116,13 @@ V1 需要完成:
- Agent Core 已具备 Prompt 编排、OpenAI 兼容 Provider、结构化输出解析、RAG 检索和工具注册机制。
- 测试环境默认固定使用 Mock Provider避免误调用本地真实模型配置。
## 本轮需求文档
本轮已按模块重写需求分析,详见:
- [V1 总需求文档](F:\PyCharm\DEMO-AGENT\docs\需求分析\1.V1总需求文档.md)
- [需求重构总览与待确认事项](F:\PyCharm\DEMO-AGENT\docs\需求分析\0.需求重构总览与待确认事项.md)
V1 暂不重点做:
- 多租户。