Cookbook Connect
NextPDF Connect espone il motore NextPDF ai chiamanti remoti e ai sistemi di IA tramite il Model Context Protocol, un’API REST e un servizio gRPC. Il ricettario Connect raccoglie le ricette operative per questa superficie, e questa pagina ne è l’indice. Riporta lo slug riservato a ogni ricetta, insieme al livello e al confine di trasporto in base ai quali leggere ciascuna ricetta. Poiché è un indice, non formula affermazioni comportamentali sulle singole ricette. Ogni pagina di ricetta è redatta nel repository nextpdf/server sotto docs/public/, contiene le proprie affermazioni e viene incorporata in questo sito dall’aggregatore mantenendo intatta la provenienza sorgente.
Per consultare il contratto seguito da ogni ricetta Connect, leggere Convenzioni delle ricette. Per il quadro delle integrazioni a livello di ecosistema, leggere il Ricettario delle integrazioni.
Come il livello influisce su ciò che si può eseguire
Sezione intitolata “Come il livello influisce su ciò che si può eseguire”Il set di strumenti di un deployment Connect viene calcolato all’avvio, non fissato in anticipo. Il registro degli strumenti del server registra gli strumenti core in modo incondizionato. Verifica poi i provider Pro ed Enterprise con class_exists() e registra i loro strumenti solo quando nextpdf/premium è installato insieme al server. Di conseguenza, una ricetta che dipende da uno strumento Pro o Enterprise viene eseguita solo su un deployment in cui quello strumento è stato risolto. Su un’installazione solo open source lo strumento è assente, e la chiamata restituisce un errore di strumento sconosciuto invece di degradare silenziosamente. Ogni ricetta dichiara il proprio livello, e questo indice raggruppa le ricette per livello per consentire di capire a colpo d’occhio cosa supporta un determinato deployment.
Il conteggio totale degli strumenti è una proprietà di runtime del deployment. Nessuna ricetta e nessuna riga di questo indice dichiara un numero fisso. Il catalogo di riferimento è il catalogo degli strumenti del server, a cui ogni ricetta rimanda.
Trasporto e modello di errore
Sezione intitolata “Trasporto e modello di errore”Ogni ricetta viene invocata allo stesso modo su tutti e tre i trasporti — una chiamata tools/call MCP, l’endpoint dello strumento REST o il servizio gRPC — perché condividono un unico esecutore di strumenti. Le ricette che raggiungono un servizio remoto tramite HTTP trattano un errore di trasporto e uno stato HTTP non di successo come due casi distinti. Un client PSR-18 solleva un’eccezione tipizzata del client solo quando non riesce affatto a inviare la richiesta — PSR-18 §4. Una risposta 4xx o 5xx, al contrario, è un valore di ritorno normale che il chiamante ispeziona, non un’eccezione — PSR-18 §4.
La mappa degli slug delle ricette
Sezione intitolata “La mappa degli slug delle ricette”Ogni ricetta risiede in /cookbook/connect/<recipe>/. La tabella registra lo slug, il livello in base al quale la ricetta viene letta e un ambito di una sola riga. Le pagine delle ricette sono redatte nell’albero docs/public/ del repository nextpdf/server e vengono pubblicate in questo sito tramite l’aggregatore.
| Ricetta | Livello | Ambito |
|---|---|---|
hello-world | Core | Prima chiamata a Connect: creare, aggiungere contenuto, produrre l’output |
multi-page | Core | Documento multipagina tramite Connect |
image-embedding | Core | Incorporare un’immagine tramite Connect |
html-table | Core | Eseguire il rendering di una tabella HTML tramite Connect |
font-typography | Core | Font e tipografia tramite Connect |
exception-aware | Core | Chiamate agli strumenti consapevoli delle eccezioni |
environment-diagnostics | Core | Strumenti di diagnostica dell’ambiente |
layout-inspection | Core | Ispezionare il layout senza rendering |
worker-safe | Core | Uso batch sicuro per i worker |
batch-pdf-generation-with-progress-tracking | Core | Generare PDF in batch con tracciamento asincrono dell’avanzamento |
rest-invoice-end-to-end | Core | Una fattura tramite REST: inviare, interrogare, scaricare, verificare in locale |
output-approval | Core | Gate di output con intervento umano |
mcp-agent-session | Core | Una sessione di agente MCP catturata con il ciclo di approvazione |
event-hooks | Core | Hook degli eventi del ciclo di vita |
fill-pdf-form | Pro | Compilare un modulo PDF tramite Connect |
extract-text-content | Pro | Estrarre il contenuto testuale tramite Connect |
digital-signature | Pro | Firmare un PDF (PAdES B-B e B-T) tramite Connect |
accessibility-check | Pro | Controllo di accessibilità PDF/UA |
pii-redaction | Enterprise | Rimuovere i dati personali rilevati dal livello di testo (distruttiva) |
aria-tagged-pdf | Pro | Mappare i ruoli landmark ARIA sulla struttura con tag |
figure-caption | Pro | Figura accessibile con Caption annidata |
aria-noteref-pattern | Pro | Pattern di riferimento alla nota e corpo della nota |
compliance-check | Enterprise | Eseguire un controllo su uno standard nominato |
forensic-analysis | Enterprise | Analisi forense di un PDF firmato |
ltv-health-check | Enterprise | Controllo di integrità LTV (B-LT/B-LTA, solo Enterprise) |
batch-compliance | Enterprise | Controllo batch sugli standard |
ai-ready-certification | Enterprise | Controllo di prontezza per l’IA (non una certificazione) |
page-artifacts | Enterprise | Contrassegnare gli elementi di impaginazione come artefatti |
conformance-mode | Enterprise | Selezionare una modalità di conformità (destinata a essere conforme; decide un validatore) |
cjk-vertical-writing | Enterprise | Metriche di scrittura verticale CJK |
opentelemetry | Core | Osservare Connect con OpenTelemetry |
tagged-pdf-tutorial | Core | Tutorial sul PDF con tag (destinato a essere conforme; decide veraPDF) |
Lo slug esprime l’intento della ricetta in kebab-case con una singola barra finale: nessun prefisso numerico, nessun numero di versione, nessuna estensione di file. Uno slug di ricetta non cambia dopo la pubblicazione; se viene spostato, porta con sé un reindirizzamento.
Confine tra conformità e certificazione
Sezione intitolata “Confine tra conformità e certificazione”Diverse ricette toccano standard (PDF/UA-2, PDF/A-4, PAdES). Il ricettario Connect interpreta il supporto di uno standard come supporto, mai come conformità o certificazione. Il motore produce output destinato a conformarsi, e un validatore indipendente (per esempio veraPDF) determina la conformità. La ricetta di prontezza per l’IA è un controllo di prontezza, non una certificazione. Il materiale di validazione a lungo termine della ricetta LTV è una capacità solo Enterprise. La sua presenza in un documento è una capacità che il documento porta con sé, non una garanzia di validità indefinita della firma. Ogni ricetta interessata esplicita nuovamente per intero questi confini. Questo indice si limita a notare che esistono e indica da dove derivano, anziché riderivarli qui.
Vedere anche
Sezione intitolata “Vedere anche”- Convenzioni delle ricette — il contratto seguito da ogni ricetta Connect.
- Ricettario delle integrazioni — il riferimento per pacchetti e integrazioni a livello di ecosistema, di cui Connect è il servizio di rete.