Receptariusz Connect
Receptariusz Connect
Dział zatytułowany „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 nextpdf/serverdocs/public/ i agregowane tutaj. Dopóki strona się nie pojawi, jej odnośnik jest odniesieniem wyprzedzającym.
| Przepis | Warstwa | Zakres |
|---|---|---|
hello-world (planowane w repozytoriach źródłowych) | Core | Pierwsze wywołanie Connect: utwórz, dodaj treść, wygeneruj wynik |
multi-page (planowane w repozytoriach źródłowych) | Core | Dokument wielostronicowy w Connect |
image-embedding (planowane w repozytoriach źródłowych) | Core | Osadź obraz przez Connect |
html-table (planowane w repozytoriach źródłowych) | Core | Wyrenderuj tabelę HTML przez Connect |
font-typography (planowane w repozytoriach źródłowych) | Core | Czcionki i typografia w Connect |
exception-aware (planowane w repozytoriach źródłowych) | Core | Wywołania narzędzi uwzględniające wyjątki |
environment-diagnostics (planowane w repozytoriach źródłowych) | Core | Narzędzia diagnostyki środowiska |
layout-inspection (planowane w repozytoriach źródłowych) | Core | Sprawdź układ bez renderowania |
worker-safe (planowane w repozytoriach źródłowych) | Core | Bezpieczne dla wątków roboczych użycie wsadowe |
output-approval (planowane w repozytoriach źródłowych) | Core | Bramka wyjścia z udziałem człowieka |
event-hooks (planowane w repozytoriach źródłowych) | Core | Punkty zaczepienia zdarzeń cyklu życia |
fill-pdf-form (planowane w repozytoriach źródłowych) | Pro | Wypełnij formularz PDF przez Connect |
extract-text-content (planowane w repozytoriach źródłowych) | Pro | Wyodrębnij treść tekstową w Connect |
digital-signature (planowane w repozytoriach źródłowych) | Pro | Podpisz dokument PDF (PAdES B-B i B-T) przez Connect |
accessibility-check (planowane w repozytoriach źródłowych) | Pro | Kontrola dostępności PDF/UA |
pii-redaction (planowane w repozytoriach źródłowych) | Enterprise | Usuń wykryte dane osobowe z warstwy tekstowej (operacja niszcząca) |
aria-tagged-pdf (planowane w repozytoriach źródłowych) | Pro | Odwzoruj role punktów orientacyjnych ARIA na strukturę tagowaną |
figure-caption (planowane w repozytoriach źródłowych) | Pro | Dostępny element Figure z zagnieżdżonym Caption |
aria-noteref-pattern (planowane w repozytoriach źródłowych) | Pro | Wzorzec odsyłacza do przypisu i jego treści |
compliance-check (planowane w repozytoriach źródłowych) | Enterprise | Uruchom kontrolę względem nazwanego standardu |
forensic-analysis (planowane w repozytoriach źródłowych) | Enterprise | Analiza kryminalistyczna podpisanego dokumentu PDF |
ltv-health-check (planowane w repozytoriach źródłowych) | Enterprise | Kontrola kondycji LTV (B-LT/B-LTA, tylko Enterprise) |
batch-compliance (planowane w repozytoriach źródłowych) | Enterprise | Wsadowa kontrola standardów |
ai-ready-certification (planowane w repozytoriach źródłowych) | Enterprise | Kontrola gotowości do pracy z AI (to nie jest certyfikacja) |
page-artifacts (planowane w repozytoriach źródłowych) | Enterprise | Oznacz elementy paginacji jako artefakty |
conformance-mode (planowane w repozytoriach źródłowych) | Enterprise | Wybierz tryb zgodności (z zamiarem zachowania zgodności; rozstrzyga walidator) |
cjk-vertical-writing (planowane w repozytoriach źródłowych) | Enterprise | Metryki pionowego pisma CJK |
opentelemetry (planowane w repozytoriach źródłowych) | Core | Obserwuj Connect za pomocą OpenTelemetry |
tagged-pdf-tutorial (planowane w repozytoriach źródłowych) | 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ą.