Машиночитаемая архитектура цифрового паспорта компании решает главную инженерную проблему современных систем генеративного поиска RAG: она позволяет поисковым краулерам и корпоративным ИИ-агентам извлекать 100% проверенных юридических и технических фактов об организации при сокращении объёма передаваемых данных и расхода токенов в 8–10 раз. Согласно исследованию Принстонского университета на конференции ACM SIGKDD 2024, чёткая структурированность данных, наличие точных числовых атрибутов и явных ссылок на первоисточники повышают видимость сущности в ответах генеративных моделей на 30–40%.
Когда агент реального времени OAI-SearchBot, PerplexityBot или корпоративный ассистент на базе Claude и Gemini проверяет белорусское предприятие из базы в 17 258 действующих юридических лиц, парсинг тяжёлой клиентской вёрстки обычного сайта приводит к потере контекста и обрезанию важных таблиц. Именно поэтому каждая карточка на платформе digitalpassport.by синхронно отдаётся в четырёх специализированных представлениях, полная спецификация которых опубликована в документации для разработчиков и ИИ-агентов.
Сравнение четырёх контуров отдачи данных по объёму в байтах и расходу токенов
В таблице ниже приведены результаты прямого замера веса и токенизации одной и той же обогащённой карточки белорусского предприятия при обращении к четырём конечным точкам платформы:
| Машиночитаемый контур | Адрес обращения или HTTP-заголовок | Средний вес ответа | Примерный объём в токенах LLM | Основное инженерное назначение |
|---|---|---|---|---|
| 1. Серверный HTML5 со встроенным Schema.org | GET /{unp}-{slug} | 38,0 КБ | Около 9 500 токенов | Визуальное чтение человеком с мобильных и настольных устройств, классическая индексация роботами Google и Яндекса |
| 2. Чистый семантический Markdown | GET /{unp}-{slug}.md или Accept: text/markdown | 3,4 КБ | Около 850 токенов | Прямая подача в контекстное окно поисковых ИИ-агентов и RAG-пайплайнов с экономией токенов более чем в 10 раз |
| 3. Детерминированный JSON-паспорт | GET /{unp}-{slug}.json и GET /api/v1/companies/{unp} | 4,2 КБ | Около 1 050 токенов | Автоматическая сверка реквизитов, статуса ГРП МНС, БелГИЭ и специализаций в системах ERP, CRM и модулях закупок |
| 4. Вызов инструмента MCP JSON-RPC 2.0 | POST /api/mcp | 1,8 КБ | Около 450 токенов | Мгновенный поиск компании по 9 цифрам УНП, городу и узкой специализации из агентных сред Claude, Cursor и OpenAI |
Отсутствие клиентских JavaScript-фреймворков и инлайновых стилей на страницах паспортов гарантирует, что даже базовая HTML-версия загружается за один сетевой цикл, а поддержка согласования контента через HTTP-заголовок Accept: text/markdown позволяет продвинутым ИИ-краулерам автоматически получать легковесную текстовую копию по основному адресу страницы.
Как устроен связанный граф Schema.org JSON-LD из пяти сущностей
На большинстве корпоративных сайтов микроразметка либо отсутствует вовсе, либо ограничена разрозненным блоком контактов. Серверный построитель PassportSchemaBuilder формирует для каждого цифрового паспорта единый связанный граф @graph, где пять семантических узлов соединены сквозными постоянными идентификаторами @id:
1. Сущность Organization: фиксирует официальное наименование, статус legalStatus, дату регистрации foundingDate, адрес и уникальный 9-значный УНП одновременно в свойстве taxID и структурированном узле PropertyValue. В массив knowsAbout передаются не только базовый вид деятельности по ОКЭД, но и подтверждённые узкие специализации из 35 канонических направлений — подробнее о принципе их выделения читайте в статье почему код ОКЭД не показывает реальные услуги.
2. Сущность Dataset: описывает саму верифицированную карточку предприятия как открытый набор данных с указанием первоисточников ГРП МНС, ЕГР, ФСЗН и РУП «БелГИЭ», точной даты актуальности dateModified и массива distribution с прямыми ссылками DataDownload на выгрузку паспорта в форматах application/json и text/markdown.
3. Сущность FAQPage: автоматически формирует детерминированные пары вопрос-ответ по ключевым проверяемым параметрам конкретного юридического лица — статусу налогоплательщика, возрасту компании, номеру регистрации домена в БелГИЭ по Указу №60 и перечню оказываемых услуг.
4. Сущности WebSite и BreadcrumbList: связывают карточку предприятия с отраслевой и географической иерархией каталога компаний, помогая поисковым алгоритмам точно позиционировать организацию по городу и профильной рубрике.
Роль навигационных манифестов `/llms.txt`, `/llms-full.txt` и сервера MCP
Для того чтобы внешние языковые модели и разработчики корпоративных ИИ-ассистентов могли ориентироваться во всей базе из 17 258 компаний и 1 992 проверенных сайтов без полного перебора страниц, на уровне домена развёрнуты три точки навигации:
- Краткий манифест
/llms.txt: содержит структурированную карту основных разделов платформы, прямые ссылки на 13 приоритетных отраслевых рубрик, методологию о проекте и сводную страницу открытого бенчмарка на 200 запросах; - Полная спецификация
/llms-full.txt: описывает правила разграничения контуров данных между государственными реестрами, техническим аудитом и кабинетом владельца, формулу расчёта 100-балльного индекса полноты и шаблоны URL для обращения к карточкам.mdи.json; - Сервер Model Context Protocol
POST /api/mcp: реализует стандарт JSON-RPC 2.0 и предоставляет внешним ИИ-агентам четыре готовых инструмента:get_company_by_unp,search_companies,list_categoriesиget_platform_methodology.
Именно сочетание собственной микроразметки на корпоративном сайте со ссылкой в поле sameAs на канонический цифровой паспорт по УНП создаёт эталонную архитектуру данных, которую поисковые системы считывают без искажений. Фактическая статистика обращений роботов к HTML, Markdown и JSON-представлениям в реальном времени открыта в разделе мониторинга ИИ-ботов, а проверить и бесплатно подтвердить цифровой паспорт своей компании можно в разделе создания паспорта.