Sách hướng dẫn Connect
Sách hướng dẫn Connect
Phần tiêu đề “Sách hướng dẫn Connect”NextPDF Connect mở engine NextPDF cho các bên gọi từ xa và các hệ thống trí tuệ nhân tạo (AI) thông qua Model Context Protocol (MCP), một API Representational State Transfer (REST) và một dịch vụ gRPC. Sách hướng dẫn Connect tập hợp các công thức tác vụ cho bề mặt đó, còn trang này đóng vai trò là chỉ mục. Trang ghi lại slug của từng công thức, bậc mà nó thuộc về và ranh giới truyền tải áp dụng. Vì đây là một chỉ mục, trang không đưa ra tuyên bố nào về hành vi của bất kỳ công thức nào. Mỗi trang công thức được biên soạn trong kho lưu trữ nextpdf/server trong thư mục docs/public/, tự chịu trách nhiệm về các tuyên bố của riêng mình, và được aggregator đưa vào trang này với nguồn gốc xuất xứ được giữ nguyên.
Để xem hợp đồng mà mọi công thức Connect đều tuân theo, hãy đọc Quy ước về công thức. Để xem toàn cảnh tích hợp của cả hệ sinh thái, hãy đọc Sách hướng dẫn tích hợp.
Bậc ảnh hưởng đến những gì bạn có thể chạy như thế nào
Phần tiêu đề “Bậc ảnh hưởng đến những gì bạn có thể chạy như thế nào”Một bản triển khai Connect tính toán tập hợp công cụ khi khởi động; tập hợp này không được cố định sẵn. Sổ đăng ký công cụ của máy chủ luôn đăng ký các công cụ lõi. Sau đó, máy chủ dò tìm các nhà cung cấp Pro và Enterprise bằng class_exists(), và chỉ đăng ký các công cụ của chúng khi nextpdf/premium được cài đặt cùng với máy chủ. Một công thức phụ thuộc vào công cụ Pro hoặc Enterprise chỉ chạy trên bản triển khai nơi công cụ đó đã được phân giải. Trên bản cài đặt chỉ có mã nguồn mở, công cụ đó không hiện diện, và lệnh gọi trả về lỗi công cụ không xác định thay vì âm thầm hạ cấp hành vi. Mỗi công thức nêu rõ bậc của mình, và chỉ mục này nhóm các công thức theo bậc để bạn có thể thấy ngay một bản triển khai hỗ trợ những gì.
Tổng số công cụ là thuộc tính tại thời điểm chạy của bản triển khai. Không công thức nào, cũng không hàng nào trong chỉ mục này khẳng định một con số cố định. Danh mục chính thức là danh mục công cụ riêng của máy chủ, và mỗi công thức đều liên kết đến đó.
Mô hình truyền tải và lỗi
Phần tiêu đề “Mô hình truyền tải và lỗi”Bạn gọi mọi công thức theo cùng một cách qua cả ba phương thức truyền tải: một MCP tools/call, endpoint công cụ REST, hoặc dịch vụ gRPC. Chúng dùng chung một bộ thực thi công cụ. Các công thức gọi một dịch vụ từ xa qua Hypertext Transfer Protocol (HTTP) xem lỗi truyền tải và trạng thái HTTP không thành công là hai trường hợp riêng biệt. Một client PSR-18 chỉ ném ra ngoại lệ client có kiểu khi hoàn toàn không thể gửi yêu cầu, như mô tả trong PSR-18 §4. Một phản hồi 4xx hoặc 5xx thì khác. Đó là giá trị trả về bình thường để bên gọi kiểm tra, không phải một ngoại lệ, như mô tả trong PSR-18 §4.
Bản đồ slug của công thức
Phần tiêu đề “Bản đồ slug của công thức”Mỗi công thức nằm tại /cookbook/connect/<recipe>/. Bảng ghi lại slug, bậc mà công thức được xếp theo, và một dòng mô tả phạm vi. Các trang công thức được biên soạn trong nextpdf/serverdocs/public/ và được tổng hợp tại đây. Cho đến khi một trang xuất hiện, liên kết của nó là tham chiếu dành cho tương lai.
| Công thức | Bậc | Phạm vi |
|---|---|---|
hello-world (dự kiến từ thượng nguồn) | Core | Lệnh gọi Connect đầu tiên: tạo, thêm nội dung, xuất |
multi-page (dự kiến từ thượng nguồn) | Core | Tài liệu nhiều trang qua Connect |
image-embedding (dự kiến từ thượng nguồn) | Core | Nhúng một hình ảnh qua Connect |
html-table (dự kiến từ thượng nguồn) | Core | Kết xuất một bảng HTML qua Connect |
font-typography (dự kiến từ thượng nguồn) | Core | Phông chữ và kiểu chữ qua Connect |
exception-aware (dự kiến từ thượng nguồn) | Core | Các lệnh gọi công cụ có nhận biết ngoại lệ |
environment-diagnostics (dự kiến từ thượng nguồn) | Core | Các công cụ chẩn đoán môi trường |
layout-inspection (dự kiến từ thượng nguồn) | Core | Kiểm tra bố cục mà không kết xuất |
worker-safe (dự kiến từ thượng nguồn) | Core | Sử dụng theo lô an toàn với worker |
output-approval (dự kiến từ thượng nguồn) | Core | Cổng kiểm soát đầu ra có con người tham gia |
event-hooks (dự kiến từ thượng nguồn) | Core | Các hook sự kiện vòng đời |
fill-pdf-form (dự kiến từ thượng nguồn) | Pro | Điền biểu mẫu PDF qua Connect |
extract-text-content (dự kiến từ thượng nguồn) | Pro | Trích xuất nội dung văn bản qua Connect |
digital-signature (dự kiến từ thượng nguồn) | Pro | Ký một tệp PDF (PAdES B-B và B-T) qua Connect |
accessibility-check (dự kiến từ thượng nguồn) | Pro | Kiểm tra khả năng tiếp cận PDF/UA |
pii-redaction (dự kiến từ thượng nguồn) | Enterprise | Xóa dữ liệu cá nhân đã phát hiện khỏi lớp văn bản (phá hủy) |
aria-tagged-pdf (dự kiến từ thượng nguồn) | Pro | Ánh xạ các vai trò mốc ARIA sang cấu trúc đã gắn thẻ |
figure-caption (dự kiến từ thượng nguồn) | Pro | Figure có thể tiếp cận với Caption được lồng bên trong |
aria-noteref-pattern (dự kiến từ thượng nguồn) | Pro | Mẫu tham chiếu và nội dung chú thích cuối trang |
compliance-check (dự kiến từ thượng nguồn) | Enterprise | Chạy bài kiểm tra theo một tiêu chuẩn được đặt tên |
forensic-analysis (dự kiến từ thượng nguồn) | Enterprise | Phân tích pháp y trên một tệp PDF đã ký |
ltv-health-check (dự kiến từ thượng nguồn) | Enterprise | Kiểm tra tình trạng LTV (B-LT/B-LTA, chỉ có ở Enterprise) |
batch-compliance (dự kiến từ thượng nguồn) | Enterprise | Kiểm tra tiêu chuẩn theo lô |
ai-ready-certification (dự kiến từ thượng nguồn) | Enterprise | Kiểm tra mức độ sẵn sàng cho AI (không phải chứng nhận) |
page-artifacts (dự kiến từ thượng nguồn) | Enterprise | Đánh dấu các thành phần trang trí phân trang là artifact |
conformance-mode (dự kiến từ thượng nguồn) | Enterprise | Chọn một chế độ tuân thủ (có ý định tuân thủ; một bộ xác thực quyết định) |
cjk-vertical-writing (dự kiến từ thượng nguồn) | Enterprise | Số liệu viết dọc CJK |
opentelemetry (dự kiến từ thượng nguồn) | Core | Quan sát Connect bằng OpenTelemetry |
tagged-pdf-tutorial (dự kiến từ thượng nguồn) | Core | Hướng dẫn PDF có gắn thẻ (có ý định tuân thủ; veraPDF quyết định) |
Slug thể hiện ý định của công thức theo kiểu kebab-case với một dấu gạch chéo ở cuối: không có tiền tố số, không có số phiên bản và không có phần mở rộng tệp. Slug của một công thức không thay đổi sau khi đã xuất bản, và slug đã được di chuyển sẽ có chuyển hướng đi kèm.
Ranh giới giữa tuân thủ và chứng nhận
Phần tiêu đề “Ranh giới giữa tuân thủ và chứng nhận”Một số công thức liên quan đến các tiêu chuẩn (PDF/UA-2, PDF/A-4, PAdES). Sách hướng dẫn Connect xem việc hỗ trợ một tiêu chuẩn chỉ là hỗ trợ, không bao giờ là tuyên bố tuân thủ hay chứng nhận. Engine tạo ra đầu ra có ý định tuân thủ, và một bộ xác thực độc lập (ví dụ veraPDF) xác định mức độ tuân thủ. Công thức về mức độ sẵn sàng cho AI là một bài kiểm tra mức độ sẵn sàng, không phải một chứng nhận. Phần tài liệu xác thực dài hạn của công thức LTV là một khả năng chỉ có ở Enterprise. Sự hiện diện của nó trong một tài liệu là một khả năng mà tài liệu mang theo, không phải một bảo đảm về tính hợp lệ vô thời hạn của chữ ký. Mỗi công thức liên quan đều nêu lại đầy đủ các ranh giới này. Chỉ mục này chỉ ghi nhận rằng chúng tồn tại và chỉ đến nơi chúng được dẫn xuất, thay vì dẫn xuất lại chúng ở đây.
Xem thêm
Phần tiêu đề “Xem thêm”- Quy ước về công thức — hợp đồng mà mọi công thức Connect đều tuân theo.
- Sách hướng dẫn tích hợp — tài liệu tham khảo về gói và tích hợp trong toàn hệ sinh thái, trong đó Connect là dịch vụ mạng.