requirements.txt

# =============================================================
# Enterprise AI Procurement Agent Platform — 依赖清单
# Python 3.11+
# 说明：刻意保持依赖精简——LangGraph 只用于图编排，
# LLM 调用直接用 openai SDK（DeepSeek 兼容 OpenAI 协议），
# 不引入 langchain 全家桶（面试点：LangGraph ≠ LangChain，图编排 ≠ 框架套娃）
# =============================================================

# ---- Web 框架 ----
fastapi>=0.111,<1.0
uvicorn[standard]>=0.30
python-multipart>=0.0.9        # 文件上传（Document Upload API）

# ---- 数据层 ----
sqlalchemy[asyncio]>=2.0.30    # 2.0 风格，async session
asyncpg>=0.29                  # PostgreSQL 异步驱动
pgvector>=0.3                  # pgvector 的 SQLAlchemy 类型支持
redis>=5.0                     # redis.asyncio 客户端

# ---- 校验与配置 ----
pydantic>=2.7
pydantic-settings>=2.3

# ---- Agent ----
langgraph>=0.2,<1.0            # 条件循环图编排（核心）
openai>=1.40                   # DeepSeek / 硅基流动均兼容 OpenAI 协议

# ---- MCP（工具标准化） ----
# <2：mcp 2.x 为 2026-08 发布的 API 完全重写版本（FastMCP 移除），
# 1.x FastMCP 是当前生态标准与文档最全的 API
mcp>=1.12,<2                   # 工具服务化：Agent 能力暴露为 MCP 协议

# ---- RAG ----
pypdf>=4.2                     # PDF 解析（loader.py）
httpx>=0.27                    # rerank API 调用 + 评估脚本

# ---- 监控 ----
prometheus-client>=0.20        # /metrics 端点
langfuse>=2.0                  # LLM tracing（增强依赖：挂了只降级不阻断，见 monitoring/langfuse.py）

# ---- 测试与评估 ----
pytest>=8.2
pytest-asyncio>=0.23