Verificação de prontidão para IA no Connect

Observação sobre a nomenclatura. Este fluxo de trabalho é uma verificação de prontidão para inteligência artificial (IA), não uma certificação. A ferramenta atribui ao documento uma pontuação com nota em quatro dimensões. A verificação não afirma que o documento esteja “certificado” para qualquer finalidade. O slug mantém o segmento histórico ai-ready-certification por continuidade, mas o fluxo de trabalho continua sendo uma avaliação de prontidão que um processo independente pode confirmar ou anular.

Visão geral

Esta receita pontua um documento em quatro dimensões: integridade (forense), longevidade (saúde da validação de longo prazo), estrutura (conteúdo marcado/acessível) e legibilidade por máquina (extração de texto). Ela executa a ferramenta de prontidão para IA por meio dos transportes do Connect. A ferramenta é do tier Enterprise. Uma sondagem class_exists() a descobre, e ela só se registra quando o nextpdf/premium está instalado junto ao servidor. A criação e a renderização de documentos continuam usando as ferramentas do core.

O resultado com nota, uma letra acompanhada das pontuações por dimensão, é a própria avaliação de prontidão da ferramenta. Ela não é uma certificação. Um resultado “Grade A” significa que as verificações da ferramenta não encontraram problemas dentro do próprio escopo. Não significa que uma autoridade certificou o documento.

Instalação

composer require nextpdf/server

Confirme que a ferramenta de prontidão para IA do Enterprise está presente fazendo uma chamada tools/list. Consulte /connect/tool-catalog/.

Visão conceitual

A dimensão de estrutura valoriza a estrutura marcada e em linguagem natural que torna o conteúdo extraível por máquina na ordem de leitura (ISO 32000-2 §14.7). A dimensão de longevidade reflete o material de validação de longo prazo. Os níveis baseline do PAdES são distintos, e o material de longevidade B-LT/B-LTA é um recurso exclusivo do Enterprise (ETSI EN 319 142-2 §5.5). Um padrão estabelece requisitos para um verificador avaliar; o software produtor não se autocertifica (PDF/A-4 §6.2.3). Portanto, a pontuação é um sinal de prontidão, não uma atestação de conformidade nem uma atestação legal.

Superfície da API

Verifique os nomes das ferramentas no registro em execução com tools/list. O catálogo de referência está em /connect/tool-catalog/. Esta receita não repete a contagem de ferramentas.

Exemplo de código — Início rápido

Crie e renderize um documento com as ferramentas do core e, em seguida, execute a verificação de prontidão:

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

O nome da ferramenta ai_ready_certify é o nome de protocolo registrado. O fluxo de trabalho que ela executa é uma verificação de prontidão, como indicado na observação sobre a nomenclatura acima.

Exemplo de código — Produção

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; }

A resposta inclui uma nota geral e pontuações por dimensão (integrity, longevity, structure, machine_readability), além de constatações e recomendações. Trate a nota como um sinal de prontidão acionável, não como um certificado.

Casos extremos & armadilhas

Documento não renderizado. A verificação requer um PDF finalizado; renderize o documento primeiro.
PDF digitalizado, somente imagem. A dimensão de legibilidade por máquina recebe pontuação baixa; execute o reconhecimento óptico de caracteres (OCR) antes de verificar.
Nenhuma assinatura presente. A dimensão de longevidade é informativa, não uma falha. A ferramenta relata a ausência de material de validação de longo prazo (LTV), mas não a penaliza como adulteração.
Ferramenta ausente. Sem o nextpdf/premium, a ferramenta de prontidão para IA do Enterprise não é registrada; a chamada falha com erro de ferramenta desconhecida.

Desempenho

O orçamento definido no front-matter é um limite de documentação. Documentos grandes podem atingir o tempo limite de análise da ferramenta; divida-os em vez de aumentar um tempo limite global.

Notas de segurança

A dimensão de integridade reutiliza a análise forense, portanto seu subveredito “limpo” carrega a mesma ressalva. Ele significa ausência detectada de modificação dentro da análise realizada, não uma garantia à prova de adulteração. Não registre o caminho do documento nem o relatório completo em um nível de log enviado externamente.

Conformidade

Afirmação	Cláusula	reference_id
Um verificador avalia o documento; o software não se autocertifica	PDF/A-4 §6.2.3
Estrutura marcada em linguagem natural → extraível por máquina na ordem de leitura	ISO 32000-2 §14.7
O material de longevidade B-LT/B-LTA é distinto e exclusivo do Enterprise	ETSI EN 319 142-2 §5.5

O suporte a uma verificação de prontidão para IA não é uma certificação. O resultado com nota é uma avaliação de prontidão. Qualquer decisão de certificação cabe a um processo independente.

Contexto comercial

A ferramenta de prontidão para IA é do tier Enterprise e só se registra quando o nextpdf/premium está instalado junto ao servidor.

Especificidades do Connect

Disponibilidade de transporte (MCP / REST / gRPC)

Faça a chamada da mesma forma pelo Model Context Protocol (MCP) tools/call, pelo endpoint de ferramenta Representational State Transfer (REST) e pelo serviço gRPC, por meio do executor de ferramentas compartilhado.

Tier de risco HITL

A criação e a renderização de documentos ficam no nível de cautela; a verificação de prontidão é somente leitura. Nenhuma delas é approval_required por padrão. Consulte /connect/hitl-risk-tiers/.

Envelope JSON do gate de confirmação

Essas ferramentas não acionam o gate, a menos que uma substituição de operador eleve uma delas para approval_required. O contrato do envelope e do token de uso único está em /connect/hitl-risk-tiers/.

Veja também

/cookbook/connect/compliance-check/ — verificação direcionada de um padrão nomeado.
/cookbook/connect/forensic-analysis/ — a dimensão de integridade em detalhe.
/cookbook/connect/ltv-health-check/ — a dimensão de longevidade em detalhe.
/connect/tool-catalog/ — cálculo do conjunto de ferramentas por tier.