Connect üzerinden yapay zekâya hazırlık denetimi

Adlandırma notu. Bu iş akışı bir yapay zekâ (AI) hazırlık denetimidir; sertifikalandırma değildir. Araç, belge için dört boyutta derecelendirilmiş bir puan üretir. Bu denetim, belgenin herhangi bir amaç için “sertifikalı” olduğunu ifade etmez. URL kısa adı, geriye dönük süreklilik için geçmişten gelen ai-ready-certification bölümünü korur, ancak iş akışı bağımsız bir süreç tarafından onaylanabilecek veya geçersiz kılınabilecek bir hazırlık değerlendirmesi olmaya devam eder.

Genel bakış

Bu tarif, bir belgeyi dört boyutta puanlar: bütünlük (adli), kalıcılık (uzun vadeli doğrulama sağlığı), yapı (etiketli/erişilebilir içerik) ve makine okunabilirliği (metin çıkarma). Yapay zekâya hazırlık aracını Connect aktarımları üzerinden çalıştırır. Araç Enterprise katmanındadır. Bir class_exists() yoklaması aracı bulur ve araç yalnızca nextpdf/premium sunucuyla birlikte kurulduğunda kaydolur. Belge oluşturma ve işleme için yine çekirdek araçlar kullanılır.

Derecelendirilmiş sonuç, yani bir harf notu ile boyut başına puanlar, aracın kendi hazırlık değerlendirmesidir. Bu bir sertifikalandırma değildir. “A” notu sonucu, aracın denetimlerinin kendi kapsamları içinde herhangi bir sorun bulamadığı anlamına gelir. Bir makamın belgeyi sertifikalandırdığı anlamına gelmez.

Kurulum

composer require nextpdf/server

Enterprise yapay zekâya hazırlık aracının kullanılabilir olduğunu bir tools/list çağrısıyla doğrulayın. Bkz. /connect/tool-catalog/.

Kavramsal genel bakış

Yapı boyutu, içeriği okuma sırasına göre makine tarafından çıkarılabilir kılan etiketli ve doğal dil içeren yapıyı ödüllendirir (ISO 32000-2 §14.7). Kalıcılık boyutu, uzun vadeli doğrulama malzemesini yansıtır. PAdES temel düzeyleri birbirinden farklıdır ve B-LT/B-LTA kalıcılık malzemesi yalnızca Enterprise’a özgü bir yetenektir (ETSI EN 319 142-2 §5.5). Bir standart, denetleyicinin değerlendirmesi için gereksinimleri belirtir; üreten yazılım kendini sertifikalandırmaz (PDF/A-4 §6.2.3). Bu nedenle puan, bir uyumluluk veya yasal beyan değil, bir hazırlık göstergesidir.

API yüzeyi

Araç adlarını tools/list ile çalışan kayıt defteriyle karşılaştırarak doğrulayın. Resmi katalog /connect/tool-catalog/ adresindedir. Bu tarif, araç sayısını yeniden belirtmez.

Kod örneği — hızlı başlangıç

Çekirdek araçlarla bir belge oluşturup işleyin, ardından hazırlık denetimini çalıştırın:

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

Araç adı ai_ready_certify, kayıtlı protokol adıdır. Gerçekleştirdiği iş akışı, yukarıdaki adlandırma notunda belirtildiği gibi bir hazırlık denetimidir.

Kod örneği — üretim

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

Yanıt, üst düzeyde bir notu, boyut başına puanları (integrity, longevity, structure, machine_readability) ve ayrıca bulgularla önerileri içerir. Notu, bir sertifika olarak değil, üzerinden işlem yapılacak bir hazırlık göstergesi olarak değerlendirin.

Sınır durumları ve tuzaklar

Belge işlenmemiş. Denetim, sonlandırılmış bir PDF gerektirir; önce belgeyi işleyin.
Yalnızca taranmış görüntü içeren PDF. Makine okunabilirliği boyutu düşük puan alır; denetimden önce optik karakter tanıma (OCR) çalıştırın.
İmza yok. Kalıcılık boyutu bir başarısızlık değil, yol göstericidir. Araç, uzun vadeli doğrulama (LTV) malzemesinin yokluğunu bildirir; bunu kurcalama olarak cezalandırmaz.
Araç yok. nextpdf/premium olmadan Enterprise yapay zekâya hazırlık aracı kaydedilmez; çağrı, bilinmeyen araç hatası vererek başarısız olur.

Performans

Ön bilgi (front-matter) bütçesi, dokümantasyon amaçlı bir üst sınırdır. Büyük belgeler aracın çözümleme zaman aşımına ulaşabilir; genel zaman aşımını artırmak yerine belgeleri bölün.

Güvenlik notları

Bütünlük boyutu, adli çözümlemeyi yeniden kullanır; bu nedenle “temiz” alt sonucu da aynı uyarıyı taşır. Bu, kurcalamaya karşı dayanıklılık güvencesi değil; yapılan çözümleme kapsamında değişiklik saptanmadığı anlamına gelir. Belge yolunu veya tam raporu dışarıya gönderilen bir günlük düzeyinde kayda almayın.

Uyumluluk

İddia	Madde	reference_id
Belgeyi bir denetleyici değerlendirir; yazılım kendini sertifikalandırmaz	PDF/A-4 §6.2.3
Etiketli ve doğal dil içeren yapı → okuma sırasına göre makine tarafından çıkarılabilir	ISO 32000-2 §14.7
B-LT/B-LTA kalıcılık malzemesi farklıdır ve yalnızca Enterprise’a özgüdür	ETSI EN 319 142-2 §5.5

Yapay zekâya hazırlık denetimi desteği, sertifikalandırma değildir. Derecelendirilmiş sonuç, bir hazırlık değerlendirmesidir. Herhangi bir sertifikalandırma kararı bağımsız bir süreçle verilir.

Ticari bağlam

Yapay zekâya hazırlık aracı Enterprise katmanında yer alır ve yalnızca sunucuyla birlikte nextpdf/premium kurulduğunda kaydolur.

Connect ayrıntıları

Aktarım kullanılabilirliği (MCP / REST / gRPC)

Aynı çağrıyı, paylaşılan araç yürütücüsü aracılığıyla Model Context Protocol (MCP) tools/call üzerinden, Representational State Transfer (REST) araç uç noktasından ve gRPC hizmetinden yapın.

HITL risk katmanı

Belge oluşturma ve işleme dikkat düzeyindedir; hazırlık denetimi salt okunurdur. Varsayılan olarak hiçbiri approval_required değildir. Bkz. /connect/hitl-risk-tiers/.

Onay geçidi JSON zarfı

Bir operatör geçersiz kılma işlemi bunlardan birini approval_required düzeyine yükseltmediği sürece bu araçlar geçidi tetiklemez. Zarf ve tek kullanımlık belirteç sözleşmesi /connect/hitl-risk-tiers/ içindedir.

Ayrıca bakınız

/cookbook/connect/compliance-check/ — hedefli, adlandırılmış standart denetimi.
/cookbook/connect/forensic-analysis/ — bütünlük boyutu ayrıntılı olarak.
/cookbook/connect/ltv-health-check/ — kalıcılık boyutu ayrıntılı olarak.
/connect/tool-catalog/ — katman başına araç kümesi hesaplaması.