Hướng dẫn phiên bản và API tùy chỉnh FinRobot

Xác định FinRobot bạn đang chạy

README chính thức được rà soát tại d2219100 ngày 5 tháng 9 năm 2026 mô tả FinRobot Desktop v0.1.0 với PydanticAI, FastAPI và React/Tauri. README cũng giữ workflow finrobot_equity Pro cùng tutorial AutoGen cũ. Đây không phải các bề mặt cấu hình có thể thay thế. Bản desktop được tag desktop-v0.1.0 tại 6a8161ff; snapshot master là danh tính nguồn riêng. Ghi release hoặc commit thực, lệnh entry và tệp cấu hình. Việc cùng repository có chỉ dẫn OAI_CONFIG_LIST cũ không xác lập desktop tải model thế nào.

So sánh các đường ứng dụng được ghi nhận

Coi chọn phiên bản là kiểm tra tương thích đầu tiên. Tài liệu desktop mô tả điều phối, vai trò nghiên cứu chuyên gia và tính toán tài chính xác định, nhưng lần rà soát này chưa xác lập đường endpoint APIsRouter tùy chỉnh của nó. Script Pro và agent Python cũ có cài đặt hiển thị nguồn khác nhau. Request thành công qua một đường không chứng nhận đường khác. Cũng rà soát ghi chú nền tảng desktop và ký chính thức trước khi cài; đừng bỏ qua kiểm tra bảo mật hệ điều hành chỉ để hoàn tất tutorial tích hợp.

Chỉ dùng trường endpoint Pro cho script Pro

finrobot_equity/core/config/config.ini.example hiện tại gồm openai_api_key, openai_base_url và openai_model. generate_financial_analysis.py đọc base URL và model tùy chọn rồi chuyển chúng tới đường tạo văn bản. Template bên dưới điều chỉnh các trường đã xác minh; thay placeholder chữ hoa cục bộ. Tệp INI này không ngụ ý nội suy biến môi trường. Bảo vệ tệp thật bằng quyền local, loại khỏi version control và không đưa vào log hỗ trợ. Key dữ liệu tài chính vẫn độc lập với credential model.

[API_KEYS]
fmp_api_key = YOUR_FINANCIAL_DATA_KEY
openai_api_key = YOUR_APISROUTER_KEY
openai_base_url = https://api.apisrouter.com/v1
openai_model = CURRENT_CATALOG_MODEL_ID

Chạy đường tạo văn bản Pro với input rõ

Dùng script phân tích Pro với danh tính công ty và tệp cấu hình được bảo vệ, rồi kiểm tra phân tích tạo trước khi render báo cáo. Thu thập tài chính, giả định dự báo và phép tính số vẫn tách khỏi route tường thuật mô hình bên dưới. Với tổ chức phát hành quốc tế, kiểm tra phạm vi sở giao dịch, tiền tệ báo cáo và cơ sở kế toán của nhà cung cấp trước khi so sánh. Làm rõ số cổ phần, kỳ tài chính và mọi chuyển đổi tiền tệ. Chỉ chạy các giai đoạn cần khi dựng gói báo cáo đầu tiên có thể kiểm tra.

python finrobot_equity/core/src/generate_financial_analysis.py \
  --company-ticker "$RESEARCH_TICKER" \
  --company-name "$RESEARCH_COMPANY" \
  --config-file finrobot_equity/core/config/config.ini \
  --generate-text-sections

Giữ phép tính tài chính có thể tái lập

Kiến trúc desktop hiện tại tách rõ tính toán tài chính khỏi giải thích LLM. Dùng cùng nguyên tắc chấp nhận khi rà soát artifact FinRobot: truy số hiển thị về input nguồn, đơn vị, giả định và phép tính tạo ra nó. Định giá xác định vẫn phụ thuộc dự báo chưa chắc; tái lập không chứng minh dự báo sẽ đúng. Tách giả định cơ sở và kịch bản thay thế, giữ công thức và để mô hình thảo luận độ nhạy thay vì âm thầm chọn giá mục tiêu. Yêu cầu input thiếu vẫn thiếu cho đến khi người rà soát cung cấp giả định được ủy quyền.

Coi notebook AutoGen cũ là một lần di chuyển riêng

finrobot/agents/workflow.py được giữ lại import AutoGen và nhận llm_config. Tutorial cũ tải entry model qua OAI_CONFIG_LIST và truyền danh sách cấu hình vào workflow. Nếu duy trì đường này, đi cùng notebook và phiên bản phụ thuộc. Đừng chuyển cấu hình PydanticAI hiện đại vào nó hoặc mô tả OAI_CONFIG_LIST là cài đặt FinRobot phổ quát. Di chuyển quy trình báo cáo hiện có cần kiểm tra tool, tải key dữ liệu, hành vi thực thi mã và tạo báo cáo, không chỉ thay base URL.

Xác thực một báo cáo từ input đến vị trí nguồn

Bắt đầu bằng gói hồ sơ công khai nhỏ và câu hỏi hẹp. Sau test client được ủy quyền riêng, xác thực một data tool bắt buộc, một phép tính số và một phần báo cáo có trích dẫn. Ghi revision ứng dụng, hash nguồn, cấu hình đã loại secret, model ID đã giải quyết và usage quan sát. Kiểm tra văn bản giữ đơn vị và phân biệt dữ kiện báo cáo với dự phóng. Hello transport hay response factory chỉ chứng minh giai đoạn đó. Chấp nhận báo cáo đầy đủ còn cần dữ liệu hoàn chỉnh, rà soát tính toán, đầu ra dễ đọc và khẳng định truy dấu được.

Lập ngân sách và khôi phục tại ranh giới giai đoạn

Tách phí dữ liệu tài chính, yêu cầu model, tài nguyên render báo cáo và rà soát phân tích. Dùng giá hiện tại cho ước tính, rồi đối soát sổ cái request, gồm retry và lỗi. Nếu trường API bị bỏ qua, kiểm tra script entry chính xác trước khi thêm tệp cấu hình. Nếu báo cáo rỗng, kiểm tra log thu thập và parse trước khi đổi model. Khi input số mâu thuẫn, tạm dừng báo cáo để rà soát và giữ cả hai giá trị nguồn. Tiếp tục từ giai đoạn đã sửa để báo cáo hoàn tất giữ lý do từng thay đổi.

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

Tài liệu nguồn và release được rà soát ngày 5 tháng 9 năm 2026. Trường endpoint Pro và chuyển tiếp được xác nhận trong d2219100; đường gateway tùy chỉnh desktop vẫn chưa xác minh. Không chạy request APIsRouter, báo cáo hoàn chỉnh hay ca usage đo được cho hướng dẫn. Ví dụ Pro áp dụng cho script được nêu, không áp dụng desktop hoặc mọi notebook cũ.

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