Connect 経由で行う AI 対応度チェック

命名に関する注記。 このワークフローは AI 対応度チェック であり、認証ではありません。このツールは 4 つの観点についてグレード付きスコアを生成します。このチェックは、ドキュメントがいかなる目的においても「認証済み」であることを証明するものではありません。スラグは継続性のために従来の ai-ready-certification セグメントを維持していますが、このワークフローは対応度評価であり、独立したプロセスによって裏付けられる場合も、上書きされる場合もあります。

概要

このレシピでは、AI 対応度ツールを Connect トランスポート経由で使用し、完全性（フォレンジック）・長期保存性（長期検証の健全性）・構造（タグ付き/アクセシブルなコンテンツ）・機械可読性（テキスト抽出）という 4 つの観点からドキュメントを採点します。このツールは Enterprise ティア です。class_exists() プローブがこのツールを検出し、サーバーと併せて nextpdf/premium がインストールされている場合にのみ登録されます。ドキュメントの作成とレンダリングにはコアツールを使用します。

グレード付きの結果（レターグレードと観点別スコア）は、ツール自身による対応度評価です。これは認証では ありません。「グレード 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 対応度ツールは登録されず、呼び出しは unknown-tool エラーで失敗します。

パフォーマンス

フロントマターの予算は、ドキュメント上の上限値です。大きなドキュメントはツールの解析タイムアウトに達することがあります。グローバルなタイムアウトを引き上げるのではなく、分割してください。

セキュリティに関する注記

完全性の観点ではフォレンジック解析を再利用するため、その「クリーン」というサブ判定にも同じ注意事項が当てはまります。これは実施した解析の範囲内で改変が検出されなかったという意味であり、改ざん耐性の保証ではありません。ドキュメントのパスやレポート全文を、外部に送出されるログレベルでログ出力しないでください。

適合性

主張	条項	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/. にあります。

Connect 経由で行う AI 対応度チェック

Connect 経由で行う AI 対応度チェック

概要

インストール

概念の概要

API サーフェス

コードサンプル — クイックスタート

コードサンプル — 本番

エッジケースと注意点

パフォーマンス

セキュリティに関する注記

適合性

商用コンテキスト

Connect 固有の事項

トランスポートの利用可否（MCP / REST / gRPC）

HITL リスクティア

確認ゲートの JSON エンベロープ

関連項目