Ricettario Connect
Ricettario Connect
Sezione intitolata “Ricettario 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 in nextpdf/serverdocs/public/ e vengono aggregate qui. Finché una pagina non compare, il suo collegamento è un riferimento in avanti.
| Ricetta | Livello | Ambito |
|---|---|---|
hello-world (pianificata upstream) | Core | Prima chiamata a Connect: creare, aggiungere contenuto, produrre l’output |
multi-page (pianificata upstream) | Core | Documento multipagina tramite Connect |
image-embedding (pianificata upstream) | Core | Incorporare un’immagine tramite Connect |
html-table (pianificata upstream) | Core | Eseguire il rendering di una tabella HTML tramite Connect |
font-typography (pianificata upstream) | Core | Font e tipografia tramite Connect |
exception-aware (pianificata upstream) | Core | Chiamate agli strumenti consapevoli delle eccezioni |
environment-diagnostics (pianificata upstream) | Core | Strumenti di diagnostica dell’ambiente |
layout-inspection (pianificata upstream) | Core | Ispezionare il layout senza rendering |
worker-safe (pianificata upstream) | Core | Uso batch sicuro per i worker |
output-approval (pianificata upstream) | Core | Gate di output con intervento umano |
event-hooks (pianificata upstream) | Core | Hook degli eventi del ciclo di vita |
fill-pdf-form (pianificata upstream) | Pro | Compilare un modulo PDF tramite Connect |
extract-text-content (pianificata upstream) | Pro | Estrarre il contenuto testuale tramite Connect |
digital-signature (pianificata upstream) | Pro | Firmare un PDF (PAdES B-B e B-T) tramite Connect |
accessibility-check (pianificata upstream) | Pro | Controllo di accessibilità PDF/UA |
pii-redaction (pianificata upstream) | Enterprise | Rimuovere i dati personali rilevati dal livello di testo (distruttiva) |
aria-tagged-pdf (pianificata upstream) | Pro | Mappare i ruoli landmark ARIA sulla struttura con tag |
figure-caption (pianificata upstream) | Pro | Figura accessibile con Caption annidata |
aria-noteref-pattern (pianificata upstream) | Pro | Pattern di riferimento alla nota e corpo della nota |
compliance-check (pianificata upstream) | Enterprise | Eseguire un controllo su uno standard nominato |
forensic-analysis (pianificata upstream) | Enterprise | Analisi forense di un PDF firmato |
ltv-health-check (pianificata upstream) | Enterprise | Controllo di integrità LTV (B-LT/B-LTA, solo Enterprise) |
batch-compliance (pianificata upstream) | Enterprise | Controllo batch sugli standard |
ai-ready-certification (pianificata upstream) | Enterprise | Controllo di prontezza per l’IA (non una certificazione) |
page-artifacts (pianificata upstream) | Enterprise | Contrassegnare gli elementi di impaginazione come artefatti |
conformance-mode (pianificata upstream) | Enterprise | Selezionare una modalità di conformità (destinata a essere conforme; decide un validatore) |
cjk-vertical-writing (pianificata upstream) | Enterprise | Metriche di scrittura verticale CJK |
opentelemetry (pianificata upstream) | Core | Osservare Connect con OpenTelemetry |
tagged-pdf-tutorial (pianificata upstream) | 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.