Leitfaden zu FinRobot-Version und benutzerdefinierter API

Identifizieren Sie, welches FinRobot Sie ausführen

Die am 5. September 2026 bei d2219100 geprüfte offizielle README beschreibt FinRobot Desktop v0.1.0 mit PydanticAI, FastAPI und React/Tauri. Sie enthält außerdem einen finrobot_equity-Pro-Workflow und ältere AutoGen-Tutorials. Dies sind keine austauschbaren Konfigurationsoberflächen. Der Desktop-Release ist bei desktop-v0.1.0 unter 6a8161ff markiert; der Master-Snapshot ist eine separate Quellenidentität. Erfassen Sie den tatsächlichen Release oder Commit, Einstiegsbefehl und die Konfigurationsdatei. Das Vorhandensein älterer OAI_CONFIG_LIST-Anweisungen im selben Repository belegt nicht, wie die Desktop-Anwendung Modelle lädt.

Vergleichen Sie die dokumentierten Anwendungspfade

Behandeln Sie die Versionsauswahl als erste Kompatibilitätsprüfung. Die Desktop-Dokumentation beschreibt Orchestrierung, spezialisierte Research-Rollen und deterministische Finanzberechnung, aber diese Prüfung hat seinen benutzerdefinierten APIsRouter-Endpunktpfad nicht belegt. Pro-Skript und ältere Python-Agenten zeigen unterschiedliche quellsichtbare Einstellungen. Eine erfolgreiche Anfrage über einen Pfad kann die anderen nicht zertifizieren. Prüfen Sie vor der Installation außerdem die offizielle Desktop-Plattform und Signaturhinweise und umgehen Sie Betriebssystemsicherheitsprüfungen nicht nur, um ein Integrationstutorial abzuschließen.

Verwenden Sie die Pro-Endpunktfelder nur für das Pro-Skript

Die aktuelle finrobot_equity/core/config/config.ini.example enthält openai_api_key, openai_base_url und openai_model. generate_financial_analysis.py liest optionale Basis-URL und optionales Modell und leitet sie an seinen Textgenerierungspfad weiter. Die folgende Vorlage passt diese geprüften Felder an; ersetzen Sie die Platzhalter in Großbuchstaben lokal. Diese INI-Datei bedeutet keine Interpolation von Umgebungsvariablen. Schützen Sie die echte Datei mit lokalen Berechtigungen, schließen Sie sie von der Versionsverwaltung aus und veröffentlichen Sie sie nicht in Support-Logs. Der Schlüssel für Finanzdaten bleibt unabhängig von den Modellzugangsdaten.

