docs(project): 同步注册审核系统的项目定位说明
This commit is contained in:
24
AGENTS.md
24
AGENTS.md
@@ -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/需求分析/`。
|
||||
|
||||
## 编码约定
|
||||
|
||||
|
||||
66
README.md
66
README.md
@@ -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 暂不重点做:
|
||||
|
||||
- 多租户。
|
||||
|
||||
Reference in New Issue
Block a user