Connect クックブック
Connect クックブック
「Connect クックブック」という見出しのセクションNextPDF Connect は、Model Context Protocol、REST API、および gRPC サービスを通じて、NextPDF エンジンをリモートの呼び出し元や AI システムから利用できるようにします。Connect クックブックはそのサーフェス向けのタスクレシピを集めたもので、このページはそのインデックスです。各レシピのスラッグと、すべてのレシピを読む際のティアおよびトランスポート境界を記録します。これはインデックスであるため、いずれのレシピについても動作に関する主張は行いません。各レシピページは nextpdf/server リポジトリの docs/public/ 配下で執筆され、自身の主張を保持し、ソースの出所を保ったままアグリゲーターによってこのサイトに取り込まれます。
すべての Connect レシピが従う契約を確認するには、レシピの規約をお読みください。エコシステム全体における統合の全体像については、統合クックブックをお読みください。
ティアが実行可能な内容に与える影響
「ティアが実行可能な内容に与える影響」という見出しのセクションConnect デプロイメントのツールセットは、あらかじめ固定されているのではなく、起動時に算出されます。サーバーのツールレジストリは、コアツールを無条件に登録します。次に class_exists() で Pro および Enterprise のプロバイダーを探索し、nextpdf/premium がサーバーと併せてインストールされている場合にのみ、それらのツールを登録します。したがって、Pro または Enterprise のツールに依存するレシピは、そのツールが解決済みのデプロイメントでのみ実行されます。オープンソースのみのインストールにはそのツールが存在せず、呼び出しは静かに劣化するのではなく、未知ツールエラーを返します。各レシピは自身のティアを明記しており、このインデックスではレシピをティアごとにグループ化しているため、特定のデプロイメントが何をサポートするかを一目で把握できます。
ツールの総数は、デプロイメントのランタイム特性です。いずれのレシピも、このインデックスのどの行も、固定の数を主張しません。正本となるカタログはサーバー自身のツールカタログであり、各レシピはそこへリンクします。
トランスポートとエラーモデル
「トランスポートとエラーモデル」という見出しのセクションすべてのレシピは、3 つのトランスポートのいずれでも同じ方法で呼び出せます。MCP の tools/call、REST ツールエンドポイント、または gRPC サービスのいずれであっても、それらは 1 つのツールエグゼキューターを共有するためです。HTTP 経由でリモートサービスに到達するレシピは、トランスポートの失敗と成功でない HTTP ステータスを 2 つの別個のケースとして扱います。PSR-18 クライアントは、リクエストをまったく送信できない場合にのみ、型付きクライアント例外を発生させます — PSR-18 §4。対照的に、4xx または 5xx レスポンスは、例外ではなく、呼び出し元が検査する通常の戻り値です — PSR-18 §4。
レシピのスラッグマップ
「レシピのスラッグマップ」という見出しのセクション各レシピは /cookbook/connect/<recipe>/ に存在します。この表は、スラッグ、レシピを読む際のティア、および 1 行のスコープを記録します。レシピページは nextpdf/serverdocs/public/ で執筆され、ここに集約されます。ページが掲載されるまで、そのリンクは前方参照です。
| レシピ | ティア | スコープ |
|---|---|---|
hello-world（上流で計画中） | Core | 初めての Connect 呼び出し：作成、コンテンツ追加、出力 |
multi-page（上流で計画中） | Core | Connect 経由のマルチページドキュメント |
image-embedding（上流で計画中） | Core | Connect 経由の画像埋め込み |
html-table（上流で計画中） | Core | Connect 経由の HTML テーブルのレンダリング |
font-typography（上流で計画中） | Core | Connect 経由のフォントとタイポグラフィ |
exception-aware（上流で計画中） | Core | 例外対応のツール呼び出し |
environment-diagnostics（上流で計画中） | Core | 環境診断ツール |
layout-inspection（上流で計画中） | Core | レンダリングせずにレイアウトを検査 |
worker-safe（上流で計画中） | Core | ワーカーセーフなバッチ利用 |
output-approval（上流で計画中） | Core | ヒューマン・イン・ザ・ループの出力ゲート |
event-hooks（上流で計画中） | Core | ライフサイクルイベントフック |
fill-pdf-form（上流で計画中） | Pro | Connect 経由で PDF フォームに入力 |
extract-text-content（上流で計画中） | Pro | Connect 経由でテキストコンテンツを抽出 |
digital-signature（上流で計画中） | Pro | Connect 経由で PDF に署名（PAdES B-B および B-T） |
accessibility-check（上流で計画中） | Pro | PDF/UA アクセシビリティチェック |
pii-redaction（上流で計画中） | Enterprise | 検出された個人データをテキストレイヤーから削除（破壊的） |
aria-tagged-pdf（上流で計画中） | Pro | ARIA ランドマークロールをタグ付き構造にマッピング |
figure-caption（上流で計画中） | Pro | ネストされた Caption を持つアクセシブルな Figure |
aria-noteref-pattern（上流で計画中） | Pro | 脚注の参照と本文のパターン |
compliance-check（上流で計画中） | Enterprise | 名前付き標準のチェックを実行 |
forensic-analysis（上流で計画中） | Enterprise | 署名済み PDF のフォレンジック分析 |
ltv-health-check（上流で計画中） | Enterprise | LTV ヘルスチェック（B-LT/B-LTA、Enterprise 専用） |
batch-compliance（上流で計画中） | Enterprise | バッチ標準チェック |
ai-ready-certification（上流で計画中） | Enterprise | AI 対応チェック（認証ではありません） |
page-artifacts（上流で計画中） | Enterprise | ページネーションのクロムをアーティファクトとしてマーク |
conformance-mode（上流で計画中） | Enterprise | 適合モードの選択（適合を意図しており、判定はバリデーターが行う） |
cjk-vertical-writing（上流で計画中） | Enterprise | CJK 縦書きメトリクス |
opentelemetry（上流で計画中） | Core | OpenTelemetry で Connect を観測 |
tagged-pdf-tutorial（上流で計画中） | Core | タグ付き PDF のチュートリアル（適合を意図しており、判定は veraPDF が行う） |
スラッグは、レシピの意図を末尾にスラッシュを 1 つだけ付けたケバブケースで表したものです。数値プレフィックス、バージョン番号、ファイル拡張子はありません。レシピのスラッグは公開後に変更されることはなく、移動されたスラッグはリダイレクトを伴います。
適合と認証の境界
「適合と認証の境界」という見出しのセクションいくつかのレシピは標準（PDF/UA-2、PDF/A-4、PAdES）に触れます。Connect クックブックでは、標準へのサポートはあくまでサポートとして扱い、決して適合や認証としては扱いません。エンジンは適合を意図した出力を生成し、適合は独立したバリデーター（例として veraPDF）が判定します。AI 対応レシピは対応チェックであり、認証ではありません。LTV レシピの長期検証用マテリアルは、Enterprise 専用の機能です。それがドキュメント内に存在することは、そのドキュメントが備える機能であり、署名の有効性が無期限であることを保証するものではありません。影響を受ける各レシピは、これらの境界を全面的に再記述します。このインデックスは、それらが存在することを示し、どこから導出されるかを指し示すだけであり、ここで再導出することはありません。