模型 / 資料集
TauricResearch/TradingAgents avatar
TauricResearch/TradingAgents

TradingAgents:用於交易研究的多智能體LLM框架

TradingAgents 協調專門的語言模型代理進行市場研究、辯論、風險審查和模擬交易決策。

106,586 個 Star20,375 個 ForkPythonApache-2.0

秒懂

它是什麼?
一個 Python 框架,結合分析師、研究員、交易員和風險管理智能體來產生交易決策,支援可選的持久化和檢查點恢復。
適合誰用?
該儲存庫以 Apache-2.0 授權釋出,並明確將其定位為研究工具而非金融建議。它的價值在於為研究多智能體 LLM 決策流程提供了結構,使用者應預期每次執行的結果會有差異。
可以商用嗎?
可以。Apache-2.0 是寬鬆授權:你可以使用、修改並販售以它為基礎的軟體,只需保留著作權與授權聲明。
還在維護嗎?
有在維護。儲存庫最近一次提交在 1 天前。
用什麼語言寫的?
主要是 Python(依據 GitHub 的語言統計)。

以上回答依據專案的 GitHub 資料(最近同步於 2026年9月15日)與我們的分析,不構成法律意見。

開源專案深度解析

TradingAgents:交易流程中的智能體角色

TradingAgents 將交易公司建模為一組專門化的智能體。分析師團隊涵蓋四個面向:基本面、情緒、新聞和技術分析。情緒分析聚合頭條新聞、StockTwits 和 Reddit;技術分析使用 MACD 和 RSI 等指標。隨後,由看漲和看跌研究員組成的團隊對分析師輸出進行辯論,交易員智能體將這些報告整合為關於時機和規模的決策。風險管理審查波動性、流動性和其他因素,投資組合經理在交易被傳送到模擬交易所之前批准或拒絕該提議。該框架使用 LangGraph 建置,並旨在用於研究而非生產交易。(TradingAgents 1-1)

在 TauricResearch/TradingAgents 的脈絡中,這一節只能由 README 已列出的入口來核對。請以 TauricResearch/TradingAgents 的 README、main 分支內容與 releases 頁面確認版本,再保留實際命令輸出、設定鍵和錯誤訊息。素材未說明的效能、相容性、故障恢復或安全保證,不應從專案描述、star 數或單一範例推導。若要驗證本節,應選取一個與 TradingAgents 直接相關的最小輸入,觀察輸出檔案、API 回應或終端日誌,並把成功與失敗結果分開記錄。(章節 1)

TauricResearch/TradingAgents 第 1 節的入口還要和相鄰章節分開看:TradingAgents README 明確寫出的命令、檔名或 API 只支持它所描述的範圍。執行時應保存輸入內容、程式版本和輸出結果,遇到錯誤則記錄完整訊息,不把一次成功執行延伸成所有平台都能成功。

TauricResearch/TradingAgents 第 1 節的採用邊界,取決於 README 具體列出的版本與執行條件。測試時先檢查 TradingAgents 的安裝入口是否成功,再逐項比對輸入、輸出和日誌;若需要外部服務、容器、憑證或特定作業系統,應把該條件寫入紀錄。TradingAgents README 沒有描述的行為仍屬未知,不能用相似工具的經驗代替。

TradingAgents:安裝與互動式命令列

README 中的安裝路徑是先進行 git clone,然後建立 Python 3.12 虛擬環境並執行 `pip install .`。還提供了 Docker Compose 選項,其中包含標準映像檔和基於 Ollama 的本地模型設定的單獨設定檔。使用者需要為所選 LLM 提供者設定 API 金鑰;README 列出了 OpenAI、Google、Anthropic、xAI、DeepSeek、Qwen、GLM、MiniMax、OpenRouter 和 Alpha Vantage 的環境變數,以及用於 Azure OpenAI 的企業檔案。安裝後,可以透過 `tradingagents` 或 `python -m cli.main` 啟動命令列。介面接受股票代碼、分析日期、提供者和研究深度。股票代碼遵循 Yahoo Finance 約定,因此香港、東京、倫敦、印度、加拿大、澳洲、中國 A 股和加密貨幣對可使用諸如 `0700.HK` 或 `BTC-USD` 這樣的交易所後綴。(TradingAgents 2-1)

在 TauricResearch/TradingAgents 的脈絡中,這一節只能由 README 已列出的入口來核對。請以 TauricResearch/TradingAgents 的 README、main 分支內容與 releases 頁面確認版本,再保留實際命令輸出、設定鍵和錯誤訊息。素材未說明的效能、相容性、故障恢復或安全保證,不應從專案描述、star 數或單一範例推導。若要驗證本節,應選取一個與 TradingAgents 直接相關的最小輸入,觀察輸出檔案、API 回應或終端日誌,並把成功與失敗結果分開記錄。(章節 2)

