Przewodnik po wersjach i własnym API FinRobot

Ustal, którego FinRobot uruchamiasz

Oficjalny README przejrzany w d2219100 5 września 2026 r. opisuje FinRobot Desktop v0.1.0 z PydanticAI, FastAPI i React/Tauri. Zachowuje również proces finrobot_equity Pro oraz starsze poradniki AutoGen. Nie są to wymienne powierzchnie konfiguracji. Wydanie desktopowe ma tag desktop-v0.1.0 w 6a8161ff; migawka master jest odrębną tożsamością źródła. Zapisz rzeczywiste wydanie lub commit, polecenie wejściowe i plik konfiguracji. Obecność instrukcji OAI_CONFIG_LIST w tym samym repozytorium nie dowodzi, jak aplikacja desktopowa ładuje modele.

Porównaj udokumentowane ścieżki aplikacji

Traktuj wybór wersji jako pierwszą kontrolę zgodności. Dokumentacja desktopu opisuje orkiestrację, specjalistyczne role badawcze i deterministyczne obliczenia finansowe, ale ten przegląd nie potwierdził jego niestandardowej ścieżki endpointu APIsRouter. Skrypt Pro i starsi agenci Pythona udostępniają inne widoczne w źródle ustawienia. Udane żądanie jednej ścieżki nie poświadcza pozostałych. Przed instalacją przejrzyj także oficjalne informacje o platformie desktopowej i podpisywaniu; nie omijaj kontroli bezpieczeństwa systemu operacyjnego tylko po to, aby ukończyć poradnik integracji.

Pól endpointu Pro używaj tylko dla skryptu Pro

Bieżący plik finrobot_equity/core/config/config.ini.example zawiera openai_api_key, openai_base_url i openai_model. generate_financial_analysis.py odczytuje opcjonalny bazowy URL i model oraz przekazuje je do ścieżki generowania tekstu. Poniższy szablon dostosowuje te zweryfikowane pola; wielkimi placeholderami zastąp je lokalnie. Ten plik INI nie oznacza interpolacji zmiennych środowiskowych. Chroń prawdziwy plik lokalnymi uprawnieniami, wyklucz go z kontroli wersji i nie publikuj w logach wsparcia. Klucz danych finansowych pozostaje niezależny od danych uwierzytelniających modelu.

[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

Uruchom ścieżkę generowania tekstu Pro z jawnymi danymi wejściowymi

Uruchom skrypt analizy Pro z tożsamością spółki i chronionym plikiem konfiguracji, a następnie przejrzyj wygenerowaną analizę przed renderowaniem raportu. Pobieranie danych finansowych, założenia prognozy i obliczenia liczbowe pozostają osobne od pokazanej niżej ścieżki narracji modelu. Dla emitenta międzynarodowego sprawdź pokrycie giełd, walutę raportowania i podstawę rachunkowości dostawcy danych przed porównaniem wyników. Jawnie rozwiąż liczbę akcji, okresy fiskalne i każdą konwersję walut. Podczas ustanawiania pierwszego raportu możliwego do inspekcji uruchamiaj tylko wymagane etapy.

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

Zachowaj powtarzalność obliczeń finansowych

Aktualna architektura desktopowa jawnie oddziela obliczenia finansowe od wyjaśnienia LLM. Tę samą zasadę akceptacji stosuj przy przeglądzie dowolnego artefaktu FinRobot: prześledź wyświetloną liczbę do danych źródłowych, jednostek, założeń i obliczenia, które ją utworzyło. Deterministyczna wycena nadal zależy od niepewnych prognoz; powtarzalność nie dowodzi, że prognozy się spełnią. Założenia bazowe i scenariusze alternatywne trzymaj osobno, zachowuj wzory i poproś model o omówienie wrażliwości zamiast cichego wyboru wartości docelowej. Wymagaj, aby brakujące dane wejściowe pozostały brakujące do czasu dostarczenia autoryzowanego założenia przez recenzenta.

Traktuj starsze notebooki AutoGen jako osobną migrację

Zachowany plik finrobot/agents/workflow.py importuje AutoGen i przyjmuje llm_config. Starsze poradniki ładują wpisy modeli przez OAI_CONFIG_LIST i przekazują listę konfiguracji do tego procesu. Jeśli utrzymujesz tę ścieżkę, trzymaj notebook i wersję zależności razem. Nie przenoś do niej nowoczesnej konfiguracji PydanticAI ani nie opisuj OAI_CONFIG_LIST jako uniwersalnego ustawienia FinRobot. Migracja istniejącego procesu raportowego wymaga sprawdzenia jego narzędzi, ładowania kluczy danych, zachowania wykonywania kodu i tworzenia raportu, a nie tylko zastąpienia bazowego URL.

Zweryfikuj jeden raport od danych wejściowych do lokalizatora źródła

Zacznij od ograniczonego pakietu publicznego raportu i wąskiego pytania. Po osobno autoryzowanym teście klienta zweryfikuj jedno wymagane narzędzie danych, jedno obliczenie liczbowe i jedną sekcję raportu z cytowaniami. Zapisz rewizję aplikacji, hashe źródeł, konfigurację bez sekretów, rozwiązany identyfikator modelu i zaobserwowane użycie. Sprawdź, czy wygenerowany tekst zachowuje jednostki i odróżnia raportowane fakty od projekcji. Odpowiedź transportowego hello lub odpowiedź fabryki modelu dowodzi tylko tego etapu. Akceptacja pełnego raportu wymaga dodatkowo kompletności danych, przeglądu obliczeń, czytelnego wyniku i śledzalnych twierdzeń.

Budżetuj i odzyskuj pracę na granicach etapów

Oddziel opłaty za dane finansowe, żądania modelu, zasoby renderowania raportu i przegląd analityka. Użyj bieżących cen do szacunku, a następnie uzgodnij dziennik żądań, w tym ponowienia i awarie. Jeśli pole API jest ignorowane, przeanalizuj dokładny skrypt wejściowy przed dodaniem kolejnych plików konfiguracji. Jeśli raport jest pusty, przed zmianą modelu sprawdź logi pobierania i parsowania. Gdy dane liczbowe są sprzeczne, wstrzymaj raport do przeglądu i zachowaj obie wartości źródłowe. Wznów pracę od poprawionego etapu, aby ukończony raport zachował powód każdej zmiany.

Dowody i ograniczenia

Dokumentacja źródeł i wydań została przejrzana 5 września 2026 r. Pola endpointu Pro i ich przekazywanie potwierdzono w d2219100; niestandardowa ścieżka gatewaya desktopu pozostaje niezweryfikowana. Na potrzeby tego przewodnika nie wykonano żądania APIsRouter, kompletnego raportu ani zmierzonego przypadku użycia. Przykłady Pro dotyczą nazwanych skryptów, a nie desktopu ani każdego starszego notebooka.

Częste pytania