Guida alle versioni e all'API personalizzata di FinRobot

Identifica quale FinRobot stai eseguendo

Il README ufficiale revisionato a d2219100 il 5 settembre 2026 descrive FinRobot Desktop v0.1.0 con PydanticAI, FastAPI e React/Tauri. Conserva anche un flusso finrobot_equity Pro e tutorial AutoGen più vecchi. Queste non sono superfici di configurazione intercambiabili. La release desktop è contrassegnata desktop-v0.1.0 a 6a8161ff; lo snapshot master è un'identità fonte separata. Registra release o commit effettivo, comando di avvio e file di configurazione. La presenza delle istruzioni OAI_CONFIG_LIST legacy nello stesso repository non stabilisce come l'applicazione desktop carichi i modelli.

Confronta i percorsi applicativi documentati

Tratta la selezione della versione come primo controllo di compatibilità. La documentazione desktop descrive orchestrazione, ruoli di ricerca specialistici e calcolo finanziario deterministico, ma questa revisione non ha stabilito il percorso dell'endpoint APIsRouter personalizzato. Lo script Pro e gli agenti Python legacy espongono impostazioni diverse visibili nella fonte. Una richiesta riuscita attraverso uno non può certificare gli altri. Esamina inoltre le note ufficiali sulla piattaforma desktop e sulla firma prima dell'installazione; non aggirare i controlli di sicurezza del sistema operativo solo per completare un tutorial d'integrazione.

Usa i campi endpoint Pro solo per lo script Pro

L'attuale finrobot_equity/core/config/config.ini.example include openai_api_key, openai_base_url e openai_model. generate_financial_analysis.py legge base URL e modello opzionali e li inoltra al percorso di generazione testuale. Il template qui sotto adatta quei campi verificati; sostituisci localmente i placeholder maiuscoli. Questo file INI non implica interpolazione di variabili d'ambiente. Proteggi il file reale con permessi locali, escludilo dal controllo versione ed evita di pubblicarlo nei log di supporto. La chiave dei dati finanziari resta indipendente dalla credenziale del modello.

[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

Esegui il percorso Pro di generazione testuale con input espliciti

Usa lo script di analisi Pro con identità dell'azienda e file di configurazione protetto, poi esamina l'analisi generata prima del rendering del report. Acquisizione finanziaria, ipotesi previsionali e calcoli numerici restano separati dal percorso della narrazione del modello mostrato sotto. Per un emittente internazionale controlla copertura della borsa del provider dati, valuta di reporting e base contabile prima di confrontare i risultati. Risolvi esplicitamente conteggi delle azioni, periodi fiscali ed eventuali conversioni valutarie. Esegui solo le fasi necessarie mentre stabilisci il primo pacchetto di report ispezionabile.

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

Mantieni riproducibili i calcoli finanziari

L'architettura desktop corrente separa esplicitamente calcolo finanziario e spiegazione LLM. Applica lo stesso principio di accettazione quando revisioni qualsiasi artefatto FinRobot: ricostruisci un numero visualizzato a partire da input fonte, unità, ipotesi e calcolo che lo ha prodotto. Una valutazione deterministica dipende comunque da previsioni incerte; la riproducibilità non dimostra che tali previsioni si avvereranno. Mantieni distinte ipotesi di base e scenari alternativi, conserva le formule e fai discutere al modello le sensibilità invece di selezionare silenziosamente un target value. Richiedi che gli input mancanti restino mancanti finché un revisore non fornisce un'ipotesi autorizzata.

Tratta i notebook AutoGen legacy come una migrazione separata

Il finrobot/agents/workflow.py conservato importa AutoGen e accetta llm_config. I tutorial legacy caricano voci modello tramite OAI_CONFIG_LIST e passano una config list a quel workflow. Segui notebook e versione delle dipendenze insieme se mantieni questo percorso. Non trapiantare in esso una configurazione PydanticAI moderna e non descrivere OAI_CONFIG_LIST come impostazione universale FinRobot. Migrare un processo di report esistente richiede controllare strumenti, caricamento delle chiavi dati, comportamento dell'esecuzione codice e generazione del report, non solo sostituire un base URL.

Valida un report dall'input al locator della fonte

Inizia con un pacchetto circoscritto di filing pubblico e una domanda ristretta. Dopo un test client autorizzato separatamente, valida uno strumento dati richiesto, un calcolo numerico e una sezione del report con citazioni. Registra revisione dell'applicazione, hash delle fonti, configurazione senza secret, ID modello risolto e utilizzo osservato. Controlla che il testo generato preservi le unità e distingua fatti riportati da proiezioni. Un hello del trasporto o una risposta della factory dimostra solo quella fase. L'accettazione del report completo richiede inoltre completezza dei dati, revisione dei calcoli, output leggibile e asserzioni tracciabili.

Metti a budget e recupera ai confini delle fasi

Separa costi dei dati finanziari, richieste al modello, risorse di rendering del report e revisione dell'analista. Usa prezzi correnti per una stima, poi riconcilia il ledger delle richieste, inclusi retry e fallimenti. Se un campo API viene ignorato, ispeziona lo script di ingresso preciso prima di aggiungere altri file di configurazione. Se un report è vuoto, esamina log di acquisizione e parsing prima di cambiare modello. Quando gli input numerici sono in conflitto, sospendi il report per la revisione e conserva entrambi i valori fonte. Riprendi dalla fase corretta, così il report completato preserva il motivo di ogni cambiamento.

Evidenze e limiti

La documentazione della fonte e della release è stata revisionata il 5 settembre 2026. Campi endpoint Pro e relativo inoltro sono confermati in d2219100; il percorso gateway personalizzato desktop resta non verificato. Per questa guida non sono state eseguite richieste APIsRouter, report completi o casi misurati di utilizzo. Gli esempi Pro si applicano agli script nominati, non al desktop o a ogni notebook legacy.

Domande frequenti