NextPDF Connect
Tổng quan nhanh
Phần tiêu đề “Tổng quan nhanh”NextPDF Connect là gói nextpdf/server. Gói này chạy như một dịch vụ thường trực, cung cấp engine NextPDF PDF 2.0 cho các agent trí tuệ nhân tạo (AI) và các client Hypertext Transfer Protocol (HTTP). Cùng một sổ đăng ký công cụ được cung cấp qua ba phương thức truyền tải: Model Context Protocol (MCP) qua đầu vào và đầu ra chuẩn, Application Programming Interface (API) Representational State Transfer (REST) được mô tả bằng tài liệu OpenAPI 3.1, và gRPC được định nghĩa bởi gói Protocol Buffers nextpdf.connect.v1. Mỗi công cụ đều khai báo mức rủi ro. Các công cụ ở mức cao nhất phải vượt qua cổng xác nhận có con người trong vòng lặp (HITL) trước khi chạy.
Dùng mục này khi bạn vận hành hoặc tích hợp máy chủ. Bắt đầu với Tổng quan để nắm kiến trúc, chọn một phương thức truyền tải, rồi dùng Tài liệu API để tra chính xác các ký hiệu công cụ và dịch vụ.
Bản đồ nội dung
Phần tiêu đề “Bản đồ nội dung”Các trang này trình bày khái niệm, cấu hình và cách vận hành máy chủ.
| Trang | Dùng cho |
|---|---|
| Tổng quan | Ranh giới của gói, ba phương thức truyền tải và lý do số lượng công cụ là một thuộc tính lúc chạy. |
| Bắt đầu nhanh | Lần bắt tay MCP đầu tiên có thể chạy được và yêu cầu kết xuất REST tương ứng. |
| Cấu hình | Tệp YAML của MCP, các biến môi trường NEXTPDF_* và cơ chế ghi đè rủi ro chỉ theo hướng nâng bậc. |
| Khởi động và khám phá | Cách mỗi phương thức truyền tải kết nối với máy chủ tương ứng và khám phá công cụ cùng các bậc lúc khởi động. |
| Danh mục công cụ | Bộ công cụ cốt lõi đã được xác minh, luôn sẵn sàng, và cách runtime tính tổng số lượng. |
| Các bậc rủi ro HITL | Mô hình rủi ro bốn cấp và thử thách xác nhận cho các công cụ cần phê duyệt. |
| Triển khai | Các hồ sơ worker RoadRunner, Docker, kho lưu trữ dựa trên Redis và Transport Layer Security (TLS) tương hỗ cho gRPC. |
| Bảo mật và vận hành | Xác thực, bảo mật truyền tải, mô hình mối đe dọa và lập trường về lưu trú dữ liệu. |
Mỗi phương thức truyền tải có một trang tham chiếu riêng.
| Trang phương thức truyền tải | Dùng cho |
|---|---|
| Phương thức truyền tải MCP | Khung thông điệp JavaScript Object Notation Remote Procedure Call (JSON-RPC) 2.0 qua stdio, cùng các phương thức initialize / tools/list / tools/call. |
| Phương thức truyền tải REST | Đường ống RoadRunner PSR-15, hợp đồng OpenAPI 3.1, xác thực bearer và các tuyến được kiểm soát theo bậc. |
| Phương thức truyền tải gRPC | Dịch vụ nextpdf.connect.v1.NextPDFConnect, các RPC phát luồng từ máy chủ và xác thực qua metadata. |
Các API chính
Phần tiêu đề “Các API chính”Dùng hai trang này khi bạn phát triển dựa trên máy chủ.
| Trang | Vai trò |
|---|---|
| Tài liệu API | Mọi công cụ đã đăng ký theo tên và lớp, các ký hiệu dịch vụ và thông điệp gRPC, mô hình lỗi và giới hạn tốc độ. |
| Hướng dẫn dành cho nhà phát triển | Ranh giới kiến trúc, vòng đời lúc chạy, cách phân giải bậc, cổng xác nhận, các điểm mở rộng và danh mục kiểm thử. |
Xem thêm
Phần tiêu đề “Xem thêm”- Tổng quan — điểm vào khái niệm cho gói này
- Tài liệu API — ký hiệu chính xác cho công cụ, RPC và thông điệp
- Hướng dẫn dành cho nhà phát triển — cách xây dựng, mở rộng và vận hành máy chủ
- Bảo mật và vận hành — xác thực và mô hình mối đe dọa