Connect 的 AI 就緒度檢查

命名說明。 此工作流程是一項 AI 就緒度檢查，並非認證。此工具會針對四個面向產出分級評分。這項檢查並不證明此文件已為任何用途「取得認證」。為求延續性，slug 保留了歷史沿用的 ai-ready-certification 片段，但此工作流程是一項就緒度評估，可由獨立流程加以佐證或推翻。

概覽

此範例會透過 Connect 傳輸層之上的 AI 就緒度工具，從四個面向為文件評分：完整性（鑑識）、長存性（長期驗證健康狀態）、結構（已標記/可存取的內容），以及機器可讀性（文字擷取）。此工具屬於 Enterprise 層級。class_exists() 探測可以發現它；但唯有在伺服器旁同時安裝 nextpdf/premium 時，它才會註冊。文件建立與算繪則使用核心工具。

分級結果（一個字母評等加上各面向分數）是此工具本身的就緒度評估。它並非認證。取得「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/。此範例不重述工具數量。

程式碼範例——快速上手

請使用核心工具建立並算繪文件，接著執行就緒度檢查：

{
  "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/ ——各層級工具集的計算方式。