Connect-Cookbook
NextPDF Connect öffnet die NextPDF-Engine für entfernte Aufrufer und KI-Systeme über das Model Context Protocol, eine REST-API und einen gRPC-Service. Das Connect-Cookbook sammelt die Task-Recipes für diese Oberfläche; diese Seite dient als Index. Sie hält den Slug fest, den jedes Recipe belegt, sowie die Stufe und die Transportgrenze, in deren Kontext jedes Recipe gelesen wird. Da es sich um einen Index handelt, trifft er keine Verhaltensaussagen zu einzelnen Recipes. Jede Recipe-Seite wird im Repository nextpdf/server unter docs/public/ verfasst, enthält ihre eigenen Aussagen und wird vom Aggregator mit intakter Quellenherkunft in diese Site übernommen.
Den Vertrag, dem jedes Connect-Recipe folgt, finden Sie unter Recipe-Konventionen. Die ökosystemweite Integrationslandschaft beschreibt das Integrations-Cookbook.
Wie die Stufe beeinflusst, was Sie ausführen können
Abschnitt betitelt „Wie die Stufe beeinflusst, was Sie ausführen können“Der Toolsatz eines Connect-Deployments wird beim Booten berechnet und nicht im Voraus festgelegt. Die Tool-Registry des Servers registriert die Core-Tools bedingungslos. Anschließend prüft sie mit class_exists() auf die Pro- und Enterprise-Provider und registriert deren Tools nur dann, wenn nextpdf/premium neben dem Server installiert ist. Ein Recipe, das von einem Pro- oder Enterprise-Tool abhängt, läuft also nur auf einem Deployment, auf dem dieses Tool aufgelöst wurde. Auf einer reinen Open-Source-Installation ist das Tool nicht vorhanden, und der Aufruf gibt einen Unknown-Tool-Fehler zurück, statt stillschweigend auf einen geringeren Funktionsumfang zurückzufallen. Jedes Recipe nennt seine Stufe; dieser Index gruppiert die Recipes nach Stufe, damit Sie auf einen Blick erkennen, was ein bestimmtes Deployment unterstützt.
Die Gesamtzahl der Tools ist eine Laufzeiteigenschaft des Deployments. Weder ein Recipe noch eine Zeile in diesem Index behauptet eine feste Zahl. Maßgeblich ist der eigene Tool-Katalog des Servers, auf den jedes Recipe verlinkt.
Transport- und Fehlermodell
Abschnitt betitelt „Transport- und Fehlermodell“Sie rufen jedes Recipe über alle drei Transporte auf dieselbe Weise auf: über einen MCP-tools/call, den REST-Tool-Endpunkt oder den gRPC-Service. Der Grund ist, dass alle drei denselben Tool-Executor verwenden. Recipes, die einen entfernten Service über HTTP erreichen, behandeln einen Transportfehler und einen nicht erfolgreichen HTTP-Status als zwei getrennte Fälle. Ein PSR-18-Client wirft nur dann eine typisierte Client-Exception, wenn er die Anfrage überhaupt nicht senden kann, siehe PSR-18 §4. Eine 4xx- oder 5xx-Antwort ist dagegen ein normaler Rückgabewert, den der Aufrufer prüft, keine Exception; siehe PSR-18 §4.
Die Recipe-Slug-Karte
Abschnitt betitelt „Die Recipe-Slug-Karte“Jedes Recipe liegt unter /cookbook/connect/<recipe>/. Die Tabelle dokumentiert den Slug, die Stufe, unter der das Recipe gelesen wird, und einen einzeiligen Geltungsbereich. Die Recipe-Seiten werden im docs/public/-Verzeichnisbaum des Repositorys nextpdf/server verfasst und über den Aggregator auf dieser Site veröffentlicht.
| Recipe | Stufe | Geltungsbereich |
|---|---|---|
hello-world | Core | Erster Connect-Aufruf: erstellen, Inhalt hinzufügen, ausgeben |
multi-page | Core | Mehrseitiges Dokument über Connect |
image-embedding | Core | Ein Bild über Connect einbetten |
html-table | Core | Eine HTML-Tabelle über Connect rendern |
font-typography | Core | Schriften und Typografie über Connect |
exception-aware | Core | Exception-bewusste Tool-Aufrufe |
environment-diagnostics | Core | Tools zur Umgebungsdiagnose |
layout-inspection | Core | Layout ohne Rendering inspizieren |
worker-safe | Core | Worker-sichere Batch-Nutzung |
batch-pdf-generation-with-progress-tracking | Core | PDFs im Batch mit asynchroner Fortschrittsverfolgung erzeugen |
rest-invoice-end-to-end | Core | Eine Rechnung über REST: einreichen, abfragen, herunterladen, lokal verifizieren |
output-approval | Core | Das Output-Gate mit Mensch in der Schleife |
mcp-agent-session | Core | Eine aufgezeichnete MCP-Agent-Sitzung mit dem Freigabe-Roundtrip |
event-hooks | Core | Lifecycle-Event-Hooks |
fill-pdf-form | Pro | Ein PDF-Formular über Connect ausfüllen |
extract-text-content | Pro | Textinhalt über Connect extrahieren |
digital-signature | Pro | Ein PDF über Connect signieren (PAdES B-B und B-T) |
accessibility-check | Pro | PDF/UA-Barrierefreiheitsprüfung |
pii-redaction | Enterprise | Erkannte personenbezogene Daten aus der Textebene entfernen (destruktiv) |
aria-tagged-pdf | Pro | ARIA-Landmark-Rollen auf getaggte Struktur abbilden |
figure-caption | Pro | Barrierefreie Figure mit verschachtelter Caption |
aria-noteref-pattern | Pro | Fußnotenreferenz- und Textkörper-Muster |
compliance-check | Enterprise | Eine Prüfung nach benanntem Standard ausführen |
forensic-analysis | Enterprise | Forensische Analyse eines signierten PDFs |
ltv-health-check | Enterprise | LTV-Zustandsprüfung (B-LT/B-LTA, nur Enterprise) |
batch-compliance | Enterprise | Batch-Standardprüfung |
ai-ready-certification | Enterprise | KI-Bereitschaftsprüfung (keine Zertifizierung) |
page-artifacts | Enterprise | Paginierungs-Chrome als Artefakte markieren |
conformance-mode | Enterprise | Einen Konformitätsmodus auswählen (soll konform sein; ein Validator entscheidet) |
cjk-vertical-writing | Enterprise | Metriken für vertikale CJK-Schreibrichtung |
opentelemetry | Core | Connect mit OpenTelemetry beobachten |
tagged-pdf-tutorial | Core | Tutorial für getaggtes PDF (soll konform sein; veraPDF entscheidet) |
Der Slug bildet die Absicht des Recipes in Kebab-Case mit einem einzigen abschließenden Schrägstrich ab: kein numerisches Präfix, keine Versionsnummer, keine Dateiendung. Ein Recipe-Slug ändert sich nach der Veröffentlichung nicht, und ein verschobener Slug erhält einen Redirect.
Konformitäts- und Zertifizierungsgrenze
Abschnitt betitelt „Konformitäts- und Zertifizierungsgrenze“Mehrere Recipes berühren Standards (PDF/UA-2, PDF/A-4, PAdES). Das Connect-Cookbook versteht die Unterstützung eines Standards als Unterstützung, niemals als Konformität oder Zertifizierung. Die Engine erzeugt Ausgaben, die konform sein sollen, und ein unabhängiger Validator (zum Beispiel veraPDF) bestimmt die Konformität. Das KI-Bereitschafts-Recipe ist eine Bereitschaftsprüfung, keine Zertifizierung. Das Long-Term-Validation-Material des LTV-Recipes ist eine reine Enterprise-Fähigkeit. Wenn es in einem Dokument vorhanden ist, trägt das Dokument diese Fähigkeit; es ist keine Garantie für unbegrenzte Signaturgültigkeit. Jedes betroffene Recipe wiederholt diese Grenzen vollständig. Dieser Index merkt nur an, dass sie existieren, und verweist darauf, woraus sie hergeleitet werden, statt sie hier erneut herzuleiten.
Siehe auch
Abschnitt betitelt „Siehe auch“- Recipe-Konventionen — der Vertrag, dem jedes Connect-Recipe folgt.
- Integrations-Cookbook — die ökosystemweite Paket- und Integrationsreferenz, deren Netzwerkdienst Connect ist.