Pemeriksaan kesiapan AI melalui Connect

Catatan penamaan. Alur kerja ini adalah pemeriksaan kesiapan kecerdasan buatan (AI), bukan sertifikasi. Alat ini memberikan skor bertingkat kepada dokumen pada empat dimensi. Pemeriksaan ini tidak menyatakan bahwa dokumen “tersertifikasi” untuk tujuan apa pun. Slug mempertahankan segmen ai-ready-certification historis demi kesinambungan, tetapi alur kerjanya tetap merupakan penilaian kesiapan yang dapat dikonfirmasi atau ditolak oleh proses independen.

Sekilas pandang

Resep ini menilai dokumen pada empat dimensi: integritas (forensik), daya tahan jangka panjang (kesehatan validasi jangka panjang), struktur (konten bertanda/dapat diakses), dan keterbacaan mesin (ekstraksi teks). Resep ini menjalankan alat kesiapan AI melalui transport Connect. Alat ini berada di tingkat Enterprise. Pemeriksaan class_exists() mendeteksinya, dan alat ini hanya terdaftar bila nextpdf/premium terpasang bersama server. Pembuatan dan rendering dokumen tetap menggunakan alat inti.

Hasil bertingkat tersebut, yaitu nilai huruf beserta skor per dimensi, merupakan penilaian kesiapan dari alat itu sendiri. Ini bukan sertifikasi. Hasil “Grade A” berarti pemeriksaan alat ini tidak menemukan masalah dalam cakupannya. Ini tidak berarti suatu otoritas telah menyertifikasi dokumen tersebut.

Pemasangan

composer require nextpdf/server

Pastikan alat kesiapan AI Enterprise tersedia lewat panggilan tools/list. Lihat /connect/tool-catalog/.

Tinjauan konseptual

Dimensi struktur memberi nilai lebih pada struktur berbahasa alami dan bertanda yang membuat konten dapat diekstraksi mesin sesuai urutan baca (ISO 32000-2 §14.7). Dimensi daya tahan jangka panjang mencerminkan materi validasi jangka panjang. Tingkat baseline PAdES berbeda-beda, dan materi daya tahan B-LT/B-LTA merupakan kemampuan khusus Enterprise (ETSI EN 319 142-2 §5.5). Standar menetapkan persyaratan, lalu pemeriksa mengevaluasinya; perangkat lunak yang menghasilkan dokumen tidak menyertifikasi dirinya sendiri (PDF/A-4 §6.2.3). Oleh karena itu, skor ini merupakan sinyal kesiapan, bukan atestasi kesesuaian atau atestasi hukum.

Permukaan API

Verifikasi nama alat terhadap registry aktif dengan tools/list. Katalog rujukan resmi adalah /connect/tool-catalog/. Resep ini tidak mencantumkan ulang jumlah alat.

Contoh kode — Mulai cepat

Buat dan render dokumen menggunakan alat inti, lalu jalankan pemeriksaan kesiapan:

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

Nama alat ai_ready_certify adalah nama protokol yang terdaftar. Alur kerja yang dijalankannya adalah pemeriksaan kesiapan, sebagaimana disebutkan dalam catatan penamaan di atas.

Contoh kode — Produksi

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

Respons mencakup nilai tingkat teratas dan skor per dimensi (integrity, longevity, structure, machine_readability), beserta temuan dan rekomendasi. Perlakukan nilai tersebut sebagai sinyal kesiapan yang perlu ditindaklanjuti, bukan sebagai sertifikat.

Kasus tepi & jebakan

Dokumen belum dirender. Pemeriksaan ini memerlukan PDF yang sudah final; render dokumen terlebih dahulu.
PDF hasil pindai berisi gambar saja. Dimensi keterbacaan mesin mendapat skor rendah; jalankan pengenalan karakter optis (OCR) sebelum memeriksa.
Tidak ada tanda tangan. Dimensi daya tahan jangka panjang bersifat anjuran, bukan penanda kegagalan. Alat ini melaporkan ketiadaan materi validasi jangka panjang (LTV); alat ini tidak menganggapnya sebagai perusakan.
Alat tidak tersedia. Tanpa nextpdf/premium, alat kesiapan AI Enterprise tidak terdaftar; panggilan gagal dengan galat alat-tidak-dikenal.

Performa

Anggaran pada front-matter adalah batas dokumentasi. Dokumen besar dapat mencapai batas waktu analisis alat; pecah dokumen tersebut alih-alih menaikkan batas waktu global.

Catatan keamanan

Dimensi integritas menggunakan kembali analisis forensik, sehingga sub-keputusan “bersih” yang dihasilkannya membawa peringatan yang sama. Artinya, tidak terdeteksi adanya modifikasi dalam analisis yang dilakukan, bukan jaminan tahan terhadap perusakan. Jangan mencatat jalur dokumen atau laporan lengkap pada level log yang dikirim ke luar.

Kesesuaian

Klaim	Klausul	reference_id
Pemeriksa mengevaluasi dokumen; perangkat lunak tidak menyertifikasi dirinya sendiri	PDF/A-4 §6.2.3
Struktur berbahasa alami dan bertanda → dapat diekstraksi mesin sesuai urutan baca	ISO 32000-2 §14.7
Materi daya tahan B-LT/B-LTA berbeda dan khusus Enterprise	ETSI EN 319 142-2 §5.5

Dukungan untuk pemeriksaan kesiapan AI bukanlah sertifikasi. Hasil bertingkat tersebut adalah penilaian kesiapan. Setiap keputusan sertifikasi ditentukan oleh proses independen.

Konteks komersial

Alat kesiapan AI berada di tingkat Enterprise dan hanya terdaftar bila nextpdf/premium terpasang bersama server.

Kekhususan Connect

Ketersediaan transport (MCP / REST / gRPC)

Lakukan panggilan dengan cara yang sama melalui Model Context Protocol (MCP) tools/call, endpoint alat Representational State Transfer (REST), dan layanan gRPC melalui executor alat yang sama.

Tingkat risiko HITL

Pembuatan dan rendering dokumen berada di tingkat kehati-hatian; pemeriksaan kesiapan bersifat baca-saja. Secara baku, tidak ada yang approval_required. Lihat /connect/hitl-risk-tiers/.

Amplop JSON gerbang konfirmasi

Alat-alat ini tidak memicu gerbang tersebut kecuali jika override oleh operator menaikkan salah satunya menjadi approval_required. Kontrak amplop dan token sekali pakai ada di /connect/hitl-risk-tiers/.

Lihat juga

/cookbook/connect/compliance-check/ — pemeriksaan standar bernama yang ditargetkan.
/cookbook/connect/forensic-analysis/ — dimensi integritas secara rinci.
/cookbook/connect/ltv-health-check/ — dimensi daya tahan jangka panjang secara rinci.
/connect/tool-catalog/ — perhitungan set alat per tingkat.