FA Agents - 一二级市场一体化投研Agent (MVP)

基于多智能体协同的投研分析平台，覆盖二级市场个股投研、基本面分析、舆情分析、多立场辩论决策。

快速开始

1. 环境准备

# 安装依赖
cd backend
pip install -r requirements.txt

# 配置环境变量
cp .env.example .env
# 编辑 .env，填入 Tushare Token 和自选池

2. 启动服务

# 方式一：Docker Compose（推荐）
docker-compose up -d

# 方式二：本地运行
cd backend
uvicorn main:app --reload

3. 验证服务

curl http://localhost:8000/
curl http://localhost:8000/health

4. 执行投研任务

# 个股投研
curl -X POST http://localhost:8000/research/stock \
  -H "Content-Type: application/json" \
  -d '{"stock_code": "000001.SZ"}'

项目结构

fa-agents/
├── docker-compose.yml      # Docker编排
├── backend/                # FastAPI后端
│   ├── main.py             # 入口
│   ├── api/                # API接口
│   ├── agents/             # Agent实现
│   ├── graph/              # LangGraph编排
│   ├── data/               # 数据源封装
│   ├── report/             # 报告生成
│   └── utils/              # 工具函数
├── scripts/                # 运维脚本
└── notebooks/              # 数据探索

核心功能

• 个股投研分析：基本面 + 舆情 + 多立场辩论
• 日度投研日报：自选池批量分析
• Token优化：全链路降本
• 数据源冗余：Tushare + Akshare 自动切换

技术栈

• FastAPI + Uvicorn
• LangGraph + LangChain + Ollama
• PostgreSQL + Redis
• Tushare + Akshare

配置说明

环境变量	说明	默认值
OLLAMA_URL	Ollama服务地址	http://localhost:11434
OLLAMA_MODEL	模型名称	qwen3.5
TUSHARE_TOKEN	Tushare API Token	-
WATCHLIST	自选池（逗号分隔）	000001.SZ,...
MAX_TOKENS_PER_TASK	单次任务Token上限	8000

开发计划

• MVP骨架搭建
• 4个核心Agent实现
• LangGraph流程编排
• 数据源封装
• 数据库持久化
• LLM可切换与结构化输出校验
• 数据层缓存/重试/熔断/质量评分
• API异步任务、报告下载与分页
• 测试套件（pytest）
• 飞书推送集成
• 一级市场Agent扩展
• 一二级联动分析