NextPDF Connect
NextPDF Connect
W skrócie
Dział zatytułowany „W skrócie”NextPDF Connect to pakiet nextpdf/server. Działa jako długotrwała usługa udostępniająca silnik PDF 2.0 NextPDF agentom sztucznej inteligencji (AI) oraz klientom korzystającym z protokołu Hypertext Transfer Protocol (HTTP). Ten sam rejestr narzędzi jest dostępny przez trzy transporty: Model Context Protocol (MCP) za pośrednictwem standardowego wejścia i wyjścia, interfejs programowania aplikacji (API) w stylu Representational State Transfer (REST), opisany w dokumencie OpenAPI 3.1, oraz gRPC zdefiniowany przez pakiet Protocol Buffers nextpdf.connect.v1. Każde narzędzie deklaruje poziom ryzyka. Narzędzia najwyższego poziomu muszą przejść przez bramkę potwierdzenia z udziałem człowieka (human-in-the-loop, HITL), zanim zostaną uruchomione.
Korzystaj z tej sekcji przy obsłudze lub integracji serwera. Zacznij od strony Przegląd, aby zrozumieć architekturę i wybrać transport, a następnie skorzystaj z dokumentacji API, aby poznać dokładne symbole narzędzi i usług.
Mapa sekcji
Dział zatytułowany „Mapa sekcji”Poniższe strony obejmują koncepcje, konfigurację i obsługę serwera.
| Strona | Zastosowanie |
|---|---|
| Przegląd | Granice pakietu, trzy transporty oraz wyjaśnienie, dlaczego liczba narzędzi jest właściwością ustalaną w czasie działania. |
| Szybki start | Pierwszy handshake MCP gotowy do uruchomienia oraz odpowiadające mu żądanie renderowania REST. |
| Konfiguracja | Plik YAML protokołu MCP, zmienne środowiskowe NEXTPDF_* oraz przesłonięcie ryzyka, które może tylko podwyższać poziom. |
| Uruchamianie i wykrywanie | Jak każdy transport łączy się ze swoim serwerem oraz wykrywa narzędzia i poziomy przy uruchamianiu. |
| Katalog narzędzi | Zweryfikowany, zawsze dostępny bazowy zestaw narzędzi oraz sposób, w jaki środowisko wykonawcze oblicza ich łączną liczbę. |
| Poziomy ryzyka HITL | Czteropoziomowy model ryzyka oraz wyzwanie potwierdzające dla narzędzi wymagających zatwierdzenia. |
| Wdrożenie | Profile procesów roboczych RoadRunner, Docker, magazyny oparte na Redis oraz wzajemne uwierzytelnianie Transport Layer Security (TLS) dla gRPC. |
| Bezpieczeństwo i operacje | Uwierzytelnianie, bezpieczeństwo transportu, model zagrożeń oraz podejście do lokalizacji danych. |
Każdy transport ma własną stronę referencyjną.
| Strona transportu | Zastosowanie |
|---|---|
| Transport MCP | Ramkowanie JavaScript Object Notation Remote Procedure Call (JSON-RPC) 2.0 na stdio oraz metody initialize / tools/list / tools/call. |
| Transport REST | Potok PSR-15 RoadRunner, kontrakt OpenAPI 3.1, uwierzytelnianie bearer oraz trasy chronione bramką poziomu ryzyka. |
| Transport gRPC | Usługa nextpdf.connect.v1.NextPDFConnect, wywołania RPC ze strumieniowaniem po stronie serwera oraz uwierzytelnianie za pomocą metadanych. |
Główne interfejsy API
Dział zatytułowany „Główne interfejsy API”Korzystaj z tych dwóch stron podczas tworzenia rozwiązań opartych na serwerze.
| Strona | Rola |
|---|---|
| Dokumentacja API | Każde zarejestrowane narzędzie wraz z nazwą i klasą, symbole usług i komunikatów gRPC, model błędów oraz limity szybkości. |
| Przewodnik dla programistów | Granice architektury, cykl życia środowiska wykonawczego, ustalanie poziomu, bramka potwierdzenia, punkty rozszerzeń oraz lista kontrolna testów. |
Zobacz także
Dział zatytułowany „Zobacz także”- Przegląd — koncepcyjny punkt wejścia do pakietu
- Dokumentacja API — dokładne symbole narzędzi, wywołań RPC i komunikatów
- Przewodnik dla programistów — jak budować, rozszerzać i obsługiwać serwer
- Bezpieczeństwo i operacje — uwierzytelnianie i model zagrożeń