# pythonAgentDemo1

**Repository Path**: fyxcc/python-agent-demo1

## Basic Information

- **Project Name**: pythonAgentDemo1
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-18
- **Last Updated**: 2026-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 医智云病例管理 Agent

医院病例管理工作台原型，面向医生提供患者病例检索、病情概览、AI 病例摘要和随访提醒能力。

当前项目由 Vue 3 前端和 FastAPI + LangGraph Agent 服务组成。默认使用本地 mock 病例数据，便于直接启动和演示；后续可以将病例仓储和大模型调用替换为真实实现。

## 功能概览

- 工作台数据概览：我的患者、今日待办、本月随访、AI 洞察
- 病例中心：按姓名、病例号、诊断或医生搜索
- 病例筛选：全部病例、我的患者、住院中、待随访、已出院
- 病例详情：患者基本资料、主管医生、科室、入院日期、过敏史和风险等级
- AI 病例摘要：生成病情摘要，并给出当前临床关注事项
- 新建病例：录入患者姓名、性别、年龄和初步诊断
- Agent API：通过 LangGraph 组织意图识别、病例上下文加载和回答生成

## 技术栈

### 前端

- Vue 3 `<script setup>`
- TypeScript
- Vite
- Element Plus
- `@element-plus/icons-vue`

### 后端

- Python 3.9+
- FastAPI
- Uvicorn
- Pydantic
- LangGraph

## 项目结构

```text
agent/
├── src/
│   ├── App.vue          # 病例工作台页面、mock 数据和交互逻辑
│   ├── main.ts          # Vue 和 Element Plus 入口
│   └── style.css        # 工作台全局样式
├── backend/
│   ├── main.py          # FastAPI 应用、病例接口和 LangGraph Agent
│   └── requirements.txt # Python 依赖
├── public/              # 静态资源
├── package.json         # 前端脚本和依赖
└── README.md            # 开发与使用文档
```

## 环境要求

- Node.js 18+
- npm 9+
- Python 3.9+

可以先检查版本：

```bash
node --version
npm --version
python3 --version
```

## 启动项目

### 1. 启动前端

在项目根目录执行：

```bash
npm install
npm run dev
```

浏览器打开：<http://localhost:5173>

也可以让局域网内其他设备访问：

```bash
npm run dev -- --host 0.0.0.0
```

### 2. 启动 Python Agent 服务

建议单独打开一个终端，在项目根目录执行：

```bash
cd backend
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload --port 8000
```

Windows PowerShell 激活虚拟环境：

```powershell
cd backend
python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt
uvicorn main:app --reload --port 8000
```

Agent 服务地址：<http://localhost:8000>

FastAPI 文档地址：<http://localhost:8000/docs>

## API 使用方法

### 服务健康检查

```bash
curl http://localhost:8000/health
```

返回示例：

```json
{"status":"ok","agent":"langgraph"}
```

### 查询病例

```bash
curl http://localhost:8000/api/cases
```

### 调用病例 Agent

```bash
curl -X POST http://localhost:8000/api/agent/analyze \
	-H "Content-Type: application/json" \
	-d '{"question":"请总结该患者当前情况","case_id":"HX-2026091801"}'
```

请求字段：

- `question`：医生希望 Agent 分析的问题
- `case_id`：可选，病例号；未传时使用默认演示病例

返回内容包括：

- `answer`：Agent 生成的病例辅助结论
- `disclaimer`：临床使用提示

## 前端使用方法

1. 打开病例管理工作台。
2. 在病例中心输入姓名、病例号或诊断关键词进行检索。
3. 点击病例行查看右侧详情和 AI 摘要。
4. 通过顶部标签和状态下拉框缩小病例范围。
5. 点击 AI 摘要右上角刷新按钮模拟重新生成摘要。
6. 点击“新建病例”录入病例草稿。
7. 左侧导航可以切换工作台、病例中心、随访管理和知识库入口。

## 开发命令

```bash
# 启动开发服务器
npm run dev

# 类型检查和生产构建
npm run build

# 预览生产构建
npm run preview

# 检查 Python 文件语法
python3 -m py_compile backend/main.py
```

## 接入真实业务前的工作

当前 Agent 使用 `backend/main.py` 中的本地 `CASES` 数据和规则式回答，适合界面演示，不应直接用于生产医疗决策。正式接入前至少需要：

- 接入医院 HIS/EMR 数据，并统一患者、病例和就诊记录标识
- 增加登录、角色权限、科室权限和细粒度数据访问控制
- 对姓名、联系方式、身份证号和病历内容做脱敏、加密和审计
- 将规则式回答替换为经过评估的大模型调用，并保留模型版本和提示词记录
- 增加人工复核、引用来源、拒答策略、风险告警和操作留痕
- 增加后端单元测试、接口测试和前端关键流程测试

AI 输出仅用于临床辅助，不替代医生诊断、处方或其他医疗判断。