Comprobación de preparación para IA en Connect

Nota sobre la nomenclatura. Este flujo es una comprobación de preparación para IA, no una certificación. La herramienta genera una calificación en cuatro dimensiones. Esta comprobación no acredita que el documento esté «certificado» para ningún fin. El slug mantiene el segmento histórico ai-ready-certification por continuidad, pero el flujo es una evaluación de preparación que un proceso independiente puede confirmar o invalidar.

De un vistazo

Esta receta puntúa un documento en cuatro dimensiones —integridad (forense), longevidad (estado de la validación a largo plazo), estructura (contenido etiquetado/accesible) y legibilidad por máquina (extracción de texto)— con la herramienta de preparación para IA a través de los transportes de Connect. La herramienta es de nivel Enterprise. Se detecta mediante una sonda class_exists() y solo se registra cuando nextpdf/premium está instalado junto al servidor. La creación y el renderizado de documentos usan herramientas del núcleo.

El resultado con calificación (una nota con letra y las puntuaciones por dimensión) es la propia evaluación de preparación de la herramienta. No es una certificación. Un resultado de «Grade A» significa que las comprobaciones de la herramienta no hallaron ningún problema dentro de su alcance, no que una autoridad haya certificado el documento.

Instalación

composer require nextpdf/server

Confirmar que la herramienta de preparación para IA de Enterprise esté presente con una llamada tools/list. Consultar /connect/tool-catalog/.

Resumen conceptual

La dimensión de estructura premia una estructura etiquetada y en lenguaje natural que hace que el contenido sea extraíble por máquina en orden de lectura (ISO 32000-2 §14.7). La dimensión de longevidad refleja el material de validación a largo plazo. Los niveles de línea base PAdES son distintos, y el material de longevidad B-LT/B-LTA es una capacidad exclusiva de Enterprise (ETSI EN 319 142-2 §5.5). Una norma establece requisitos y un verificador los evalúa; el software productor no se autocertifica (PDF/A-4 §6.2.3). Por lo tanto, la puntuación es una señal de preparación, no una acreditación de conformidad ni una acreditación legal.

Superficie de la API

Los nombres de las herramientas se verifican contra el registro en ejecución mediante tools/list. El catálogo de referencia es /connect/tool-catalog/. Esta receta no duplica el recuento de herramientas.

Ejemplo de código: inicio rápido

Crear y renderizar un documento con las herramientas del núcleo y, a continuación, ejecutar la comprobación de preparación:

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

El nombre de la herramienta ai_ready_certify es el nombre registrado en el protocolo. El flujo que realiza es una comprobación de preparación, como indica la nota sobre la nomenclatura anterior.

Ejemplo de código: producción

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 respuesta incluye una calificación de nivel superior y puntuaciones por dimensión (integrity, longevity, structure, machine_readability) con hallazgos y recomendaciones. Tratar la calificación como una señal de preparación sobre la que actuar, no como un certificado.

Casos límite y trampas

Documento sin renderizar. La comprobación requiere un PDF finalizado; renderizar primero el documento.
PDF escaneado solo de imagen. La dimensión de legibilidad por máquina recibe una puntuación baja; aplicar OCR antes de comprobar.
Sin firmas presentes. La dimensión de longevidad es informativa; no se considera un fallo. La herramienta informa de la ausencia de material LTV; no la penaliza como manipulación.
Herramienta ausente. Sin nextpdf/premium, la herramienta de preparación para IA de Enterprise no se registra; la llamada falla con un error de herramienta desconocida.

Rendimiento

El presupuesto del front matter es un límite documentado. Los documentos grandes pueden agotar el tiempo de espera de análisis de la herramienta; conviene dividirlos en lugar de elevar un tiempo de espera global.

Notas de seguridad

La dimensión de integridad reutiliza el análisis forense, por lo que su subveredicto «limpio» conlleva la misma salvedad. Indica ausencia de modificaciones detectadas dentro del análisis realizado, no una garantía a prueba de manipulaciones. No registrar la ruta del documento ni el informe completo en un nivel de registro que se envíe externamente.

Conformidad

Afirmación	Cláusula	reference_id
Un verificador evalúa el documento; el software no se autocertifica	PDF/A-4 §6.2.3
Estructura etiquetada y en lenguaje natural → extraíble por máquina en orden de lectura	ISO 32000-2 §14.7
El material de longevidad B-LT/B-LTA es distinto y exclusivo de Enterprise	ETSI EN 319 142-2 §5.5

Contar con una comprobación de preparación para IA no es una certificación. El resultado con calificación es una evaluación de preparación. Cualquier decisión de certificación corresponde a un proceso independiente.

Contexto comercial

La herramienta de preparación para IA es de nivel Enterprise y se registra únicamente cuando nextpdf/premium está instalado junto al servidor.

Detalles específicos de Connect

Disponibilidad de transportes (MCP / REST / gRPC)

La llamada se realiza de la misma forma a través de MCP tools/call, del extremo de herramienta REST y del servicio gRPC mediante el ejecutor de herramientas compartido.

Nivel de riesgo HITL

La creación y el renderizado de documentos tienen nivel de precaución; la comprobación de preparación es de solo lectura. Ninguna es approval_required de forma predeterminada. Consultar /connect/hitl-risk-tiers/.

Sobre el JSON de la puerta de confirmación

Estas herramientas no activan la puerta a menos que una anulación del operador eleve alguna a approval_required. El contrato del sobre y del token de un solo uso se encuentra en /connect/hitl-risk-tiers/.

Véase también

/cookbook/connect/compliance-check/ — comprobación dirigida frente a una norma concreta.
/cookbook/connect/forensic-analysis/ — la dimensión de integridad en detalle.
/cookbook/connect/ltv-health-check/ — la dimensión de longevidad en detalle.
/connect/tool-catalog/ — cálculo del conjunto de herramientas por nivel.