tx_flow_analysis

一、简介
欢迎阅读《交易流水分析项目》 说明文档。
二、环境说明
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开发的开发者