TauricResearch/TradingAgents 第 2 節的入口還要和相鄰章節分開看:TradingAgents README 明確寫出的命令、檔名或 API 只支持它所描述的範圍。執行時應保存輸入內容、程式版本和輸出結果,遇到錯誤則記錄完整訊息,不把一次成功執行延伸成所有平台都能成功。

TauricResearch/TradingAgents 第 2 節的採用邊界,取決於 README 具體列出的版本與執行條件。測試時先檢查 TradingAgents 的安裝入口是否成功,再逐項比對輸入、輸出和日誌;若需要外部服務、容器、憑證或特定作業系統,應把該條件寫入紀錄。TradingAgents README 沒有描述的行為仍屬未知,不能用相似工具的經驗代替。

TradingAgents:作為 Python 套件使用框架

應用程式可以從 `tradingagents.graph.trading_graph` 匯入 `TradingAgentsGraph`,並呼叫 `propagate` 並傳入股票代碼和日期來取得決策。預設設定來自 `tradingagents.default_config.DEFAULT_CONFIG`,可以複製並調整。README 展示了設定 `llm_provider`、`deep_think_llm`、`quick_think_llm` 和 `max_debate_rounds` 的範例。支援的提供者包括 OpenAI、Google、Anthropic、xAI、DeepSeek、Qwen、GLM、MiniMax、OpenRouter、Ollama、Azure OpenAI 以及任何相容 OpenAI 的端點。README 指出 `tradingagents/default_config.py` 提供了完整選項清單。(TradingAgents 3-1)

在 TauricResearch/TradingAgents 的脈絡中,這一節只能由 README 已列出的入口來核對。請以 TauricResearch/TradingAgents 的 README、main 分支內容與 releases 頁面確認版本,再保留實際命令輸出、設定鍵和錯誤訊息。素材未說明的效能、相容性、故障恢復或安全保證,不應從專案描述、star 數或單一範例推導。若要驗證本節,應選取一個與 TradingAgents 直接相關的最小輸入,觀察輸出檔案、API 回應或終端日誌,並把成功與失敗結果分開記錄。(章節 3)

TauricResearch/TradingAgents 第 3 節的入口還要和相鄰章節分開看:TradingAgents README 明確寫出的命令、檔名或 API 只支持它所描述的範圍。執行時應保存輸入內容、程式版本和輸出結果,遇到錯誤則記錄完整訊息,不把一次成功執行延伸成所有平台都能成功。

TauricResearch/TradingAgents 第 3 節的採用邊界,取決於 README 具體列出的版本與執行條件。測試時先檢查 TradingAgents 的安裝入口是否成功,再逐項比對輸入、輸出和日誌;若需要外部服務、容器、憑證或特定作業系統,應把該條件寫入紀錄。TradingAgents README 沒有描述的行為仍屬未知,不能用相似工具的經驗代替。

TradingAgents:持久化與檢查點恢復

文件說明了兩種狀態機制。決策日誌始終開啟:每次完成的執行都會將其決策附加到 `~/.tradingagents/memory/trading_memory.md`。在後續針對同一股票代碼的執行中,框架會取得已實現的報酬,產生一段反思,並將最近的同代碼決策以及跨代碼的經驗注入投資組合經理提示。可以使用 `TRADINGAGENTS_MEMORY_LOG_PATH` 覆寫該路徑。檢查點恢復透過 `--checkpoint` 可選啟用。LangGraph 在每個節點後儲存狀態,因此中斷的執行可以從最後成功的步驟恢復,而不是重新開始。檢查點儲存在 `~/.tradingagents/cache/checkpoints/` 下按股票代碼分類的 SQLite 資料庫中,`--clear-checkpoints` 可重設它們。(TradingAgents 4-1)

在 TauricResearch/TradingAgents 的脈絡中,這一節只能由 README 已列出的入口來核對。請以 TauricResearch/TradingAgents 的 README、main 分支內容與 releases 頁面確認版本,再保留實際命令輸出、設定鍵和錯誤訊息。素材未說明的效能、相容性、故障恢復或安全保證,不應從專案描述、star 數或單一範例推導。若要驗證本節,應選取一個與 TradingAgents 直接相關的最小輸入,觀察輸出檔案、API 回應或終端日誌,並把成功與失敗結果分開記錄。(章節 4)

TauricResearch/TradingAgents 第 4 節的入口還要和相鄰章節分開看:TradingAgents README 明確寫出的命令、檔名或 API 只支持它所描述的範圍。執行時應保存輸入內容、程式版本和輸出結果,遇到錯誤則記錄完整訊息,不把一次成功執行延伸成所有平台都能成功。

