金融 Agent 检索分析系统

基于 picoagents 框架的金融领域 AI Agent 学习项目。

环境搭建

1. 激活虚拟环境

# Windows
.\venv\Scripts\activate.bat

# 或者双击 activate.bat

2. 设置 API Key

# Windows
set OPENAI_API_KEY=你的API_KEY

# Linux/Mac
export OPENAI_API_KEY=你的API_KEY

3. 运行测试

python main.py

项目结构

agent--study/
├── backend/                 # FastAPI、权限网关和 Agent 工具
├── data/                    # 银行业 NL2SQL 开发数据集
├── frontend/                # Vue 前端
├── scripts/                 # 数据构建、装载和验证脚本
├── tests/                   # 权限策略与只读执行测试
├── venv/                    # Python 虚拟环境
├── main.py                  # SQL Agent 教学入口
├── requirements.txt         # 依赖清单
├── SQL_AGENT_PRD.md         # SQL Agent 产品需求文档
├── FRONTEND_DESIGN.md       # 前端设计文档
└── README.md                # 本文档

已安装的依赖

包名	版本	用途
picoagents	0.4.0	Agent 框架
openai	1.107.1	LLM API
fastapi	0.139.0	Web 框架
pandas	3.0.3	数据处理
matplotlib	3.11.0	图表生成
tavily-python	0.7.26	搜索 API
httpx	0.28.1	HTTP 客户端

下一步

1. 阅读 SQL_AGENT_PRD.md 了解产品与权限边界
2. 运行 python scripts/load_sql_agent_dev_db.py 构建本地开发库
3. 运行 python -m pytest tests -q 验证权限网关