Python Agent / AI 服务

基于 FastAPI 构建的 AI + Agent 服务层，负责大模型调用、智能体编排、算法预测与知识库管理。

定位

Python 服务是产品的AI 能力中枢，不直接管理用户、角色、菜单等通用业务权限，专注以下领域：

• 大模型调用与模型适配
• Agent 智能体编排与工具调用
• 经期预测与健康数据分析算法
• 向量检索与知识库问答（RAG）
• AI 情绪安抚、健康问答、疼痛分析
• Prompt 模板与版本管理
• 模型调用成本统计与审计

技术栈

方面	技术
框架	FastAPI
运行时	Python 3.12+
包管理	uv
ORM	SQLAlchemy 2.0 (async) + asyncmy
数据库	MySQL 8.0+
缓存	Redis
认证	JWT（对接 Java 主后端）

Agent 服务划分

Agent	职责
Chat Agent	通用健康问答、会话管理、知识库检索
Period Prediction Agent	经期预测、四期划分、AI 解释预测结果
Pain Analysis Agent	疼痛趋势分析、缓解方式评估、月度报告
Emotion Comfort Agent	情绪识别、安抚话术生成、放松引导
Recommendation Agent	健康内容推荐、经期用品推荐

架构关系

Java 主业务后端 ── HTTP ──► Python Agent 服务
                                │
                    ┌───────────┼───────────┐
                    │           │           │
                    ▼           ▼           ▼
                大模型 API   知识库      向量存储
                (Qwen 等)   (RAG)      (future)

启动方式

# 开发启动
pnpm dev:backend

# 或直接使用 uv
uv run --directory backend/python dev