Guide FinRobot des versions et de l'API personnalisée

Identifiez le FinRobot que vous exécutez

Le README officiel examiné à d2219100 le 5 septembre 2026 décrit FinRobot Desktop v0.1.0 avec PydanticAI, FastAPI et React/Tauri. Il conserve aussi un workflow finrobot_equity Pro et d'anciens tutoriels AutoGen. Ces surfaces de configuration ne sont pas interchangeables. La release desktop est étiquetée desktop-v0.1.0 à 6a8161ff ; l'instantané master est une identité source distincte. Enregistrez la release ou le commit réel, la commande d'entrée et le fichier de configuration. La présence d'instructions OAI_CONFIG_LIST anciennes dans le même dépôt n'établit pas la manière dont l'application desktop charge les modèles.

Comparez les chemins applicatifs documentés

Traitez le choix de version comme premier contrôle de compatibilité. La documentation desktop décrit l'orchestration, les rôles de recherche spécialisés et le calcul financier déterministe, mais cette revue n'a pas établi son chemin d'endpoint APIsRouter personnalisé. Le script Pro et les agents Python historiques exposent des paramètres différents visibles dans les sources. Une requête réussie par l'un ne peut pas certifier les autres. Examinez aussi les notes officielles de plateforme desktop et de signature avant l'installation ; ne contournez pas les contrôles de sécurité du système d'exploitation simplement pour terminer un tutoriel d'intégration.

Utilisez les champs d'endpoint Pro uniquement pour le script Pro

Le fichier actuel finrobot_equity/core/config/config.ini.example comprend openai_api_key, openai_base_url et openai_model. generate_financial_analysis.py lit l'URL de base et le modèle facultatifs et les transmet à son chemin de génération de texte. Le modèle ci-dessous adapte ces champs vérifiés ; remplacez localement les placeholders en majuscules. Ce fichier INI n'implique pas l'interpolation de variables d'environnement. Protégez le vrai fichier avec les permissions locales, excluez-le du contrôle de version et évitez de le publier dans les journaux de support. La clé des données financières reste indépendante de l'identifiant du modèle.

[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

Exécutez le chemin de génération de texte Pro avec des entrées explicites

Utilisez le script d'analyse Pro avec l'identité de votre entreprise et le fichier de configuration protégé, puis inspectez l'analyse générée avant le rendu du rapport. L'acquisition financière, les hypothèses de prévision et les calculs numériques restent séparés du chemin de narration du modèle présenté ci-dessous. Pour un émetteur international, vérifiez la couverture de la place boursière du fournisseur de données, la devise de reporting et la base comptable avant de comparer les résultats. Résolvez explicitement les nombres d'actions, les périodes fiscales et toute conversion de devise. N'exécutez que les étapes nécessaires pendant la constitution du premier paquet de rapport inspectable.

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

Gardez les calculs financiers reproductibles

L'architecture desktop actuelle sépare explicitement le calcul financier de l'explication LLM. Appliquez le même principe d'acceptation lors de la revue d'un artefact FinRobot : reliez chaque chiffre affiché aux entrées sources, aux unités, aux hypothèses et au calcul qui l'a produit. Une valorisation déterministe dépend encore de prévisions incertaines ; la reproductibilité ne prouve pas que ces prévisions se réaliseront. Gardez distinctes les hypothèses de base et les scénarios alternatifs, préservez les formules et demandez au modèle de discuter les sensibilités au lieu de sélectionner silencieusement une valeur cible. Exigez que les entrées manquantes restent manquantes jusqu'à ce qu'un relecteur fournisse une hypothèse autorisée.

Traitez les notebooks AutoGen historiques comme une migration séparée

Le fichier conservé finrobot/agents/workflow.py importe AutoGen et accepte llm_config. Les anciens tutoriels chargent les entrées de modèle via OAI_CONFIG_LIST et transmettent une liste de configuration à ce workflow. Si vous maintenez ce chemin, suivez ensemble le notebook et la version de ses dépendances. N'y transplantez pas une configuration PydanticAI moderne et ne décrivez pas OAI_CONFIG_LIST comme un paramètre universel de FinRobot. Migrer un processus de rapport existant exige de vérifier ses outils, le chargement des clés de données, le comportement d'exécution de code et la génération du rapport, pas seulement de remplacer une URL de base.

Validez un rapport de l'entrée au localisateur de source

Commencez avec un paquet de documents réglementaires publics délimité et une question étroite. Après un test client autorisé séparément, validez un outil de données requis, un calcul numérique et une section de rapport avec citations. Enregistrez la révision de l'application, les hashes des sources, la configuration sans les secrets, l'ID de modèle résolu et l'utilisation observée. Vérifiez que le texte généré conserve les unités et distingue les faits publiés des projections. Un salut de transport ou une réponse de fabrique de modèle ne prouve que cette étape. L'acceptation du rapport complet exige en plus l'exhaustivité des données, la revue des calculs, la lisibilité de la sortie et des affirmations traçables.

Budgez et récupérez aux frontières des étapes

Séparez les frais de données financières, les requêtes de modèle, les ressources de rendu du rapport et la revue de l'analyste. Utilisez les tarifs actuels pour une estimation, puis rapprochez le registre des requêtes, y compris les nouvelles tentatives et les échecs. Si un champ API est ignoré, inspectez le script d'entrée précis avant d'ajouter d'autres fichiers de configuration. Si un rapport est vide, inspectez les journaux d'acquisition et d'analyse avant de changer de modèle. Lorsque les entrées numériques sont en conflit, mettez le rapport en pause pour revue et conservez les deux valeurs sources. Reprenez depuis l'étape corrigée afin que le rapport terminé conserve la raison de chaque changement.

Preuves et limites

La documentation des sources et des releases a été examinée le 5 septembre 2026. Les champs d'endpoint Pro et leur transmission sont confirmés dans d2219100 ; le chemin de passerelle personnalisé desktop reste non vérifié. Aucune requête APIsRouter, aucun rapport complet ni aucun cas d'utilisation mesuré n'a été exécuté pour ce guide. Les exemples Pro s'appliquent aux scripts nommés, et non à desktop ou à tous les notebooks historiques.

Questions fréquentes