Verifica della prontezza per l'IA con Connect

Verifica della prontezza per l’IA con Connect

Nota sulla denominazione. Questo flusso di lavoro è una verifica della prontezza per l’IA, non una certificazione. Lo strumento genera un punteggio graduato su quattro dimensioni. La verifica non attesta che il documento sia «certificato» per alcuno scopo. Lo slug conserva per continuità il segmento storico ai-ready-certification, ma il flusso di lavoro resta una valutazione della prontezza che un processo indipendente può confermare o sovrascrivere.

In sintesi

Questa ricetta assegna a un documento un punteggio su quattro dimensioni — integrità (forense), longevità (stato della convalida a lungo termine), struttura (contenuto taggato/accessibile) e leggibilità automatica (estrazione del testo) — usando lo strumento di prontezza per l’IA tramite i trasporti Connect. Lo strumento è di livello Enterprise. Una sonda class_exists() lo rileva; viene registrato solo quando nextpdf/premium è installato insieme al server. La creazione e il rendering dei documenti avvengono con gli strumenti core.

Il risultato graduato (un voto espresso in lettere più i punteggi per dimensione) è la valutazione della prontezza prodotta dallo strumento. Non è una certificazione. Un risultato di «Grado A» significa che le verifiche dello strumento non hanno riscontrato alcun problema nel proprio ambito, non che un’autorità abbia certificato il documento.

Installazione

composer require nextpdf/server

Verificare la presenza dello strumento Enterprise di prontezza per l’IA con una chiamata tools/list. Vedere /connect/tool-catalog/.

Panoramica concettuale

La dimensione della struttura premia una struttura taggata e in linguaggio naturale, che rende il contenuto estraibile automaticamente nell’ordine di lettura (ISO 32000-2 §14.7). La dimensione della longevità riflette il materiale di convalida a lungo termine. I livelli baseline PAdES sono distinti e il materiale di longevità B-LT/B-LTA è una funzionalità riservata a Enterprise (ETSI EN 319 142-2 §5.5). Uno standard enuncia requisiti che un verificatore valuta; il software produttore non si autocertifica (PDF/A-4 §6.2.3). Il punteggio è quindi un segnale di prontezza, non un’attestazione di conformità o un’attestazione legale.

Superficie dell’API

I nomi degli strumenti vanno verificati nel registro in esecuzione tramite tools/list. Il catalogo di riferimento è /connect/tool-catalog/. Questa ricetta non ripete il conteggio degli strumenti.

Esempio di codice — Avvio rapido

Creare un documento ed eseguirne il rendering con gli strumenti core, quindi eseguire la verifica della prontezza:

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

Il nome dello strumento ai_ready_certify è quello registrato nel protocollo. Il flusso di lavoro che avvia è una verifica della prontezza, come indicato dalla nota sulla denominazione qui sopra.

Esempio di codice — Produzione

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

La risposta riporta un voto di primo livello e i punteggi per dimensione (integrity, longevity, structure, machine_readability), con riscontri e raccomandazioni. Trattare il voto come un segnale di prontezza su cui intervenire, non come un certificato.

Casi limite e insidie

• Documento non sottoposto a rendering. La verifica richiede un PDF finalizzato; eseguire prima il rendering del documento.
• PDF acquisito composto solo da immagini. La dimensione della leggibilità automatica ottiene un punteggio basso; applicare l’OCR prima della verifica.
• Nessuna firma presente. La dimensione della longevità ha valore consultivo, non indica un fallimento. Lo strumento segnala l’assenza di materiale LTV; non la tratta come manomissione.
• Strumento assente. Senza nextpdf/premium lo strumento Enterprise di prontezza per l’IA non è registrato; la chiamata fallisce con un errore di strumento sconosciuto.

Prestazioni

Il budget nel front matter è un tetto dichiarato nella documentazione. I documenti di grandi dimensioni possono raggiungere il timeout di analisi dello strumento; suddividerli anziché aumentare un timeout globale.

Note sulla sicurezza

La dimensione dell’integrità riutilizza l’analisi forense, quindi il suo sottoverdetto «pulito» porta con sé lo stesso avvertimento. Si tratta di un’assenza di modifiche rilevate nell’ambito dell’analisi eseguita, non di una garanzia a prova di manomissione. Non registrare il percorso del documento o il report completo in un livello di log inoltrato all’esterno.

Conformità

Asserzione	Clausola	reference_id
Un verificatore valuta il documento; il software non si autocertifica	PDF/A-4 §6.2.3
Struttura taggata in linguaggio naturale → estraibile automaticamente nell’ordine di lettura	ISO 32000-2 §14.7
Il materiale di longevità B-LT/B-LTA è distinto e riservato a Enterprise	ETSI EN 319 142-2 §5.5

Il supporto a una verifica della prontezza per l’IA non è una certificazione. Il risultato graduato è una valutazione della prontezza. Qualsiasi determinazione di certificazione spetta a un processo indipendente.

Contesto commerciale

Lo strumento di prontezza per l’IA è di livello Enterprise e si registra solo quando nextpdf/premium è installato insieme al server.

Specifiche di Connect

Disponibilità dei trasporti (MCP / REST / gRPC)

La chiamata viene invocata nello stesso modo tramite MCP tools/call, l’endpoint REST dello strumento e il servizio gRPC, passando dall’esecutore di strumenti condiviso.

Livello di rischio HITL

La creazione e il rendering dei documenti sono di livello caution; la verifica della prontezza è di sola lettura. Per impostazione predefinita nessuna di queste operazioni è approval_required. Vedere /connect/hitl-risk-tiers/.

Envelope JSON del gate di conferma

Questi strumenti non attivano il gate a meno che una sovrascrittura dell’operatore non imposti uno di essi a approval_required. Il contratto dell’envelope e del token monouso si trova in /connect/hitl-risk-tiers/.

Vedere anche

• /cookbook/connect/compliance-check/ — verifica mirata di uno standard denominato.
• /cookbook/connect/forensic-analysis/ — la dimensione dell’integrità in dettaglio.
• /cookbook/connect/ltv-health-check/ — la dimensione della longevità in dettaglio.
• /connect/tool-catalog/ — calcolo dell’insieme di strumenti per livello.