TradingAgents: Khung giao dịch tài chính đa tác nhân LLM mã nguồn mở vừa cập nhật v0.4.0

Tin tức

🚀 TradingAgents | ⚡ Cài đặt & CLI | 🎬 Demo | 📦 Sử dụng gói | 🤝 Đóng góp | 📄 Trích dẫn

🎉 TradingAgents đã chính thức ra mắt! Chúng tôi đã nhận được rất nhiều câu hỏi về dự án này và xin gửi lời cảm ơn chân thành đến sự nhiệt tình của cộng đồng.

Vì vậy, chúng tôi quyết định mở mã nguồn hoàn toàn cho framework này. Rất mong được cùng các bạn xây dựng những dự án đầy tiềm năng!

Framework TradingAgents

TradingAgents là một framework giao dịch đa tác nhân (multi-agent) mô phỏng cơ chế vận hành của các công ty giao dịch thực tế. Bằng cách triển khai các tác nhân chuyên biệt được hỗ trợ bởi LLM: từ chuyên gia phân tích cơ bản, chuyên gia phân tích tâm lý thị trường, chuyên gia phân tích kỹ thuật, cho đến trader và đội ngũ quản trị rủi ro, nền tảng này sẽ cùng nhau đánh giá các điều kiện thị trường và đưa ra quyết định giao dịch. Hơn nữa, các tác nhân này còn tham gia vào các cuộc thảo luận năng động để xác định chiến lược tối ưu nhất.

Framework TradingAgents được thiết kế cho mục đích nghiên cứu. Hiệu suất giao dịch có thể thay đổi tùy thuộc vào nhiều yếu tố, bao gồm các mô hình ngôn ngữ nền tảng (backbone language models) được chọn, nhiệt độ (temperature) của mô hình, giai đoạn giao dịch, chất lượng dữ liệu và các yếu tố không xác định khác. Framework này không nhằm mục đích đưa ra lời khuyên về tài chính, đầu tư hoặc giao dịch.

Framework của chúng tôi phân tách các tác vụ giao dịch phức tạp thành các vai trò chuyên biệt.

Đội ngũ Phân tích

Đội ngũ Nghiên cứu

Tác nhân Trader

Quản trị Rủi ro và Quản lý Danh mục đầu tư

Cài đặt và CLI

Cài đặt

Sao chép (Clone) TradingAgents:

Tạo môi trường ảo trong bất kỳ trình quản lý môi trường nào bạn ưa thích:

Cài đặt gói và các phụ thuộc của nó:

Docker

Hoặc chạy bằng Docker:

Đối với các mô hình cục bộ (local models) với Ollama:

Các API bắt buộc

TradingAgents hỗ trợ nhiều nhà cung cấp LLM. Hãy thiết lập API key cho nhà cung cấp bạn đã chọn:

Đối với Azure OpenAI, hãy sao chép.env.enterprise.example thành.env.enterprise và điền thông tin xác thực của bạn.

Đối với AWS Bedrock, hãy cài đặt gói bổ sung bằng lệnh pip install ".[bedrock]", thiết lập llm_provider: "bedrock", cấu hình thông tin xác thực AWS (biến môi trường, ~/.aws/credentials, hoặc IAM role) và AWS_DEFAULT_REGION, sau đó sử dụng ID mô hình Bedrock, ví dụ: us.anthropic.claude-opus-4-8-v1:0.

Đối với các mô hình cục bộ, hãy cấu hình Ollama với llm_provider: "ollama". Endpoint mặc định là http://localhost:11434/v1; thiết lập OLLAMA_BASE_URL để trỏ đến một ollama-serve từ xa. Tải mô hình bằng lệnh ollama pull <name> và chọn "Custom model ID" trong CLI cho bất kỳ mô hình nào không được liệt kê mặc định.

Đối với bất kỳ máy chủ tương thích OpenAI nào khác (vLLM, LM Studio, llama.cpp, hoặc relay tùy chỉnh), hãy sử dụng llm_provider: "openai_compatible" và thiết lập endpoint thông qua backend_url (hoặc TRADINGAGENTS_LLM_BACKEND_URL), ví dụ: http://localhost:8000/v1 cho vLLM hoặc http://localhost:1234/v1 cho LM Studio. Mô hình sẽ là bất cứ thứ gì máy chủ của bạn cung cấp. Không cần key cho các máy chủ cục bộ; hãy thiết lập OPENAI_COMPATIBLE_API_KEY khi endpoint yêu cầu.

Hoặc sao chép.env.example thành.env và điền các key của bạn:

Sử dụng CLI

Khởi chạy CLI tương tác:

Bạn sẽ thấy một màn hình cho phép chọn các mã chứng khoán (tickers) mong muốn, ngày phân tích, nhà cung cấp LLM, độ sâu nghiên cứu, và nhiều tùy chọn khác.

Thị trường và mã chứng khoán

TradingAgents hoạt động với bất kỳ thị trường nào mà Yahoo Finance hỗ trợ, sử dụng mã chứng khoán kèm hậu tố sàn giao dịch. Danh tính công ty và chỉ số chuẩn alpha sẽ tự động được xác định theo từng thị trường.

Một giao diện sẽ xuất hiện hiển thị kết quả khi chúng được tải, cho phép bạn theo dõi tiến trình của tác nhân trong khi nó hoạt động.

Gói TradingAgents