Cấu hình API TradingAgents

Bắt đầu với câu hỏi nghiên cứu có phiên bản

Đặt provider tương thích, URL backend tùy chỉnh và hai vai trò model, rồi kiểm tra một công ty tại ngày nghiên cứu xác định. TradingAgents tổ chức nhà phân tích, lập luận nghiên cứu đối lập và rà soát rủi ro, nên tác vụ đầu hữu ích là kiểm tra các vai trò đó giải thích cùng gói nguồn thế nào. Chọn công ty và thời điểm chốt trước khi đổi model. Giữ dữ kiện nền và mục chưa giải quyết từ lần đầu để so sánh model sau dùng cùng câu hỏi. Các trường bên dưới theo revision service 9dee508c.

Cấu hình provider tương thích và cả hai vai trò model

default_config.py được rà soát cung cấp llm_provider, backend_url, deep_think_llm và quick_think_llm. Client tương thích dùng endpoint được cung cấp; xác thực là cài đặt môi trường riêng. Cả hai slot vai trò cần mã định danh model chính xác mà endpoint đã chọn và client project chấp nhận. Ví dụ điều chỉnh các trường nguồn đó và chỉ dựng cấu hình. Đặt RESEARCH_MODEL_ID và SUMMARY_MODEL_ID từ catalog hiện tại sau khi kiểm tra năng lực bắt buộc. Đây là slot môi trường local, không phải model ID hay mặc định TradingAgents. Giữ credential trong môi trường process, không trong script.

import os
from copy import deepcopy
from tradingagents.default_config import DEFAULT_CONFIG

config = deepcopy(DEFAULT_CONFIG)
config.update({
    "llm_provider": "openai_compatible",
    "backend_url": "https://api.apisrouter.com/v1",
    "deep_think_llm": os.environ["RESEARCH_MODEL_ID"],
    "quick_think_llm": os.environ["SUMMARY_MODEL_ID"],
    "max_debate_rounds": 1,
    "max_risk_discuss_rounds": 1,
})
assert os.environ["OPENAI_COMPATIBLE_API_KEY"]
# Configuration only. This does not start a research run.

Tách route model khỏi dữ liệu tài chính

Cấu hình vendor dữ liệu tài chính độc lập với endpoint model. Với cổ phiếu quốc tế, giải quyết tổ chức phát hành và mã theo sở giao dịch trước khi thu thập. Giữ tiền tệ giao dịch, tiền tệ báo cáo, múi giờ thị trường và benchmark. Chứng chỉ lưu ký Mỹ và cổ phiếu thường gốc cần quy tắc chuyển đổi rõ trước khi so sánh chuỗi giá. Sơ đồ cho thấy cài đặt model kết nối ra sao; tool dữ liệu tài chính giữ credential, phạm vi và timestamp nguồn riêng. Kiểm tra tool đó trước khi chẩn đoán input nghiên cứu thiếu là lỗi LLM.

Chọn vai trò theo hợp đồng tác vụ

Kiểm tra năng lực mỗi vai trò thực sự dùng. Một reply văn bản không xác lập parse tool call, xử lý ngữ cảnh dài hay hành vi output có cấu trúc. Đổi họ model cũng có thể đổi hành vi adapter provider dù endpoint nhận mã định danh. Bắt đầu bằng tập vai trò hữu ích nhỏ nhất; chỉ thêm tranh luận khi nó tìm khẳng định không được hỗ trợ hoặc bằng chứng phản biện hữu ích. Đánh giá artifact cuối theo cùng gói nguồn thay vì coi báo cáo dài hơn là nghiên cứu tốt hơn.

Dùng kiểm tra chấp nhận theo giai đoạn cho lần chạy đầu

Trước tiên kiểm tra cấu hình đã giải quyết mà không in key. Tiếp theo, trong môi trường thực thi được ủy quyền, chạy client dự án với model đã chọn và giữ record request đã làm sạch. Sau đó kiểm tra một tương tác tool bắt buộc cùng đường lỗi. Cuối cùng chạy TradingAgentsGraph với tập nguồn có phạm vi rồi kiểm tra state, dữ kiện được trích và output nghiên cứu cuối. Lưu revision repository, phiên bản phụ thuộc, hash input và cài đặt vai trò. Response factory chỉ đạt giai đoạn client; báo cáo hoàn chỉnh vẫn cần rà soát nguồn và số trước khi tính artifact nghiên cứu dùng được.

import os
from research_config import config
from tradingagents.graph.trading_graph import TradingAgentsGraph

graph = TradingAgentsGraph(debug=False, config=config)
state, decision = graph.propagate(
    os.environ["RESEARCH_TICKER"],
    os.environ["RESEARCH_DATE"],
)
# Inspect state and decision against the source packet.
# Running this template makes model and data requests.

Bảo vệ nghiên cứu lịch sử khỏi thông tin về sau

Ngày phân tích yêu cầu không chứng minh mọi response vendor là theo thời điểm. Kiểm tra fundamentals có thực sự sẵn trước thời điểm chốt, bài viết có bị sửa sau và dữ liệu cache có đến từ thí nghiệm khác không. Giữ thời điểm công bố gốc và thời điểm ingest riêng. Giữ feedback huấn luyện hoặc reflection ngoài kỳ đánh giá holdout. Danh sách ticker lịch sử phải gồm hủy niêm yết và đổi mã liên quan. Ghi cách xử lý hành động doanh nghiệp và benchmark cạnh mỗi thí nghiệm để đổi model không bị nhầm thành đổi dữ liệu.

Lập ngân sách tranh luận, thử lại và ngữ cảnh lặp

Chi tiêu agent tài chính đến từ mọi request trong đồ thị, gồm tóm tắt, ngữ cảnh lặp và retry tính phí. Dùng hợp đồng giá hiện tại để lập kế hoạch và đối soát usage thực sau. Giới hạn vòng tranh luận, khối lượng nguồn, job song song và retry tự động trước sweep. Cache trích xuất nguồn theo phiên bản tài liệu; phân biệt tái sử dụng ứng dụng với giảm giá thanh toán provider. Theo dõi thuê bao dữ liệu và compute local riêng với phí LLM, rồi so chi phí mỗi artifact nghiên cứu được chấp nhận. Bắt đầu bằng lần chạy có phạm vi trên trước khi mở rộng vũ trụ ticker và ngày.

Chẩn đoán giai đoạn đã thất bại

Với lỗi xác thực, xác minh key provider tương thích tới đúng process tạo client. Với model thiếu, so ID chính xác và quyền tài khoản với catalog hiện tại. Với output tool sai định dạng, giữ schema tool và response đã làm sạch thay vì chỉ exception cuối. Stall có thể là request vendor dữ liệu, vòng tool lặp hoặc timeout model; kiểm tra timestamp theo giai đoạn trước khi tăng giới hạn. Dừng khi dữ liệu bắt buộc thiếu. Thử lại cho tới khi văn xuôi xuất hiện có thể che lỗi gốc và tiêu thụ toàn bộ ngân sách nghiên cứu.

Bằng chứng và giới hạn

Cấu hình được rà soát nguồn ngày 5 tháng 9 năm 2026 tại revision 9dee508c. Ví dụ là template walkthrough; không thực hiện request client APIsRouter, đồ thị hoàn chỉnh hay ca chi phí đo được cho hướng dẫn. Xác thực model và tool dữ liệu trong lần chạy có phạm vi riêng trước khi mở rộng workflow.

Câu hỏi thường gặp