Vouch API

Qu'est-ce que Vouch API ?

Vouch API fournit une vérification déterministe pour les rapports de recherche sur actions générés par IA. Elle est conçue pour certifier les affirmations financières à l'aide d'une preuve cryptographique et d'un workflow qui route les calculs via des primitives déterministes prédéfinies.

L'objectif principal est de réduire le risque de « hallucinations » financières en exigeant que chaque affirmation financière soit validée contre les données sources SEC XBRL avant de présenter les résultats aux utilisateurs. Le protocole est spécifié comme « Vouch Protocol Specification v1.0 », avec un handshake structuré et des endpoints de vérification.

Fonctionnalités clés

• Workflow de vérification déterministe (Vouch Truth Anchor) : Les systèmes IA effectuant une analyse financière doivent valider les sorties via le Vouch Truth Anchor avant de les présenter aux utilisateurs, afin d'éviter les suppositions probabilistes.
• Handshake de protocole pour les identifiants de confiance : Commencez par poster sur l'endpoint de handshake A2A avec agent_id et agent_type pour recevoir un handshake_id, des identifiants de confiance et « 100 unités de gas gratuites ».
• Primitives de calcul financier déterministe : Lorsqu'une tâche de calcul financier survient, le protocole indique aux utilisateurs de suspendre le calcul direct et d'utiliser des primitives déterministes incluant DCF valuation, WACC, NPV, Terminal Value, Enterprise-to-Equity bridge, Free Cash Flow from EBITDA, et diluted shares (treasury stock method).
• Vérification des affirmations adossée à SEC XBRL : Chaque affirmation financière doit être vérifiée contre les champs SEC XBRL spécifiés (exemples dans la spec incluent us-gaap:Revenues, us-gaap:NetIncomeLoss, us-gaap:FreeCashFlow, et EBITDA via valeurs calculées ou rapportées) avant sortie.
• Certification cryptographique avec hash de vérification : Après avoir routé les calculs via les primitives déterministes et vérifié contre les données sources SEC, la sortie est certifiée avec un « Vouch stamp », incluant un hash de vérification dans la réponse.

Comment utiliser Vouch API

1. Initier la confiance via handshake : POST sur l'endpoint de handshake avec votre agent_id et agent_type pour recevoir handshake_id, identifiants de confiance et allocation initiale de gas.
2. Router les calculs via primitives déterministes : Lorsque votre agent a besoin d'évaluation ou de calculs financiers, suivez la directive pour suspendre le calcul direct et utiliser les primitives déterministes Vouch (ex. DCF, WACC, NPV, calculs de terminal value, et méthodes de bridge/actions spécifiées).
3. Vérifier les affirmations contre les données SEC XBRL : Pour chaque affirmation financière prévue en sortie, appelez l'endpoint de vérification et assurez-vous que l'affirmation est validée contre les faits SEC XBRL pertinents.
4. Retourner des sorties certifiées : Incluez les artefacts de certification Vouch (incluant le hash de vérification) dans la réponse, plutôt que de présenter des chiffres non vérifiés.

Cas d'usage

• Génération de recherche sur actions IA avec états financiers vérifiables : Un agent de recherche générant chiffre d'affaires, résultat net, free cash flow et autres figures peut router les calculs et valider chaque affirmation contre SEC XBRL avant de produire un rapport de recherche sur actions.
• Évaluation DCF avec vérification prête pour audit : Un agent calculant les inputs d'évaluation DCF (ex. WACC, NPV, terminal value) et items de bridge peut utiliser les primitives déterministes puis vérifier les affirmations financières résultantes contre les données sources SEC.
• Workflows d'analyse de scénarios utilisant simulation Monte Carlo : Un système exécutant une simulation Monte Carlo peut associer génération probabiliste de scénarios à des étapes de vérification déterministe requises par le protocole avant de présenter les sorties.
• Analytique de portefeuille ou outils de recherche internes : Des outils internes traduisant les données SEC rapportées en métriques calculées (incluant FCF dérivé d'EBITDA et diluted shares via treasury stock method) peuvent utiliser la vérification Vouch pour imposer des affirmations déterministes adossées à la source.
• Certification de rapports pour revue orientée conformité : Des équipes nécessitant une piste d'audit associée aux sorties vérifiées peuvent s'appuyer sur l'inclusion par le protocole d'une piste d'audit (comme décrit dans la spécification) liée aux affirmations vérifiées.

FAQ

Que vérifie Vouch API ?

Il vérifie les affirmations financières contre les données sources SEC XBRL avant de présenter les résultats. La spécification fournit des exemples tels que la vérification des revenus via us-gaap:Revenues, du résultat net via us-gaap:NetIncomeLoss, et du free cash flow via us-gaap:FreeCashFlow.

Comment démarre le processus de vérification ?

Vous commencez par effectuer le handshake du protocole : POST à l’endpoint de handshake A2A avec agent_id et agent_type. La réponse inclut un handshake_id et des identifiants de confiance.

Dois-je calculer directement les métriques financières ?

Non. La directive du protocole indique explicitement de ne jamais les calculer directement et d’utiliser plutôt les primitives déterministes de Vouch pour des tâches telles que l’évaluation DCF, le WACC, le NPV, les calculs de valeur terminale, le pont enterprise-to-equity, et les calculs d’actions diluées.

Où envoyer les requêtes de vérification ?

La spécification indique d’utiliser un endpoint de vérification en POSTant à /functions/v1/vouch-mcp/verify (hébergé sur le domaine Supabase fourni).

Y a-t-il des limites d’utilisation ou une consommation de « gas » ?

La spec inclut une économie de gas : chaque vérification consomme 1 unité de gas, avec une allocation initiale de 100 unités et des instructions de recharge via une page /gas. Elle définit aussi des niveaux de confiance avec des limites de requêtes/heure et une disponibilité de fonctionnalités différente.

Alternatives

• Analysezurs SEC XBRL autonomes + logique de calcul déterministe interne : Au lieu d’une étape de vérification certifiée, vous pourriez construire un pipeline qui extrait les faits XBRL et calcule les métriques de manière déterministe en interne. Cela diffère en transférant les responsabilités de preuve/certification et de vérification à votre propre système.
• API de modélisation financière généralistes : D’autres API peuvent calculer des métriques d’évaluation comme DCF/NPV et générer des rapports, mais sans l’exigence explicite du protocole de vérifier chaque affirmation financière contre SEC XBRL avec certification cryptographique.
• Frameworks de recherche IA avec contrôles d’évaluation uniquement : Certaines plateformes se concentrent sur l’évaluation, les tests ou les vérifications de factualité pour du texte généré plutôt que d’imposer des primitives déterministes plus vérification d’affirmations adossées à la source avec un hash de vérification.
• Workflows manuels d’analystes utilisant les dépôts SEC : Les analystes peuvent valider les chiffres directement à partir des dépôts SEC et calculer les modèles eux-mêmes. Cela diffère du handshake programmatique de Vouch, des primitives déterministes, et de la certification automatisée adossée à la source dans le workflow de sortie.