[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

Führen Sie den Pro-Textgenerierungspfad mit expliziten Eingaben aus

Verwenden Sie das Pro-Analyseskript mit Ihrer Unternehmensidentität und geschützten Konfigurationsdatei und prüfen Sie die generierte Analyse vor der Berichtsdarstellung. Finanzbeschaffung, Prognoseannahmen und numerische Berechnungen bleiben vom unten gezeigten Modell-Erzählungspfad getrennt. Prüfen Sie bei einem internationalen Emittenten Börsenabdeckung, Berichtswährung und Bilanzierungsgrundlage des Datenanbieters, bevor Sie Ergebnisse vergleichen. Klären Sie Aktienanzahl, Geschäftsjahre und jede Währungsumrechnung ausdrücklich. Führen Sie beim Erstellen des ersten prüfbaren Berichtspakets nur die erforderlichen Stufen aus.

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

Halten Sie Finanzberechnungen reproduzierbar

Die aktuelle Desktoparchitektur trennt Finanzberechnung ausdrücklich von LLM-Erklärung. Wenden Sie dieselbe Abnahmeregel bei jedem FinRobot-Artefakt an: Führen Sie eine angezeigte Zahl auf Quelleneingaben, Einheiten, Annahmen und die Berechnung zurück, die sie erzeugt hat. Eine deterministische Bewertung hängt weiterhin von unsicheren Prognosen ab; Reproduzierbarkeit ist kein Beleg dafür, dass diese Prognosen eintreffen. Halten Sie Basisannahmen und alternative Szenarien getrennt, bewahren Sie Formeln auf und lassen Sie das Modell Sensitivitäten diskutieren, statt stillschweigend einen Zielwert auszuwählen. Verlangen Sie, dass fehlende Eingaben fehlen bleiben, bis ein Prüfer eine autorisierte Annahme liefert.

Behandeln Sie ältere AutoGen-Notebooks als separate Migration

Das erhaltene finrobot/agents/workflow.py importiert AutoGen und akzeptiert llm_config. Ältere Tutorials laden Modelle über OAI_CONFIG_LIST und übergeben eine Config-Liste an diesen Workflow. Wenn Sie diesen Pfad pflegen, folgen Sie Notebook- und Abhängigkeitsversion gemeinsam. Übertragen Sie keine moderne PydanticAI-Konfiguration dorthin und beschreiben Sie OAI_CONFIG_LIST nicht als universelle FinRobot-Einstellung. Die Migration eines bestehenden Reportprozesses erfordert die Prüfung seiner Tools, des Ladens des Daten-Schlüssels, des Codeausführungsverhaltens und der Berichtserzeugung und nicht nur das Ersetzen einer Basis-URL.

Validieren Sie einen Bericht von der Eingabe bis zur Quellenangabe

Beginnen Sie mit einem begrenzten öffentlichen Einreichungspaket und einer engen Frage. Validieren Sie nach einem separat autorisierten Clienttest ein erforderliches Datentool, eine numerische Berechnung und einen Berichtabschnitt mit Quellenangaben. Erfassen Sie Anwendungsrevision, Quellen-Hashes, Konfiguration ohne Geheimnisse, aufgelöste Modell-ID und beobachtete Nutzung. Prüfen Sie, dass generierter Text Einheiten bewahrt und ausgewiesene Fakten von Projektionen unterscheidet. Ein Transport-Hello oder eine Antwort der Modellfabrik belegt nur diese Stufe. Die Abnahme eines vollständigen Berichts erfordert zusätzlich vollständige Daten, geprüfte Berechnungen, lesbare Ausgabe und nachvollziehbare Aussagen.

Budgetieren und wiederherstellen Sie an Stufengrenzen

Trennen Sie Gebühren für Finanzdaten, Modellanfragen, Ressourcen zur Berichtsdarstellung und Analystenprüfung. Verwenden Sie für eine Schätzung aktuelle Preise und gleichen Sie anschließend das Anfrageprotokoll einschließlich Wiederholungen und Fehlern ab. Wenn ein API-Feld ignoriert wird, prüfen Sie das genaue Einstiegsskript, bevor Sie weitere Konfigurationsdateien hinzufügen. Wenn ein Bericht leer ist, prüfen Sie Erwerbs- und Parsing-Logs, bevor Sie das Modell ändern. Wenn numerische Eingaben widersprechen, halten Sie den Bericht zur Prüfung an und bewahren Sie beide Quellwerte. Setzen Sie am korrigierten Schritt fort, damit der fertige Bericht den Grund jeder Änderung erhält.

Belege und Einschränkungen

Quell- und Release-Dokumentation wurden am 5. September 2026 geprüft. Pro-Endpunktfelder und ihre Weiterleitung sind bei d2219100 bestätigt; der benutzerdefinierte Gateway-Pfad des Desktops bleibt unverifiziert. Für diesen Leitfaden wurde weder eine APIsRouter-Anfrage noch ein vollständiger Bericht oder ein Fall mit gemessener Nutzung ausgeführt. Die Pro-Beispiele gelten für die genannten Skripte und nicht für den Desktop oder jedes ältere Notebook.

Häufige Fragen