Vouch API

Что такое Vouch API?

Vouch API обеспечивает детерминированную верификацию для результатов equity research, сгенерированных ИИ. Он предназначен для сертификации финансовых утверждений с помощью криптографического доказательства и рабочего процесса, который направляет расчёты через предопределённые детерминированные примитивы.

Основная цель — снизить риск финансовых «галлюцинаций», требуя валидации каждого финансового утверждения против исходных данных SEC XBRL перед представлением результатов пользователям. Протокол описан в «Vouch Protocol Specification v1.0» с структурированным handshake и endpoints для верификации.

Ключевые возможности

• Детерминированный workflow верификации (Vouch Truth Anchor): Системы ИИ, выполняющие финансовый анализ, должны валидировать выводы через Vouch Truth Anchor перед представлением пользователям, чтобы избежать вероятностных предположений.
• Протокольный handshake для учётных данных доверия: Начните с POST на endpoint handshake с agent_id и agent_type, чтобы получить handshake_id, учётные данные доверия и «100 free gas units».
• Детерминированные примитивы финансовых вычислений: При возникновении задачи финансового вычисления протокол требует остановить прямые расчёты и использовать детерминированные примитивы, включая DCF valuation, WACC, NPV, Terminal Value, Enterprise-to-Equity bridge, Free Cash Flow from EBITDA и diluted shares (treasury stock method).
• Верификация утверждений на основе SEC XBRL: Каждое финансовое утверждение должно быть проверено против указанных полей SEC XBRL (примеры в спецификации: us-gaap:Revenues, us-gaap:NetIncomeLoss, us-gaap:FreeCashFlow и EBITDA через расчётные или отчётные значения) перед выводом.
• Криптографическая сертификация с verification hash: После направления вычислений через детерминированные примитивы и проверки против данных SEC исходных данных вывод сертифицируется «Vouch stamp» с verification hash в ответе.

Как использовать Vouch API

1. Инициируйте доверие через handshake: Выполните POST на endpoint handshake с вашим agent_id и agent_type, чтобы получить handshake_id, учётные данные доверия и начальную аллокацию gas.
2. Направляйте вычисления через детерминированные примитивы: Когда вашему агенту нужны расчёты оценки или финансовые вычисления, следуйте директиве остановить прямые вычисления и используйте детерминированные примитивы Vouch (например, DCF, WACC, NPV, расчёты terminal value и указанные методы bridge/share).
3. Проверяйте утверждения против данных SEC XBRL: Для каждого финансового утверждения, которое вы планируете вывести, вызовите endpoint верификации и убедитесь, что утверждение валидировано против соответствующих фактов SEC XBRL.
4. Возвращайте сертифицированные выводы: Включите артефакты сертификации Vouch (включая verification hash) в ответ, вместо представления невыверенных чисел.

Сценарии использования

• Генерация equity research ИИ с верифицируемыми финансовыми отчётами: Агент исследований, генерирующий выручку, чистую прибыль, free cash flow и другие показатели, может направлять вычисления и валидировать каждое утверждение против SEC XBRL перед созданием отчёта equity research.
• DCF-оценка с верификацией, готовой к аудиту: Агент, вычисляющий входы DCF-оценки (например, WACC, NPV, terminal value) и bridge-показатели, может использовать детерминированные примитивы, а затем проверить результирующие финансовые утверждения против исходных данных SEC.
• Workflows сценарильного анализа с Monte Carlo simulation: Система, запускающая Monte Carlo simulation, может сочетать вероятностную генерацию сценариев с детерминированными шагами верификации, требуемыми протоколом, перед представлением выводов.
• Аналитика портфеля или внутренние инструменты исследований: Внутренние инструменты, преобразующие отчётные данные SEC в вычисляемые метрики (включая FCF из EBITDA и diluted shares по методу treasury stock), могут использовать верификацию Vouch для обеспечения детерминированных, подкреплённых источником утверждений.
• Сертификация отчётов для compliance-обзора: Команды, нуждающиеся в audit trail для верифицированных выводов, могут полагаться на включение в протокол audit trail (как описано в спецификации), привязанного к верифицированным утверждениям.

ЧАВО

Что проверяет Vouch API?

Он проверяет финансовые утверждения на соответствие исходным данным SEC XBRL перед представлением результатов. Спецификация приводит примеры, такие как проверка выручки через us-gaap:Revenues, чистой прибыли через us-gaap:NetIncomeLoss и свободного денежного потока через us-gaap:FreeCashFlow.

Как запускается процесс проверки?

Вы начинаете с выполнения рукопожатия протокола: POST на конечную точку рукопожатия A2A с agent_id и agent_type. Ответ содержит handshake_id и учётные данные доверия.

Нужно ли вычислять финансовые метрики напрямую?

Нет. Директива протокола прямо указывает никогда не вычислять их напрямую, а вместо этого использовать детерминированные примитивы Vouch для задач, таких как расчёт DCF-оценки, WACC, NPV, терминальной стоимости, моста от enterprise к equity и расчёта разводнённых акций.

Куда отправлять запросы на проверку?

Спецификация указывает использовать конечную точку проверки путём POST на /functions/v1/vouch-mcp/verify (размещённую на предоставленном домене Supabase).

Есть ли ограничения использования или потребление «газа»?

В спецификации предусмотрена газовая экономика: каждая проверка потребляет 1 единицу газа, с начальным выделением 100 единиц и инструкциями по пополнению на странице /gas. Также определены уровни доверия с разными лимитами запросов в час и доступностью функций.

Альтернативы

• Автономные парсеры SEC XBRL + внутренняя детерминированная логика расчётов: Вместо сертифицированного шага проверки вы можете построить конвейер, который извлекает факты XBRL и детерминированно вычисляет метрики внутри. Это отличается переносом ответственности за доказательство/сертификацию и проверку на вашу систему.
• Универсальные API финансового моделирования: Другие API могут вычислять метрики оценки вроде DCF/NPV и генерировать отчёты, но без явного требования протокола проверять каждое финансовое утверждение на соответствие SEC XBRL с криптографической сертификацией.
• Фреймворки ИИ-исследований с проверками только на оценку: Некоторые платформы фокусируются на оценке, тестировании или проверке фактической точности генерируемого текста, а не на принуждении к использованию детерминированных примитивов плюс проверке утверждений с источником и хешем верификации.
• Ручные рабочие процессы аналитиков с отчётами SEC: Аналитики могут проверять цифры напрямую из отчётов SEC и вычислять модели самостоятельно. Это отличается от программного рукопожатия Vouch, детерминированных примитивов и автоматизированной сертификации на основе источника в рабочем процессе вывода.