一、简介
欢迎阅读《交易流水分析项目》 说明文档。
二、环境说明
1. 项目开发语言是python，版本 3.10+
2. IDE建议 PyCharm
3. 源码git地址：https://git.yangzhiqiang.tech/jiaqiang/tx_flow_analysis/
4. 依赖包安装指令如下（说明：会自动安装依赖的包）
pip install langchain
pip install langchain_openai
pip install fastapi
pip install uvicorn
pip install pdfplumber   (pdf交易流水单解析需要)

三、使用说明
==========

1. 环境准备：
   # 安装依赖
   pip install -r requirements.txt

   # 配置API密钥
   cp env_example.txt .env
   # 编辑 .env 文件，填入你的 DEEPSEEK_API_KEY

2. 批量运行工作流（推荐）：
   # 方法1：通过模块运行（推荐）
   python -m llmops

   # 方法2：直接执行文件（适用于PyCharm）
   python llmops/batch_runner.py

   # 如果需要修改参数，请直接编辑 llmops/batch_runner.py 中的配置参数：
   # RUNS = 2         # 运行次数
   # INDUSTRY = "农业"  # 行业
   # DATA_FILE = "data_files/交易流水样例数据.csv"  # 数据文件
   # QUESTION = "..."  # 查询问题

⚠️ 重要：如果遇到依赖版本冲突，请参考 RUN_GUIDE.md 中的解决方案

四、日志管理
==========

每次运行会创建独立的日志文件夹：
- api_results_1/     # 第一次运行
- api_results_2/     # 第二次运行
- api_results_3/     # 第三次运行
- ...

这样便于整理和对比不同运行的结果。

五、学习资源
==========

📚 **练习手册**: [PRACTICE_GUIDE.md](PRACTICE_GUIDE.md)
- LangChain & LangGraph Agent开发详细教程
- 从基础概念到项目实践的完整学习路径
- 包含6个学习阶段，20+个具体练习
- 适合想要深入学习Agent开发的开发者