Connect를 통한 AI 준비도 점검

Connect를 통한 AI 준비도 점검

명명 참고. 이 워크플로는 AI 준비도 점검이며, 인증이 아닙니다. 이 도구는 네 가지 측면에서 등급화된 점수를 산출합니다. 이 점검은 문서가 어떤 용도로든 “인증되었음”을 증명하지 않습니다. 연속성을 위해 슬러그는 기존 ai-ready-certification 세그먼트를 유지하지만, 이 워크플로는 독립적인 프로세스가 보강하거나 무효화할 수 있는 준비도 평가에 해당합니다.

한눈에 보기

이 레시피는 Connect 전송 계층에서 AI 준비도 도구를 사용하여 네 가지 측면 — 무결성(포렌식), 장기 보존성(장기 검증 상태), 구조(태그가 지정된/접근 가능한 콘텐츠), 기계 판독성(텍스트 추출) —에서 문서를 채점합니다. 이 도구는 Enterprise 등급입니다. class_exists() 프로브가 이를 탐지하며, nextpdf/premium이 서버와 함께 설치된 경우에만 등록됩니다. 문서 생성 및 렌더링에는 core 도구를 사용합니다.

등급화된 결과(문자 등급과 측면별 점수)는 도구 자체가 산출한 준비도 평가입니다. 이는 인증이 아닙니다. “Grade A” 결과는 도구의 점검이 해당 범위 안에서 문제를 발견하지 못했음을 의미하며, 어떤 기관이 문서를 인증했음을 의미하지 않습니다.

설치

composer require nextpdf/server

tools/list 호출로 Enterprise AI 준비도 도구가 있는지 확인합니다. /connect/tool-catalog/.를 참조하세요.

개념 개요

구조 측면은 콘텐츠를 읽기 순서대로 기계가 추출할 수 있게 만드는, 태그가 지정된 자연어 구조에 높은 점수를 부여합니다(ISO 32000-2 §14.7). 장기 보존성 측면은 장기 검증 자료를 반영합니다. PAdES 베이스라인 레벨은 서로 구별되며, B-LT/B-LTA 장기 보존성 자료는 Enterprise 전용 기능입니다(ETSI EN 319 142-2 §5.5). 표준은 검사기가 평가하는 요구 사항을 명시하며, 생성 소프트웨어가 자체 인증하지는 않습니다(PDF/A-4 §6.2.3). 따라서 이 점수는 준비도 신호이며, 적합성이나 법적 증명이 아닙니다.

API 표면

도구 이름은 tools/list를 통해 실행 중인 레지스트리와 대조하여 검증됩니다. 공식 카탈로그는 /connect/tool-catalog/.를 참조하세요. 이 레시피는 도구 개수를 다시 언급하지 않습니다.

코드 샘플 — 빠른 시작

core 도구로 문서를 생성하고 렌더링한 다음 준비도 점검을 실행합니다:

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

도구 이름 ai_ready_certify는 등록된 프로토콜 이름입니다. 앞의 명명 참고에서 설명했듯이, 이 도구가 수행하는 워크플로는 준비도 점검입니다.

코드 샘플 — 프로덕션

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

응답에는 최상위 등급과 측면별 점수(integrity, longevity, structure, machine_readability)가 발견 사항 및 권장 사항과 함께 담겨 있습니다. 등급은 인증서가 아니라 조치를 위한 준비도 신호로 취급하세요.

엣지 케이스 및 함정

• 문서가 렌더링되지 않음. 이 점검에는 최종 확정된 PDF가 필요합니다. 먼저 문서를 렌더링하세요.
• 스캔된 이미지 전용 PDF. 기계 판독성 측면의 점수가 낮게 나옵니다. 점검하기 전에 OCR을 수행하세요.
• 서명이 존재하지 않음. 장기 보존성 측면의 결과는 권고 사항이며, 실패가 아닙니다. 이 도구는 LTV 자료의 부재를 보고하며, 이를 변조로 간주하여 감점하지 않습니다.
• 도구 부재. nextpdf/premium 없이는 Enterprise AI 준비도 도구가 등록되지 않으며, 호출은 알 수 없는 도구 오류로 실패합니다.

성능

프런트매터 예산은 문서화된 상한값입니다. 대용량 문서는 도구의 분석 타임아웃에 도달할 수 있습니다. 전역 타임아웃을 높이기보다는 문서를 분할하세요.

보안 참고

무결성 측면은 포렌식 분석을 재사용하므로, 해당 “이상 없음” 하위 판정에도 동일한 주의 사항이 적용됩니다. 이는 수행된 분석 범위 내에서 변경이 감지되지 않았다는 뜻이며, 변조 불가 보장이 아닙니다. 외부로 전송되는 로그 수준에서는 문서 경로나 전체 보고서를 로깅하지 마세요.

적합성

주장	조항	reference_id
검사기가 문서를 평가하며, 소프트웨어는 자체 인증하지 않습니다	PDF/A-4 §6.2.3
태그가 지정된 자연어 구조 → 읽기 순서대로 기계 추출 가능	ISO 32000-2 §14.7
B-LT/B-LTA 장기 보존성 자료는 구별되며 Enterprise 전용	ETSI EN 319 142-2 §5.5

AI 준비도 점검 지원은 인증이 아닙니다. 등급화된 결과는 준비도 평가입니다. 인증 판정은 독립적인 프로세스가 내립니다.

상용 컨텍스트

AI 준비도 도구는 Enterprise 등급이며, nextpdf/premium이 서버와 함께 설치된 경우에만 등록됩니다.

Connect 세부 사항

전송 계층 가용성 (MCP / REST / gRPC)

이 호출은 공유 도구 실행기를 통해 MCP tools/call, REST 도구 엔드포인트, gRPC 서비스에서 같은 방식으로 호출됩니다.

HITL 위험 등급

문서 생성과 렌더링은 주의 수준이며, 준비도 점검은 읽기 전용입니다. 기본적으로 어느 작업도 approval_required 상태가 아닙니다. /connect/hitl-risk-tiers/.를 참조하세요.

확인 게이트 JSON 엔벨로프

운영자 재정의가 어느 하나를 approval_required로 격상하지 않는 한, 이러한 도구는 게이트를 트리거하지 않습니다. 엔벨로프 및 일회용 토큰 계약은 /connect/hitl-risk-tiers/.에 있습니다.

참고 자료

• /cookbook/connect/compliance-check/ — 지정된 명명 표준에 대한 대상 점검.
• /cookbook/connect/forensic-analysis/ — 무결성 측면에 대한 자세한 설명.
• /cookbook/connect/ltv-health-check/ — 장기 보존성 측면에 대한 자세한 설명.
• /connect/tool-catalog/ — 등급별 도구 집합 산정.