Receptariusz Connect
NextPDF Connect udostępnia silnik NextPDF zdalnym klientom oraz systemom sztucznej inteligencji (AI) za pośrednictwem Model Context Protocol (MCP), REST API oraz usługi gRPC. Receptariusz Connect gromadzi przepisy zadaniowe dla tego obszaru, a ta strona jest jego indeksem. Odnotowuje slug każdego przepisu, warstwę, do której należy, oraz obowiązującą granicę transportu. Jako indeks ta strona nie składa żadnej deklaracji dotyczącej zachowania jakiegokolwiek przepisu. Każda strona przepisu jest tworzona w repozytorium nextpdf/server w katalogu docs/public/, zawiera własne deklaracje i jest pobierana do tej witryny przez agregator z zachowaniem informacji o pochodzeniu źródła.
Aby poznać kontrakt obowiązujący każdy przepis Connect, przeczytaj Konwencje przepisów. Aby poznać pełny obraz integracji w ekosystemie, przeczytaj Receptariusz integracji.
Jak warstwa wpływa na to, co możesz uruchomić
Dział zatytułowany „Jak warstwa wpływa na to, co możesz uruchomić”Wdrożenie Connect wyznacza swój zestaw narzędzi podczas uruchamiania; nie jest on ustalony z góry. Rejestr narzędzi serwera zawsze rejestruje narzędzia podstawowe. Następnie sprawdza dostawców Pro i Enterprise za pomocą class_exists() i rejestruje ich narzędzia tylko wtedy, gdy nextpdf/premium jest zainstalowany razem z serwerem. Przepis zależny od narzędzia Pro lub Enterprise działa tylko we wdrożeniu, w którym to narzędzie zostało rozpoznane. W instalacji obejmującej wyłącznie wersję open source narzędzie jest nieobecne, a wywołanie zwraca błąd nieznanego narzędzia, zamiast po cichu obniżać działanie. Każdy przepis wskazuje swoją warstwę, a ten indeks grupuje przepisy według warstw, żeby od razu było widać, co obsługuje dane wdrożenie.
Łączna liczba narzędzi jest właściwością wdrożenia ustalaną w czasie wykonywania. Żaden przepis ani żaden wiersz w tym indeksie nie określa stałej liczby. Punktem odniesienia jest własny katalog narzędzi serwera, do którego odsyła każdy przepis.
Model transportu i błędów
Dział zatytułowany „Model transportu i błędów”Każdy przepis wywołuje się w ten sam sposób za pośrednictwem wszystkich trzech transportów: wywołania MCP tools/call, punktu końcowego narzędzia REST lub usługi gRPC. Korzystają one ze wspólnego wykonawcy narzędzi. Przepisy, które łączą się z usługą zdalną za pośrednictwem Hypertext Transfer Protocol (HTTP), traktują awarię transportu i niepomyślny status HTTP jako odrębne przypadki. Klient PSR-18 zgłasza typowany wyjątek klienta tylko wtedy, gdy w ogóle nie może wysłać żądania, zgodnie z opisem w PSR-18 §4. Odpowiedź 4xx lub 5xx jest innym przypadkiem. To normalna wartość zwracana, którą sprawdza wywołujący, a nie wyjątek, zgodnie z opisem w PSR-18 §4.
Mapa slugów przepisów
Dział zatytułowany „Mapa slugów przepisów”Każdy przepis znajduje się pod adresem /cookbook/connect/<recipe>/. Tabela odnotowuje slug, warstwę, w której odczytywany jest przepis, oraz jednowierszowy zakres. Strony przepisów są tworzone w drzewie docs/public/ repozytorium nextpdf/server i publikowane w tej witrynie za pośrednictwem agregatora.
| Przepis | Warstwa | Zakres |
|---|---|---|
hello-world | Core | Pierwsze wywołanie Connect: utwórz, dodaj treść, wygeneruj wynik |
multi-page | Core | Dokument wielostronicowy w Connect |
image-embedding | Core | Osadź obraz przez Connect |
html-table | Core | Wyrenderuj tabelę HTML przez Connect |
font-typography | Core | Czcionki i typografia w Connect |
exception-aware | Core | Wywołania narzędzi uwzględniające wyjątki |
environment-diagnostics | Core | Narzędzia diagnostyki środowiska |
layout-inspection | Core | Sprawdź układ bez renderowania |
worker-safe | Core | Bezpieczne dla wątków roboczych użycie wsadowe |
batch-pdf-generation-with-progress-tracking | Core | Wsadowo generuj pliki PDF z asynchronicznym śledzeniem postępu |
rest-invoice-end-to-end | Core | Jedna faktura przez REST: wyślij, odpytaj, pobierz, zweryfikuj lokalnie |
output-approval | Core | Bramka wyjścia z udziałem człowieka |
mcp-agent-session | Core | Zarejestrowana sesja agenta MCP z obiegiem zatwierdzania |
event-hooks | Core | Punkty zaczepienia zdarzeń cyklu życia |
fill-pdf-form | Pro | Wypełnij formularz PDF przez Connect |
extract-text-content | Pro | Wyodrębnij treść tekstową w Connect |
digital-signature | Pro | Podpisz dokument PDF (PAdES B-B i B-T) przez Connect |
accessibility-check | Pro | Kontrola dostępności PDF/UA |
pii-redaction | Enterprise | Usuń wykryte dane osobowe z warstwy tekstowej (operacja niszcząca) |
aria-tagged-pdf | Pro | Odwzoruj role punktów orientacyjnych ARIA na strukturę tagowaną |
figure-caption | Pro | Dostępny element Figure z zagnieżdżonym Caption |
aria-noteref-pattern | Pro | Wzorzec odsyłacza do przypisu i jego treści |
compliance-check | Enterprise | Uruchom kontrolę względem nazwanego standardu |
forensic-analysis | Enterprise | Analiza kryminalistyczna podpisanego dokumentu PDF |
ltv-health-check | Enterprise | Kontrola kondycji LTV (B-LT/B-LTA, tylko Enterprise) |
batch-compliance | Enterprise | Wsadowa kontrola standardów |
ai-ready-certification | Enterprise | Kontrola gotowości do pracy z AI (to nie jest certyfikacja) |
page-artifacts | Enterprise | Oznacz elementy paginacji jako artefakty |
conformance-mode | Enterprise | Wybierz tryb zgodności (z zamiarem zachowania zgodności; rozstrzyga walidator) |
cjk-vertical-writing | Enterprise | Metryki pionowego pisma CJK |
opentelemetry | Core | Obserwuj Connect za pomocą OpenTelemetry |
tagged-pdf-tutorial | Core | Samouczek tagowanego PDF (z zamiarem zachowania zgodności; rozstrzyga veraPDF) |
Slug wyraża intencję przepisu w formacie kebab-case z pojedynczym ukośnikiem na końcu: bez przedrostka numerycznego, bez numeru wersji i bez rozszerzenia pliku. Slug przepisu nie zmienia się po publikacji, a przeniesiony slug zachowuje przekierowanie.
Granica zgodności i certyfikacji
Dział zatytułowany „Granica zgodności i certyfikacji”Kilka przepisów dotyczy standardów (PDF/UA-2, PDF/A-4, PAdES). Receptariusz Connect traktuje obsługę standardu jako obsługę, nigdy jako zgodność ani certyfikację. Silnik generuje wynik przeznaczony do zachowania zgodności, a o zgodności rozstrzyga niezależny walidator (na przykład veraPDF). Przepis dotyczący gotowości do pracy z AI to kontrola gotowości, a nie certyfikacja. Materiał walidacji długoterminowej w przepisie LTV jest funkcją dostępną wyłącznie w wersji Enterprise. Jego obecność w dokumencie to funkcja niesiona przez dokument, a nie gwarancja bezterminowej ważności podpisu. Każdy przepis, którego to dotyczy, w pełni powtarza te granice. Ten indeks jedynie odnotowuje ich istnienie i wskazuje, skąd wynikają, zamiast wyprowadzać je tutaj ponownie.
Zobacz także
Dział zatytułowany „Zobacz także”- Konwencje przepisów — kontrakt, którego przestrzega każdy przepis Connect.
- Receptariusz integracji — odniesienie do pakietów i integracji obejmujące cały ekosystem, w którym Connect jest usługą sieciową.