From 59d522be0c2ec80685ce2df47d89a43fdf003205 Mon Sep 17 00:00:00 2001 From: bruce Date: Tue, 2 Jun 2026 23:08:39 +0800 Subject: [PATCH] =?UTF-8?q?docs(project):=20=E5=90=8C=E6=AD=A5=E6=B3=A8?= =?UTF-8?q?=E5=86=8C=E5=AE=A1=E6=A0=B8=E7=B3=BB=E7=BB=9F=E7=9A=84=E9=A1=B9?= =?UTF-8?q?=E7=9B=AE=E5=AE=9A=E4=BD=8D=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 24 +++++++++++--------- README.md | 66 ++++++++++++++++++++++++++++++------------------------- 2 files changed, 50 insertions(+), 40 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 9733d63..9bf2d4c 100644 --- a/AGENTS.md +++ b/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/需求分析/`。 ## 编码约定 diff --git a/README.md b/README.md index eb61ce8..1a1bfcb 100644 --- a/README.md +++ b/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 暂不重点做: - 多租户。