feat(aia): Implement Protocol Agent MVP with reusable Agent framework

Sprint 1-3 Completed (Backend + Frontend):

Backend (Sprint 1-2):
- Implement 5-layer Agent framework (Query->Planner->Executor->Tools->Reflection)
- Create agent_schema with 6 tables (agent_definitions, stages, prompts, sessions, traces, reflexion_rules)
- Create protocol_schema with 2 tables (protocol_contexts, protocol_generations)
- Implement Protocol Agent core services (Orchestrator, ContextService, PromptBuilder)
- Integrate LLM service adapter (DeepSeek/Qwen/GPT-5/Claude)
- 6 API endpoints with full authentication
- 10/10 API tests passed

Frontend (Sprint 3):
- Add Protocol Agent entry in AgentHub (indigo theme card)
- Implement ProtocolAgentPage with 3-column layout
- Collapsible sidebar (Gemini style, 48px <-> 280px)
- StatePanel with 5 stage cards (scientific_question, pico, study_design, sample_size, endpoints)
- ChatArea with sync button and action cards integration
- 100% prototype design restoration (608 lines CSS)
- Detailed endpoints structure: baseline, exposure, outcomes, confounders

Features:
- 5-stage dialogue flow for research protocol design
- Conversation-driven interaction with sync-to-protocol button
- Real-time context state management
- One-click protocol generation button (UI ready, backend pending)

Database:
- agent_schema: 6 tables for reusable Agent framework
- protocol_schema: 2 tables for Protocol Agent
- Seed data: 1 agent + 5 stages + 9 prompts + 4 reflexion rules

Code Stats:
- Backend: 13 files, 4338 lines
- Frontend: 14 files, 2071 lines
- Total: 27 files, 6409 lines

Status: MVP core functionality completed, pending frontend-backend integration testing

Next: Sprint 4 - One-click protocol generation + Word export
This commit is contained in:
2026-01-24 17:29:24 +08:00
parent 61cdc97eeb
commit 96290d2f76
345 changed files with 13945 additions and 47 deletions

View File

@@ -0,0 +1,79 @@
# Protocol Agent 开发计划文档
> 创建日期2026-01-24
> 状态:待开发
---
## 📚 文档目录
| 序号 | 文档 | 说明 |
|:----:|------|------|
| 00 | [开发计划总览](./00-开发计划总览.md) | 项目背景、决策记录、核心架构概览 |
| 01 | [架构设计](./01-架构设计.md) | 五层Agent架构、各层详细设计、执行流程 |
| 02 | [数据库设计](./02-数据库设计.md) | 完整Prisma Schema、ER图、迁移计划 |
| 03 | [代码结构设计](./03-代码结构设计.md) | 目录结构、核心类型、API设计、前端组件 |
| 04 | [分阶段实施计划](./04-分阶段实施计划.md) | Sprint划分、任务列表、风险管理、验收标准 |
---
## 🎯 项目概述
Protocol Agent研究方案制定助手是AIA模块的第13个智能体入口通过多轮对话引导用户完成临床研究方案的核心要素制定。
### 核心架构
```
Query → Planner → Executor → Tools → Reflection
(意图识别) → (规划) → (执行) → (工具) → (反思)
```
### 开发周期
- **Phase 1**: MVP完整功能 (4周) - 包含一键生成研究方案
- **Phase 2**: 知识增强 (3周)
- **Phase 3**: 平台化 (2周)
**总周期9周**
---
## ✅ 已确认决策
| 决策项 | 选择 |
|--------|------|
| 入口方式 | B - Protocol Agent作为第13个入口 |
| 状态流转 | B - 用户按钮确认触发 |
| 数据提取 | C - 异步提取+LLM结构化 |
| Action Card | B - 规则触发 |
| Reflexion | B - Prompt-based |
---
## 📋 快速导航
### 需要了解业务需求?
→ 查看 [Protocol Agent PRD](../00-系统设计/Protocol_Agent_PRD_v1.0.md)
### 需要了解技术架构?
→ 查看 [01-架构设计](./01-架构设计.md)
### 需要了解数据库表结构?
→ 查看 [02-数据库设计](./02-数据库设计.md)
### 需要开始编码?
→ 查看 [03-代码结构设计](./03-代码结构设计.md)
### 需要了解任务安排?
→ 查看 [04-分阶段实施计划](./04-分阶段实施计划.md)
---
## 📎 相关文档
- [AIA模块当前状态](../00-模块当前状态与开发指南.md)
- [Protocol Agent PRD v1.0](../00-系统设计/Protocol_Agent_PRD_v1.0.md)
- [MVP简化指南](../00-系统设计/Protocol_Agent_Development_Simplification_Guide.md)
- [架构设计V3](../02-技术设计/Protocol_Agent_Architecture_Design_V3.md)
- [技术实现V3](../02-技术设计/Protocol_Agent_Technical_Implementation_V3.md)