TradingAgents/docs/zh-CN/quick_reference.md

TradingAgents 快速参考卡片

🚀 快速开始

1. 修改LLM提供商

# 编辑 main.py
config["llm_provider"] = "google"  # 或 "openai", "anthropic"
config["backend_url"] = "https://generativelanguage.googleapis.com/v1"
config["deep_think_llm"] = "gemini-2.0-flash"
config["quick_think_llm"] = "gemini-2.0-flash"

2. 修改辩论轮数

# 编辑 main.py 或 default_config.py
config["max_debate_rounds"] = 3  # 增加到3轮
config["max_risk_discuss_rounds"] = 2  # 风险讨论2轮

3. 启用/禁用在线工具

config["online_tools"] = True   # 启用在线API
config["online_tools"] = False  # 使用本地数据

📁 关键文件位置

需要修改的内容	文件路径	具体位置
系统配置	tradingagents/default_config.py	整个文件
运行时配置	main.py	第15-22行
市场分析师提示词	tradingagents/agents/analysts/market_analyst.py	第24-50行
基本面分析师提示词	tradingagents/agents/analysts/fundamentals_analyst.py	第23-26行
新闻分析师提示词	tradingagents/agents/analysts/news_analyst.py	第20-23行
社媒分析师提示词	tradingagents/agents/analysts/social_media_analyst.py	第19-22行
多头研究员提示词	tradingagents/agents/researchers/bull_researcher.py	第25-43行
空头研究员提示词	tradingagents/agents/researchers/bear_researcher.py	第25-43行
交易员提示词	tradingagents/agents/trader/trader.py	第30-36行
反思系统提示词	tradingagents/graph/reflection.py	第15-47行
缓存配置	tradingagents/dataflows/cache_manager.py	第20-35行

🎯 常用修改模板

1. 中文化提示词模板

system_message = f"""
您是一位专业的{role_name}，具有以下特点：

专业领域：
- {domain_1}
- {domain_2}
- {domain_3}

分析要求：
1. 使用中文进行分析
2. 提供详细的分析理由
3. 包含风险提示
4. 以表格形式总结关键指标

输出格式：
{output_format}

注意事项：
- 避免简单地说"趋势混合"
- 提供具体的数据支持
- 考虑中国市场特色因素
"""

2. 风险控制模板

system_message = f"""
您是一位风险意识强烈的{role_name}。

风险控制原则：
1. 风险第一，收益第二
2. 严格止损，保护本金
3. 分散投资，降低风险
4. 基于数据，理性决策

必须包含：
- 风险评估等级（低/中/高）
- 建议止损点位
- 最大仓位建议
- 风险提示说明

决策格式：
最终建议: **买入/持有/卖出**
风险等级: **低/中/高**
止损点位: **具体价格**
建议仓位: **百分比**
"""

3. 技术分析专用模板

system_message = f"""
您是一位专业的技术分析师，专注于以下指标：

核心指标：
- 移动平均线：SMA、EMA
- 动量指标：RSI、MACD
- 波动率指标：布林带、ATR
- 成交量指标：VWMA

分析框架：
1. 趋势识别（上升/下降/横盘）
2. 支撑阻力位确定
3. 买卖信号识别
4. 风险收益比计算

输出要求：
- 明确的趋势判断
- 具体的进出场点位
- 技术指标背离分析
- 量价关系分析
"""

⚙️ 配置参数速查

LLM配置

"llm_provider": "openai" | "google" | "anthropic"
"deep_think_llm": "模型名称"  # 深度思考模型
"quick_think_llm": "模型名称"  # 快速思考模型
"backend_url": "API地址"

Google模型快速参考

# 快速模型: gemini-2.0-flash-lite, gemini-2.0-flash ⭐, gemini-2.5-flash-preview-05-20
# 深度模型: gemini-2.0-flash ⭐, gemini-2.5-flash-preview-05-20, gemini-2.5-pro-preview-06-05

# Google API设置
export GOOGLE_API_KEY="your_key_here"

辩论配置

"max_debate_rounds": 1-5        # 辩论轮数
"max_risk_discuss_rounds": 1-3  # 风险讨论轮数
"max_recur_limit": 100          # 递归限制

工具配置

"online_tools": True | False    # 是否使用在线工具
"data_cache_dir": "缓存目录路径"
"results_dir": "结果输出目录"

缓存配置

# 在cache_manager.py中
'us_stock_data': {'ttl_hours': 2}     # 美股缓存2小时
'china_stock_data': {'ttl_hours': 1}  # A股缓存1小时

🔧 常用命令

测试配置

# 运行基础测试
cd tests && python test_cache_manager.py

# 运行集成测试
cd tests && python test_integration.py

# 运行性能测试
cd tests && python test_performance.py

备份与恢复

# 备份配置文件
cp tradingagents/default_config.py tradingagents/default_config.py.backup

# 备份提示词文件
cp tradingagents/agents/trader/trader.py tradingagents/agents/trader/trader.py.backup

# 恢复文件
cp tradingagents/default_config.py.backup tradingagents/default_config.py

Git管理

# 查看修改状态
git status

# 提交配置更改
git add tradingagents/default_config.py
git commit -m "feat: 更新LLM配置为Google Gemini"

# 提交提示词更改
git add tradingagents/agents/trader/trader.py
git commit -m "feat: 优化交易员提示词，增加风险控制"

🚨 注意事项

⚠️ 修改前必做

1. 备份文件: 修改前务必备份原文件
2. 测试环境: 在测试环境中验证修改效果
3. 版本控制: 使用Git跟踪所有更改

⚠️ 常见错误

1. 忘记重启: 修改配置后需要重启应用
2. 路径错误: 确保文件路径正确
3. 语法错误: Python语法必须正确
4. 编码问题: 中文内容使用UTF-8编码

⚠️ 性能考虑

1. 提示词长度: 避免过长的提示词（建议<4000 tokens）
2. API调用频率: 注意API调用限制
3. 缓存设置: 合理设置缓存TTL时间

🆘 故障排除

问题：配置不生效

# 解决方案：强制重新加载配置
from tradingagents.dataflows.config import reload_config
reload_config()

问题：中文显示乱码

# 解决方案：确保文件编码为UTF-8
# 在文件开头添加编码声明
# -*- coding: utf-8 -*-

问题：API调用失败

# 解决方案：检查API密钥和网络连接
import os
print("OpenAI API Key:", os.getenv("OPENAI_API_KEY", "未设置"))
print("Google API Key:", os.getenv("GOOGLE_API_KEY", "未设置"))

问题：内存使用过高

# 解决方案：启用缓存清理
config["cache_settings"]["cache_size_limit_mb"] = 500  # 限制缓存大小
config["cache_settings"]["cache_cleanup_interval"] = 1800  # 30分钟清理一次

📞 获取帮助

1. 查看详细文档: docs/configuration_guide.md
2. 运行测试: tests/ 目录下的测试文件
3. 查看示例: examples/ 目录（如果有）
4. GitHub Issues: 在项目仓库提交问题

---

💡 提示: 建议将此文档保存为书签，方便随时查阅！