Проверка готовности к ИИ через Connect

Примечание об именовании. Этот рабочий процесс — проверка готовности к искусственному интеллекту (ИИ), а не сертификация. Инструмент оценивает документ по четырём измерениям и присваивает буквенный рейтинг. Проверка не заявляет, что документ “сертифицирован” для какой-либо цели. Слаг сохраняет исторический сегмент ai-ready-certification ради преемственности, но рабочий процесс остаётся оценкой готовности, которую независимая процедура может подтвердить или переопределить.

Кратко

Этот рецепт оценивает документ по четырём измерениям: целостность (криминалистический анализ), долговечность (состояние долгосрочной проверки подписи), структура (теги и доступный контент) и машиночитаемость (извлечение текста). Он запускает инструмент проверки готовности к ИИ через транспорты Connect. Инструмент относится к уровню Enterprise. Его наличие определяется через class_exists(), и инструмент регистрируется только тогда, когда nextpdf/premium установлен вместе с сервером. Создание и отрисовка документа по-прежнему выполняются инструментами core.

Результат проверки — буквенный рейтинг и баллы по каждому измерению — это собственная оценка готовности, сформированная инструментом. Это не сертификация. Результат “оценка A” означает, что проверки инструмента не обнаружили проблем в пределах своей области. Это не означает, что какой-либо орган сертифицировал документ.

Установка

composer require nextpdf/server

Проверьте, что инструмент проверки готовности к ИИ уровня Enterprise присутствует, вызвав tools/list. См. /connect/tool-catalog/.

Концептуальный обзор

Измерение структуры выше оценивает тегированную структуру на естественном языке, которая делает контент машинно-извлекаемым в порядке чтения (ISO 32000-2 §14.7). Измерение долговечности отражает наличие материала для долгосрочной проверки подписи. Базовые уровни PAdES различаются, а материал долговечности B-LT/B-LTA — это возможность, доступная только на уровне Enterprise (ETSI EN 319 142-2 §5.5). Стандарт устанавливает требования, которые оценивает средство проверки; программа-генератор не самосертифицируется (PDF/A-4 §6.2.3). Поэтому оценка — это сигнал готовности, а не подтверждение соответствия или юридическое заверение.

Поверхность API

Сверяйте имена инструментов с действующим реестром с помощью tools/list. Официальный каталог — /connect/tool-catalog/. Этот рецепт не повторяет число инструментов.

Пример кода — быстрый старт

Создайте и отрисуйте документ с помощью инструментов core, затем запустите проверку готовности:

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "ai_ready_certify",
    "arguments": { "document_id": "<id of a rendered document>" }
  }
}

Имя инструмента ai_ready_certify — это зарегистрированное имя протокола. Рабочий процесс, который он выполняет, — это проверка готовности, как указано в примечании об именовании выше.

Пример кода — продакшен

curl -sS -X POST https://connect.example.com/v1/tools/ai_ready_certify \
  -H 'Authorization: Bearer '"$NEXTPDF_CONNECT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"document_id":"<id>"}' \
  -o /tmp/ai-ready.json -w '%{http_code}' > /tmp/ai-ready-status || {
    echo "transport failure invoking ai_ready_certify" >&2; exit 1; }

Ответ содержит общий рейтинг и баллы по каждому измерению (integrity, longevity, structure, machine_readability), а также выявленные проблемы и рекомендации. Воспринимайте рейтинг как сигнал готовности для дальнейших действий, а не как сертификат.

Граничные случаи и подводные камни

Документ не отрисован. Для проверки нужен готовый PDF; сначала отрисуйте документ.
Отсканированный PDF, содержащий только изображения. Измерение машиночитаемости получает низкий балл; перед проверкой выполните оптическое распознавание символов (OCR).
Подписи отсутствуют. Измерение долговечности носит рекомендательный характер; это не сбой. Инструмент сообщает об отсутствии материала долгосрочной проверки подписи (LTV), но не считает это признаком подделки.
Инструмент отсутствует. Без nextpdf/premium инструмент проверки готовности к ИИ уровня Enterprise не регистрируется; вызов завершается ошибкой о неизвестном инструменте.

Производительность

Бюджет, указанный во фронтматтере, — это документационный предел. Большие документы могут не уложиться в тайм-аут анализа инструмента; делите их, а не повышайте глобальный тайм-аут.

Замечания по безопасности

Измерение целостности повторно использует криминалистический анализ, поэтому вердикт “чисто” для этого измерения сопровождается той же оговоркой. Это означает, что в рамках выполненного анализа изменений не обнаружено; это не гарантия защиты от подделки. Не записывайте путь к документу или полный отчёт в журнал на уровне логирования, данные которого передаются вовне.

Соответствие

Утверждение	Пункт	reference_id (идентификатор ссылки)
Средство проверки оценивает документ; программа не самосертифицируется	PDF/A-4 §6.2.3
Тегированная структура на естественном языке → машинно-извлекаемость в порядке чтения	ISO 32000-2 §14.7
Материал долговечности B-LT/B-LTA является отдельным и доступен только на уровне Enterprise	ETSI EN 319 142-2 §5.5

Поддержка проверки готовности к ИИ не является сертификацией. Результат проверки с оценкой — это оценка готовности. Любое решение о сертификации принимает независимый процесс.

Коммерческий контекст

Инструмент проверки готовности к ИИ относится к уровню Enterprise и регистрируется только тогда, когда nextpdf/premium установлен вместе с сервером.

Особенности Connect

Доступность транспортов (MCP / REST / gRPC)

Выполняйте один и тот же вызов через Model Context Protocol (MCP) tools/call, через конечную точку инструмента Representational State Transfer (REST) и через службу gRPC с помощью общего исполнителя инструментов.

Уровень риска HITL

Создание и отрисовка документа относятся к уровню caution; проверка готовности работает только на чтение. Ни один из этих инструментов по умолчанию не имеет значения approval_required. См. /connect/hitl-risk-tiers/.

JSON-обёртка шлюза подтверждения

Эти инструменты не активируют шлюз, если переопределение оператором не повышает один из них до approval_required. Контракт обёртки и одноразового токена описан в /connect/hitl-risk-tiers/.

См. также

/cookbook/connect/compliance-check/ — целевая проверка по именованному стандарту.
/cookbook/connect/forensic-analysis/ — подробно об измерении целостности.
/cookbook/connect/ltv-health-check/ — подробно об измерении долговечности.
/connect/tool-catalog/ — расчёт набора инструментов по уровню.