NextPDF Connect
NextPDF Connect
Sekilas pandang
Bagian berjudul “Sekilas pandang”NextPDF Connect adalah paket nextpdf/server. Paket ini berjalan sebagai layanan jangka panjang yang mengekspos mesin NextPDF PDF 2.0 kepada agen kecerdasan buatan (AI) dan klien Hypertext Transfer Protocol (HTTP). Registri alat yang sama tersedia melalui tiga transport: Model Context Protocol (MCP) di atas input dan output standar, Application Programming Interface (API) bergaya Representational State Transfer (REST) yang dijelaskan oleh dokumen OpenAPI 3.1, dan gRPC yang didefinisikan oleh paket Protocol Buffers nextpdf.connect.v1. Setiap alat menyatakan tingkat risiko. Alat pada tingkat tertinggi harus melewati gerbang konfirmasi human-in-the-loop (HITL) sebelum dijalankan.
Gunakan bagian ini saat Anda mengoperasikan atau mengintegrasikan server. Mulailah dengan Ikhtisar untuk memahami arsitekturnya, pilih transport, lalu gunakan referensi API untuk simbol alat dan layanan yang tepat.
Peta bagian
Bagian berjudul “Peta bagian”Halaman-halaman ini membahas konsep, konfigurasi, dan operasi server.
| Halaman | Gunakan untuk |
|---|---|
| Ikhtisar | Batasan paket, ketiga transport, dan alasan jumlah alat merupakan properti runtime. |
| Mulai cepat | Handshake MCP pertama yang dapat dijalankan dan permintaan render REST yang sesuai. |
| Konfigurasi | Berkas YAML MCP, variabel lingkungan NEXTPDF_*, dan penggantian risiko yang hanya diperbolehkan menaikkan tingkat. |
| Boot dan penemuan | Cara setiap transport menyambungkan server serta menemukan alat dan tingkatan saat boot. |
| Katalog alat | Kumpulan alat inti yang terverifikasi dan selalu tersedia serta cara runtime menghitung jumlah totalnya. |
| Tingkatan risiko HITL | Model risiko empat tingkat dan tantangan konfirmasi untuk alat yang memerlukan persetujuan. |
| Penerapan | Profil worker RoadRunner, Docker, penyimpanan berbasis Redis, dan Transport Layer Security (TLS) timbal balik untuk gRPC. |
| Keamanan dan operasi | Autentikasi, keamanan transport, model ancaman, dan postur residensi data. |
Setiap transport memiliki halaman referensinya sendiri.
| Halaman transport | Gunakan untuk |
|---|---|
| Transport MCP | Framing JavaScript Object Notation Remote Procedure Call (JSON-RPC) 2.0 di atas stdio, dan metode initialize / tools/list / tools/call. |
| Transport REST | Pipeline RoadRunner PSR-15, kontrak OpenAPI 3.1, autentikasi bearer, dan rute yang dibatasi berdasarkan tingkatan. |
| Transport gRPC | Layanan nextpdf.connect.v1.NextPDFConnect, RPC server-streaming, dan autentikasi metadata. |
API utama
Bagian berjudul “API utama”Gunakan kedua halaman ini saat Anda membangun integrasi dengan server.
| Halaman | Peran |
|---|---|
| Referensi API | Setiap alat yang terdaftar menurut nama dan kelas, simbol layanan dan pesan gRPC, model kesalahan, dan batas laju. |
| Panduan pengembang | Batasan arsitektur, siklus hidup runtime, resolusi tingkatan, gerbang konfirmasi, titik ekstensi, dan daftar periksa pengujian. |
Lihat juga
Bagian berjudul “Lihat juga”- Ikhtisar — pintu masuk konseptual untuk paket ini
- Referensi API — simbol alat, RPC, dan pesan yang tepat
- Panduan pengembang — cara membangun, memperluas, dan mengoperasikan server
- Keamanan dan operasi — autentikasi dan model ancaman