透過 Connect 進行批次標準檢查

概覽

本食譜會在單一呼叫中，針對一或多項具名政策檢查多份 PDF。它透過 Connect 傳輸呼叫批次合規工具。此工具屬於 Enterprise 級：探索時會使用 class_exists() 探測，且僅在 nextpdf/premium 與伺服器一同安裝時才註冊。每份文件都會依請求中的每一項政策進行檢查；回應則是彙整後的報告，按文件與政策逐項列出結果。

如同單份文件檢查，逐項政策的「通過」代表工具針對其已實作規則完成自我檢查——它並非獨立的符合性認證。符合性判定由驗證器做出。

安裝

composer require nextpdf/server

以一次 tools/list 呼叫確認 Enterprise 批次工具存在。請參閱 /connect/tool-catalog/。

概念總覽

標準會針對每份文件陳述需求，檢查器則依這些需求評估每份文件（PDF/A-4 §6.2.3）。符合性是依需求判定，而不是由產生者宣稱（PDF/A-4 §6.7.3）。對於簽章相關政策，PAdES 基準層級彼此不同，而 B-LT/B-LTA 層級（驗證材料、封存時間戳記）則是僅限 Enterprise 的能力（ETSI EN 319 142-2 §5.5）。批次結果會在整個文件集上彙整同樣狹義的語意：「沒有任何已實作規則失敗」。

API 介面

使用 tools/list 對照執行中登錄的工具名稱。權威目錄為 /connect/tool-catalog/。本食譜不重述工具數量。

程式碼範例 — 快速上手

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "batch_compliance_check",
    "arguments": {
      "sources": ["/data/q1.pdf", "/data/q2.pdf"],
      "policies": ["pdfa-4"]
    }
  }
}

程式碼範例 — 生產環境

curl -sS -X POST https://connect.example.com/v1/tools/batch_compliance_check \
  -H 'Authorization: Bearer '"$NEXTPDF_CONNECT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"sources":["/data/q1.pdf","/data/q2.pdf"],"policies":["pdfa-4"]}' \
  -o /tmp/batch.json -w '%{http_code}' > /tmp/batch-status || {
    echo "transport failure invoking batch_compliance_check" >&2; exit 1; }

回應會包含一個批次 id、彙整後的 pass/fail 計數，以及逐份文件的 checks 陣列，內含逐項政策的結果與失敗原因。請篩選失敗項目、修正後，僅重新提交受影響的文件。

邊緣情況與陷阱

空的 sources 或 policies 屬於無效參數錯誤。
遺失的檔案會以逐筆結果中的錯誤呈現，而不會讓整個批次失敗。請檢查每一筆結果是否有 error 欄位。
超出批次大小上限會產生明確錯誤。請拆分為較小的批次。
未知的政策 id 是未知標準錯誤，會列出可辨識的識別碼。引用 B-LT/B-LTA 的簽章政策，只有在可產生該材料的 Enterprise 部署上才有意義。
**工具不存在。**若未安裝 nextpdf/premium，Enterprise 批次工具便不會註冊；該呼叫會因未知工具錯誤而失敗。

效能

front-matter 中的預算是文件層級上限。此工具會在伺服器端處理文件，每份文件的工作記憶體需求不低。請依主機記憶體決定批次大小，而不要調高全域逾時。

安全注意事項

請勿在會對外輸出的記錄層級記錄來源路徑或完整報告。僅記錄批次 id 與彙整後的 pass/fail 計數。逐項政策的「通過」描述的是已實作的規則集，並非安全或法律上的保證。

符合性

主張	條款	reference_id
標準陳述需求；檢查器則評估每份文件	PDF/A-4 §6.2.3
符合性是針對需求加以判定，而非由產生者宣稱	PDF/A-4 §6.7.3
B-LT/B-LTA 會加入驗證材料；它們是彼此獨立、僅限 Enterprise 的層級	ETSI EN 319 142-2 §5.5

支援批次標準檢查不等於提供符合性認證。符合性判定由獨立驗證器逐份文件做出。

商業情境

批次合規工具屬於 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/ai-ready-certification/ — 範圍更廣的 AI 就緒度檢查。
/connect/tool-catalog/ — 依層級計算工具集。
/connect/hitl-risk-tiers/ — 風險模型與確認關卡。