AI-gereedheidscontrole via Connect

Opmerking over de naamgeving. Deze workflow is een AI-gereedheidscontrole, geen certificering. De tool kent het document een score met gradatie toe op vier dimensies. De controle beweert niet dat het document voor welk doel dan ook is „gecertificeerd”. Voor de continuïteit behoudt de slug het historische ai-ready-certification-segment, maar de workflow blijft een gereedheidsbeoordeling die een onafhankelijk proces kan bevestigen of overschrijven.

In één oogopslag

Dit recipe beoordeelt een document op vier dimensies: integriteit (forensisch), levensduur (status van de langetermijnvalidatie), structuur (getagde/toegankelijke inhoud) en machineleesbaarheid (tekstextractie). Daarbij wordt de AI-gereedheidstool uitgevoerd via de Connect-transporten. De tool valt onder de Enterprise-laag. Met een class_exists()-test wordt de tool gedetecteerd, en de tool registreert zich alleen wanneer nextpdf/premium naast de server is geïnstalleerd. Het aanmaken en renderen van documenten blijft de core-tools gebruiken.

Het gegradeerde resultaat, een lettercijfer plus scores per dimensie, is de eigen gereedheidsbeoordeling van de tool. Het is geen certificering. Een resultaat „Grade A” betekent dat de controles van de tool binnen hun bereik geen problemen hebben gevonden. Het betekent niet dat een autoriteit het document heeft gecertificeerd.

Installeren

composer require nextpdf/server

Bevestig met een tools/list-aanroep dat de Enterprise AI-gereedheidstool aanwezig is. Zie /connect/tool-catalog/.

Conceptueel overzicht

De dimensie structuur beloont natuurlijke taal en getagde structuur, zodat inhoud machinaal in leesvolgorde kan worden geëxtraheerd (ISO 32000-2 §14.7). De dimensie levensduur weerspiegelt het langetermijnvalidatiemateriaal. De PAdES-baselineniveaus staan los van elkaar, en B-LT/B-LTA-levensduurmateriaal is een functie die alleen in Enterprise beschikbaar is (ETSI EN 319 142-2 §5.5). Een standaard formuleert vereisten die een controleprogramma evalueert; software die documenten produceert, certificeert zichzelf niet (PDF/A-4 §6.2.3). De score is daarom een gereedheidssignaal, geen conformiteits- of juridische verklaring.

API-oppervlak

Controleer toolnamen tegen het actieve register met tools/list. De gezaghebbende catalogus is /connect/tool-catalog/. Dit recipe herhaalt het aantal tools niet.

Codevoorbeeld — Snelstart

Maak en render een document met de core-tools en voer vervolgens de gereedheidscontrole uit:

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

De toolnaam ai_ready_certify is de geregistreerde protocolnaam. De workflow die hiermee wordt uitgevoerd is een gereedheidscontrole, zoals de opmerking over de naamgeving hierboven aangeeft.

Codevoorbeeld — Productie

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

Het antwoord bevat een algemene beoordeling en scores per dimensie (integrity, longevity, structure, machine_readability), plus bevindingen en aanbevelingen. Behandel de beoordeling als een gereedheidssignaal waarop je kunt handelen, niet als een certificaat.

Randgevallen en valkuilen

Document niet gerenderd. De controle vereist een voltooid PDF-bestand; render eerst het document.
Gescand PDF-bestand dat alleen afbeeldingen bevat. De dimensie machineleesbaarheid scoort laag; voer optische tekenherkenning (OCR) uit voordat je de controle uitvoert.
Geen handtekeningen aanwezig. De dimensie levensduur is adviserend, geen mislukking. De tool meldt de afwezigheid van langetermijnvalidatiemateriaal (LTV); de tool merkt dit niet aan als manipulatie.
Tool afwezig. Zonder nextpdf/premium is de Enterprise AI-gereedheidstool niet geregistreerd; de aanroep mislukt met een fout over een onbekende tool.

Prestaties

Het budget in de front matter is een documentatielimiet. Grote documenten kunnen de analysetime-out van de tool bereiken; splits ze op in plaats van de globale time-out te verhogen.

Beveiligingsnotities

De dimensie integriteit hergebruikt de forensische analyse, dus het subverdict „schoon” draagt hetzelfde voorbehoud. Het betekent dat binnen de uitgevoerde analyse geen wijzigingen zijn vastgesteld, niet dat er een manipulatiebestendige garantie is. Log het documentpad of het volledige rapport niet op een logniveau dat extern wordt verzonden.

Conformiteit

Bewering	Clausule	reference_id
Een controleprogramma evalueert het document; software certificeert zichzelf niet	PDF/A-4 §6.2.3
Getagde structuur in natuurlijke taal → machinaal extraheerbaar in leesvolgorde	ISO 32000-2 §14.7
B-LT/B-LTA-levensduurmateriaal is afzonderlijk en alleen in Enterprise beschikbaar	ETSI EN 319 142-2 §5.5

Ondersteuning voor een AI-gereedheidscontrole is geen certificering. Het gegradeerde resultaat is een gereedheidsbeoordeling. Elke certificeringsbeslissing ligt bij een onafhankelijk proces.

Commerciële context

De AI-gereedheidstool valt onder de Enterprise-laag en registreert zich alleen wanneer nextpdf/premium naast de server is geïnstalleerd.

Connect-specifieke details

Beschikbaarheid van transporten (MCP / REST / gRPC)

Voer de aanroep op dezelfde manier uit via Model Context Protocol (MCP) tools/call, het Representational State Transfer (REST)-tool-eindpunt en de gRPC-service via de gedeelde tool-executor.

HITL-risicolaag

Het aanmaken en renderen van documenten valt onder het waarschuwingsniveau; de gereedheidscontrole is alleen-lezen. Geen daarvan is standaard approval_required. Zie /connect/hitl-risk-niveaus/.

JSON-envelop van de bevestigingsgate

Deze tools activeren de gate niet, tenzij een operator-override een ervan verhoogt naar approval_required. Het contract voor de envelop en het eenmalige token staat in /connect/hitl-risk-niveaus/.

Zie ook

/cookbook/connect/compliance-check/ — gerichte controle tegen een benoemde standaard.
/cookbook/connect/forensic-analysis/ — de dimensie integriteit in detail.
/cookbook/connect/ltv-health-check/ — de dimensie levensduur in detail.
/connect/tool-catalog/ — berekening van de toolset per laag.