Alpaca 多智能体交易工作台

这个 Agent 能做什么，适合哪些场景？

AlpacaTradingAgent 是一个基于 LangGraph 的多智能体交易框架，面向希望连接 Alpaca 账户的股票与加密资产用户。它由五类分析师、看涨与看跌研究员、Trader 以及风险与投资组合管理组件组成，可并行收集市场、社交情绪、新闻、基本面和宏观信息，再形成交易决策。用户可通过 Python 包、CLI 或 Dash Web UI 使用它，也可选择 Docker Compose 启动界面。项目支持 Alpaca 模拟和实盘账户，并提供定时分析与可选自动执行。运行需要配置 Alpaca 和相应数据或模型提供商凭据；仓库声明该软件仅供教育和研究使用，不构成投资建议。

用户在 CLI、Web UI 或 Python 中提供股票代码或如 BTC/USD 的加密资产代码及分析日期。TradingAgentsGraph.propagate 根据配置调用市场数据、新闻、社交情绪、基本面和宏观数据来源；五名分析师可并行运行，研究员再通过结构化辩论审视观点，Trader 汇总结果并生成 BUY/HOLD/SELL 或 LONG/NEUTRAL/SHORT 决策。配置 Alpaca 凭据后，界面可查看持仓和订单、下单或清算持仓；也可启用定时分析和可选自动执行。完成的决策会写入 Markdown 记忆日志，失败的 LangGraph 运行可选择通过 SQLite 检查点恢复。

1. 量化研究者希望用多个分析角色比较 NVDA 等股票的市场、新闻、基本面和宏观信号。
2. Alpaca 用户希望先在模拟账户中分析股票与 BTC/USD 等加密资产的混合组合。
3. 开发者希望在 Python 程序中调用 TradingAgentsGraph.propagate 并处理其决策结果。
4. 交易者希望通过 Dash 界面查看分析进度、报告、图表、当前持仓和近期订单。
5. 希望在市场时段定期分析的用户，可配置周期任务，并自行决定是否启用自动执行。

如何安装或部署这个 Agent？

需要 Python 环境及项目所需的 API 凭据。README 将 Alpaca API 用于交易，Finnhub 用于股票新闻和数据，FRED 用于宏观分析，CoinDesk/CryptoCompare 用于加密新闻；LLM 可选多家云服务或本地 OpenAI 兼容端点。复制示例环境文件并填写所需配置：

git clone https://github.com/huygiatrng/AlpacaTradingAgent.git
cd AlpacaTradingAgent
pip install -r requirements.txt
cp env.sample .env

在 .env 中填写 API 密钥；测试交易可设置 ALPACA_USE_PAPER=True。没有有效 Alpaca 密钥时，应用会回退到不具备交易能力的演示模式。也可在填写 .env 后用 Docker Compose 构建并启动 Web UI：

docker compose up -d --build

如何使用这个 Agent？

启动 CLI：

python -m cli.main

启动 Dash Web UI：

python run_webui_dash.py

CLI 会提示输入资产并允许选择提供商、模型及相关参数。Python 首次调用示例：

from tradingagents.graph.trading_graph import TradingAgentsGraph
from tradingagents.default_config import DEFAULT_CONFIG

ta = TradingAgentsGraph(debug=True, config=DEFAULT_CONFIG.copy())
_, decision = ta.propagate("NVDA", "2024-05-10")
print(decision)

加密资产可使用 BTC/USD 格式。连接真实或模拟账户进行交易前，需先在配置中设置 Alpaca 凭据和账户模式；自动执行为可选项。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题