Contrôle de préparation à l'IA via Connect

Contrôle de préparation à l’IA via Connect

Note de nommage. Ce flux de travail est un contrôle de préparation à l’IA, pas une certification. L’outil produit une note calculée selon quatre dimensions. Ce contrôle n’atteste pas que le document est « certifié » pour un usage quelconque. Le slug conserve l’ancien segment ai-ready-certification par continuité, mais le flux de travail reste une évaluation de préparation qu’un processus indépendant peut corroborer ou remplacer.

En bref

Cette recette évalue un document selon quatre dimensions — l’intégrité (analyse forensique), la longévité (état de la validation à long terme), la structure (contenu balisé/accessible) et la lisibilité machine (extraction de texte) — à l’aide de l’outil de préparation à l’IA via les transports Connect. L’outil relève de l’édition Enterprise. Une sonde class_exists() permet de le détecter, et il ne s’enregistre que lorsque nextpdf/premium est installé aux côtés du serveur. La création et le rendu du document utilisent les outils du cœur.

Le résultat noté, c’est-à-dire une note alphabétique accompagnée de scores par dimension, est l’évaluation de préparation propre à l’outil. Ce n’est pas une certification. Un résultat « Grade A » signifie que les contrôles de l’outil n’ont trouvé aucun problème dans leur périmètre, et non qu’une autorité a certifié le document.

Installation

composer require nextpdf/server

Confirme la présence de l’outil de préparation à l’IA Enterprise par un appel à tools/list. Consulte /connect/tool-catalog/.

Vue d’ensemble conceptuelle

La dimension structure valorise un contenu en langage naturel correctement balisé, qui rend l’extraction machine possible dans l’ordre de lecture (ISO 32000-2 §14.7). La dimension longévité reflète les éléments de validation à long terme. Les niveaux baseline PAdES sont distincts, et les éléments de longévité B-LT/B-LTA constituent une capacité réservée à l’édition Enterprise (ETSI EN 319 142-2 §5.5). Une norme énonce des exigences qu’un vérificateur évalue ; le logiciel producteur ne s’autocertifie pas (PDF/A-4 §6.2.3). Le score est donc un signal de préparation, et non une attestation de conformité ou juridique.

Surface de l’API

Les noms d’outils sont vérifiés par rapport au registre en cours d’exécution via tools/list. Le catalogue de référence est /connect/tool-catalog/. Cette recette ne répète pas le décompte des outils.

Exemple de code — Démarrage rapide

Crée un document et fais-en le rendu avec les outils du cœur, puis exécute le contrôle de préparation :

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

Le nom d’outil ai_ready_certify est le nom de protocole enregistré. Le flux de travail qu’il exécute est un contrôle de préparation, comme l’indique la note de nommage ci-dessus.

Exemple de code — Production

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 réponse contient une note de premier niveau et des scores par dimension (integrity, longevity, structure, machine_readability) accompagnés de constats et de recommandations. Traite la note comme un signal de préparation sur lequel agir, et non comme un certificat.

Cas limites & pièges

• Document non rendu. Le contrôle exige un PDF finalisé ; fais d’abord le rendu du document.
• PDF numérisé sans texte (image seule). La dimension lisibilité machine obtient un faible score ; applique l’OCR avant le contrôle.
• Aucune signature présente. La dimension longévité reste indicative et ne constitue pas un échec. L’outil signale l’absence d’éléments LTV ; il ne la pénalise pas comme une altération.
• Outil absent. Sans nextpdf/premium, l’outil de préparation à l’IA Enterprise n’est pas enregistré ; l’appel échoue avec une erreur d’outil inconnu.

Performances

Le budget du frontmatter sert de plafond documentaire. Les documents volumineux peuvent atteindre la limite de délai d’analyse de l’outil ; segmente-les plutôt que de relever un délai global.

Notes de sécurité

La dimension intégrité réutilise l’analyse forensique, de sorte que son sous-verdict « clean » s’accompagne de la même réserve. Il s’agit d’une absence de modification détectée dans le cadre de l’analyse effectuée, et non d’une garantie d’inviolabilité. Ne journalise pas le chemin du document ni le rapport complet à un niveau de log transmis à l’extérieur.

Conformité

Affirmation	Clause	reference_id
Un vérificateur évalue le document ; le logiciel ne s’autocertifie pas	PDF/A-4 §6.2.3
Structure balisée en langage naturel → extractible par machine dans l’ordre de lecture	ISO 32000-2 §14.7
Les éléments de longévité B-LT/B-LTA sont distincts et réservés à l’édition Enterprise	ETSI EN 319 142-2 §5.5

La prise en charge d’un contrôle de préparation à l’IA n’est pas une certification. Le résultat noté est une évaluation de préparation. Toute décision de certification relève d’un processus indépendant.

Contexte commercial

L’outil de préparation à l’IA relève de l’édition Enterprise et ne s’enregistre que lorsque nextpdf/premium est installé aux côtés du serveur.

Spécificités Connect

Disponibilité des transports (MCP / REST / gRPC)

L’appel s’exécute de la même façon via MCP tools/call, le point de terminaison d’outil REST et le service gRPC, par l’intermédiaire de l’exécuteur d’outils partagé.

Niveau de risque HITL

La création et le rendu du document sont de niveau « prudence » ; le contrôle de préparation est en lecture seule. Aucun de ces outils n’est approval_required par défaut. Consulte /connect/hitl-risk-tiers/.

Enveloppe JSON du verrou de confirmation

Ces outils ne déclenchent pas le verrou, sauf si une dérogation d’opérateur fait passer l’un d’eux à approval_required. L’enveloppe et le contrat de jeton à usage unique figurent dans /connect/hitl-risk-tiers/.

Voir aussi

• /cookbook/connect/compliance-check/ — contrôle ciblé d’une norme nommée.
• /cookbook/connect/forensic-analysis/ — la dimension intégrité en détail.
• /cookbook/connect/ltv-health-check/ — la dimension longévité en détail.
• /connect/tool-catalog/ — calcul du jeu d’outils par édition.