TauricResearch/TradingAgents 第 4 節的採用邊界,取決於 README 具體列出的版本與執行條件。測試時先檢查 TradingAgents 的安裝入口是否成功,再逐項比對輸入、輸出和日誌;若需要外部服務、容器、憑證或特定作業系統,應把該條件寫入紀錄。TradingAgents README 沒有描述的行為仍屬未知,不能用相似工具的經驗代替。

TradingAgents:可重現性的限制與已錨定的內容

README 明確指出,相同股票代碼和日期的重複執行可能會產生不同結果。LLM 取樣即使在固定溫度下也是非確定性的,推理模型由於內部推理本身被取樣而波動最大。新聞、StockTwits 和 Reddit 等即時資料來源也會在執行之間發生變化。降低 `temperature` 可能對遵循該參數的模型有幫助,但目前精選的推理優先模型在很大程度上忽略溫度。README 聲明,公司身份在任何智能體執行之前就已確定性解析,市場分析師將價格和指標聲明錨定在經過驗證的資料快照中。回測結果不保證與任何已發布數字一致,框架應被視為研究脚手架,而非固定報酬的策略。(TradingAgents 5-1)

在 TauricResearch/TradingAgents 的脈絡中,這一節只能由 README 已列出的入口來核對。請以 TauricResearch/TradingAgents 的 README、main 分支內容與 releases 頁面確認版本,再保留實際命令輸出、設定鍵和錯誤訊息。素材未說明的效能、相容性、故障恢復或安全保證,不應從專案描述、star 數或單一範例推導。若要驗證本節,應選取一個與 TradingAgents 直接相關的最小輸入,觀察輸出檔案、API 回應或終端日誌,並把成功與失敗結果分開記錄。(章節 5)

TauricResearch/TradingAgents 第 5 節的入口還要和相鄰章節分開看:TradingAgents README 明確寫出的命令、檔名或 API 只支持它所描述的範圍。執行時應保存輸入內容、程式版本和輸出結果,遇到錯誤則記錄完整訊息,不把一次成功執行延伸成所有平台都能成功。

TauricResearch/TradingAgents 第 5 節的採用邊界,取決於 README 具體列出的版本與執行條件。測試時先檢查 TradingAgents 的安裝入口是否成功,再逐項比對輸入、輸出和日誌;若需要外部服務、容器、憑證或特定作業系統,應把該條件寫入紀錄。TradingAgents README 沒有描述的行為仍屬未知,不能用相似工具的經驗代替。

TradingAgents:授權與研究範圍

該儲存庫使用 Apache-2.0 授權,該授權授予複製、分發和修改的版權和專利授權,但須遵守授權文字中的條款。授權摘錄未聲明任何保證、支援承諾或安全保證。README 本身表示該框架是出於研究目的設計的,交易表現取決於模型選擇、溫度、資料品質和其他因素,並且它不是財務、投資或交易建議。README 中包含了 arXiv 論文的引用資訊。(TradingAgents 6-1)

在 TauricResearch/TradingAgents 的脈絡中,這一節只能由 README 已列出的入口來核對。請以 TauricResearch/TradingAgents 的 README、main 分支內容與 releases 頁面確認版本,再保留實際命令輸出、設定鍵和錯誤訊息。素材未說明的效能、相容性、故障恢復或安全保證,不應從專案描述、star 數或單一範例推導。若要驗證本節,應選取一個與 TradingAgents 直接相關的最小輸入,觀察輸出檔案、API 回應或終端日誌,並把成功與失敗結果分開記錄。(章節 6)

TauricResearch/TradingAgents 第 6 節的入口還要和相鄰章節分開看:TradingAgents README 明確寫出的命令、檔名或 API 只支持它所描述的範圍。執行時應保存輸入內容、程式版本和輸出結果,遇到錯誤則記錄完整訊息,不把一次成功執行延伸成所有平台都能成功。

TauricResearch/TradingAgents 第 6 節的採用邊界,取決於 README 具體列出的版本與執行條件。測試時先檢查 TradingAgents 的安裝入口是否成功,再逐項比對輸入、輸出和日誌;若需要外部服務、容器、憑證或特定作業系統,應把該條件寫入紀錄。TradingAgents README 沒有描述的行為仍屬未知,不能用相似工具的經驗代替。

編輯結論

該儲存庫以 Apache-2.0 授權釋出,並明確將其定位為研究工具而非金融建議。它的價值在於為研究多智能體 LLM 決策流程提供了結構,使用者應預期每次執行的結果會有差異。 適合能依 TauricResearch/TradingAgents README 管理相依環境、版本與輸出的人;不適合把 README 的功能清單當成未經條件限制的服務承諾。先執行 README 所列的最小命令或入口,核對 TradingAgents 的實際輸入、輸出、錯誤訊息與資料保存位置,再決定是否放入正式工作負載;Apache-2.0 授權下的再發布與修改責任也要由部署者依 LICENSE 原文確認。

官方來源

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
社群筆記

社群筆記