跳到主要内容

CLI 使用指南

TradingAgents 提供了一个用户友好的命令行界面（CLI），让您无需编写代码即可与框架交互。CLI 为股票分析和交易决策提供了交互式体验。

启动 CLI​

启动 CLI 界面：

python -m cli.main

此命令将启动一个交互式会话，您可以在其中配置分析参数并实时查看结果。

CLI 界面概述​

CLI 提供结构化的工作流程：

  1. 初始配置屏幕：选择股票代码、日期、模型和分析深度
  2. 进度跟踪：在分析运行时监控智能体进度
  3. 结果显示：查看全面的交易决策和推理

配置选项​

股票选择​

  • 单个股票代码：分析一只特定股票（例如：NVDA、AAPL）
  • 多个股票代码：同时比较多只股票
  • 热门选择：从常分析的股票中快速选择

日期选择​

  • 特定日期：选择历史分析的确切日期
  • 日期范围：分析多天的趋势
  • 最新数据：使用最近可用的交易日

模型选择​

根据您的需求选择 LLM 模型：

生产分析：

  • 深度思考：o1-preview 用于复杂推理
  • 快速思考：gpt-4o 用于快速响应

测试（成本效益）：

  • 深度思考：gpt-4o-mini
  • 快速思考：gpt-4o-mini

研究深度​

控制分析的彻底程度：

  • 快速（1轮）：快速分析，最少辩论
  • 标准（2-3轮）：平衡分析，适度辩论
  • 深度（4-5轮）：全面分析，广泛辩论

交互功能​

实时进度​

CLI 显示智能体工作的实时更新：

  • 智能体激活状态
  • 当前分析阶段
  • 数据收集进度
  • 辩论轮次完成情况

智能体活动显示​

监控各个智能体的贡献：

  • 基本面分析师：公司财务分析
  • 情绪分析师：市场情绪评估
  • 新闻分析师：最新新闻影响评估
  • 技术分析师：图表模式和指标分析
  • 研究员：看涨与看跌辩论过程
  • 风险管理：风险评估和投资组合影响

决策输出​

查看全面结果，包括：

  • 最终建议：买入/卖出/持有决策
  • 置信度评分：决策确定性水平
  • 关键推理：分析因素摘要
  • 风险评估：识别的风险和缓解措施
  • 智能体共识：智能体之间的一致性水平

CLI 工作流程示例​

以下是典型的 CLI 会话流程：

$ python -m cli.main

┌─────────────────────────────────────────────┐
│          TradingAgents CLI v1.0             │
│     多智能体交易分析                         │
└─────────────────────────────────────────────┘

选择股票代码: NVDA
分析日期: 2024-05-10
深度思考模型: gpt-4o-mini
快速思考模型: gpt-4o-mini
研究深度: 标准（3轮）
在线工具: 是

开始分析...

[1/6] 初始化智能体... ✓
[2/6] 收集市场数据... ✓
[3/6] 运行个别分析...
  └─ 基本面分析师: 分析财务数据... ✓
  └─ 情绪分析师: 处理情绪数据... ✓
  └─ 新闻分析师: 审查最新新闻... ✓
  └─ 技术分析师: 计算指标... ✓

[4/6] 研究员辩论（第1/3轮）...
  └─ 看涨研究员: 提出看涨论证... ✓
  └─ 看跌研究员: 提出看跌论证... ✓
  └─ 辩论解决: 寻找共识... ✓

[5/6] 风险评估...
  └─ 风险管理员: 评估投资组合影响... ✓
  └─ 投资组合经理: 最终审查... ✓

[6/6] 生成交易决策... ✓

═══════════════════════════════════════════════
            交易决策报告
═══════════════════════════════════════════════

股票代码: NVDA
日期: 2024-05-10
决策: 买入
置信度: 8.5/10

关键因素:
• 强劲的收益增长轨迹
• 积极的AI市场情绪
• 技术突破确认
• 可管理的风险概况

风险警告:
• 预期高波动性
• 市值集中风险
• 板块轮动可能性

智能体共识: 4/4 分析师积极
辩论结果: 看涨论证更强
风险水平: 中等

═══════════════════════════════════════════════

CLI 命令和快捷键​

分析期间​

  • Ctrl+C：取消当前分析
  • Enter：跳到下一阶段（如适用）
  • Space：切换详细日志记录

结果导航​

  • ↑/↓：滚动浏览详细结果
  • Tab：在结果部分之间切换
  • Q：退出并返回主菜单

配置文件​

CLI 可以保存和加载配置：

保存配置​

# 将当前设置保存为默认配置
python -m cli.main --save-config default.json

# 使用自定义名称保存
python -m cli.main --save-config my_analysis.json

加载配置​

# 加载保存的配置
python -m cli.main --load-config default.json

# 使用预设快速分析
python -m cli.main --preset quick_analysis

批量处理​

对于多个分析：

# 分析多个股票代码
python -m cli.main --batch tickers.txt --date 2024-05-10

# 时间序列分析
python -m cli.main --ticker NVDA --date-range 2024-05-01:2024-05-10

输出选项​

导出结果​

  • JSON：机器可读格式
  • CSV：电子表格兼容
  • PDF：人类可读报告
  • TXT：简单文本摘要
# 导出到文件
python -m cli.main --export results.json --format json

日志级别​

控制 CLI 详细程度：

  • 最小：仅最终决策
  • 标准：关键里程碑和结果
  • 详细：完整的智能体通信
  • 调试：完整跟踪信息

性能优化​

更快分析​

  • 使用 gpt-4o-mini 模型
  • 将研究深度设置为"快速"
  • 禁用详细日志记录
  • 使用缓存数据模式

全面分析​

  • 使用 o1-preview 进行深度思考
  • 将研究深度设置为"深度"
  • 启用在线工具
  • 启用详细日志记录

CLI 问题故障排除​

常见问题​

CLI 无法启动：

# 检查 Python 版本
python --version

# 验证安装
pip list | grep tradingagents

API 连接错误：

# 验证环境变量
echo $OPENAI_API_KEY
echo $FINNHUB_API_KEY

性能问题：

  • 切换到较小的模型
  • 降低研究深度
  • 检查在线工具的互联网连接

下一步​

掌握 CLI 后：