FinRobot-versies en aangepaste API: gids

Bepaal welke FinRobot je uitvoert

De officiële README die op 5 september 2026 bij d2219100 is gereviewd, beschrijft FinRobot Desktop v0.1.0 met PydanticAI, FastAPI en React/Tauri. De repository behoudt ook een finrobot_equity Pro-workflow en oudere AutoGen-tutorials. Dit zijn geen uitwisselbare configuratieoppervlakken. De desktoprelease is getagd als desktop-v0.1.0 op 6a8161ff; de master-snapshot is een afzonderlijke bronidentiteit. Registreer de echte release of commit, het startcommando en configuratiebestand. De aanwezigheid van legacy OAI_CONFIG_LIST-instructies in dezelfde repository stelt niet vast hoe de desktopapp modellen laadt.

Vergelijk de gedocumenteerde applicatiepaden

Behandel versie-selectie als eerste compatibiliteitscontrole. De desktopdocumentatie beschrijft orchestration, gespecialiseerde onderzoeksrollen en deterministische financiële berekening, maar deze review heeft het aangepaste APIsRouter-endpointpad niet vastgesteld. Het Pro-script en legacy Python-agents tonen andere bronzichtbare instellingen. Een geslaagde request via het ene pad kan de andere niet certificeren. Review ook de officiële desktopplatform- en signingnotities vóór installatie; omzeil OS-beveiligingscontroles niet alleen om een integratietutorial te voltooien.

Gebruik Pro-endpointvelden alleen voor het Pro-script

De actuele finrobot_equity/core/config/config.ini.example bevat openai_api_key, openai_base_url en openai_model. generate_financial_analysis.py leest optionele base URL en model en stuurt ze door naar het text-generationpad. Het template hieronder past die geverifieerde velden aan; vervang de hoofdletter-placeholders lokaal. Dit INI-bestand impliceert geen interpolatie van omgevingsvariabelen. Bescherm het echte bestand met lokale rechten, sluit het uit van versiebeheer en publiceer het niet in supportlogs. De sleutel voor financiële data blijft onafhankelijk van de modelcredential.

[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

Voer het Pro-text-generationpad uit met expliciete input

Gebruik het Pro-analysescript met je bedrijfsidentiteit en beschermde configuratiebestand en inspecteer de gegenereerde analyse vóór het rapport wordt gerenderd. Financiële acquisitie, forecastaannames en numerieke berekeningen blijven gescheiden van de modelnarratieroute hieronder. Controleer voor een internationale emittent de beursdekking van de dataprovider, rapportagevaluta en accountingbasis vóór je resultaten vergelijkt. Los aandelenstuks, fiscale perioden en eventuele valutaconversie expliciet op. Voer alleen benodigde fasen uit terwijl je het eerste inspecteerbare rapportpakket opbouwt.

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

Houd financiële berekeningen reproduceerbaar

De huidige desktoparchitectuur scheidt financiële berekening expliciet van LLM-uitleg. Pas hetzelfde acceptatieprincipe toe bij ieder FinRobot-artefact: traceer een getoond getal naar broninput, eenheden, aannames en de berekening die het produceerde. Een deterministische waardering hangt nog steeds af van onzekere voorspellingen; reproduceerbaarheid bewijst niet dat de voorspellingen uitkomen. Houd basisaannames en alternatieve scenario's afzonderlijk, behoud de formules en laat het model gevoeligheden bespreken in plaats van stilzwijgend een target value te kiezen. Vereis dat ontbrekende input ontbreekt tot een reviewer een geautoriseerde aanname levert.

Behandel legacy AutoGen-notebooks als afzonderlijke migratie

Het behouden finrobot/agents/workflow.py importeert AutoGen en accepteert llm_config. Legacy-tutorials laden modelentries via OAI_CONFIG_LIST en geven een config list aan die workflow door. Volg notebook en dependencyversie samen wanneer je dit pad onderhoudt. Neem geen moderne PydanticAI-configuratie hierin over en beschrijf OAI_CONFIG_LIST niet als universele FinRobot-instelling. Migratie van een bestaand rapportproces vereist controle van tools, laden van datakeys, code-executiegedrag en rapportgeneratie en niet alleen vervanging van een base URL.

Valideer één rapport van input naar bronlocator

Begin met een begrensd pakket openbare filings en een beperkte vraag. Valideer na een afzonderlijk geautoriseerde clienttest één vereiste datatool, één numerieke berekening en één rapportsectie met citaties. Registreer applicatierevisie, bronhashes, configuratie zonder secrets, opgeloste model-ID en waargenomen usage. Controleer of gegenereerde tekst eenheden behoudt en gerapporteerde feiten van projecties onderscheidt. Een transport-hello of factory-response bewijst alleen die fase. Volledige rapportacceptatie vereist ook datacompleetheid, rekenreview, leesbare output en traceerbare claims.

Budgetteer en herstel bij fasegrenzen

Scheid kosten voor financiële data, modelrequests, rapport-rendering en analystreview. Gebruik actuele prijzen voor een schatting en reconcileer daarna het requestledger met retries en fouten. Inspecteer bij een genegeerd API-veld eerst het precieze entryscript voordat je extra configuratiebestanden toevoegt. Inspecteer bij een leeg rapport acquisitie- en parsinglogs voordat je het model wijzigt. Pauzeer het rapport voor review wanneer numerieke input conflicteert en bewaar beide bronwaarden. Hervat vanaf de gecorrigeerde fase zodat het voltooide rapport de reden voor elke wijziging behoudt.

Bewijs en beperkingen

Bron- en releasedocumentatie is op 5 september 2026 gereviewd. Pro-endpointvelden en forwarding zijn bevestigd in d2219100; het aangepaste desktopgatewaypad blijft niet geverifieerd. Voor deze gids zijn geen APIsRouter-requests, complete rapporten of gemeten usagecases uitgevoerd. De Pro-voorbeelden gelden voor de genoemde scripts en niet voor desktop of ieder legacy-notebook.

Veelgestelde vragen