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 vào, và một dòng mô tả phạm vi. Các trang công thức được biên soạn trong cây thư mục docs/public/ của kho lưu trữ nextpdf/server và được xuất bản lên trang này thông qua bộ tổng hợp.
| Công thức | Bậc | Phạm vi |
|---|---|---|
hello-world | Core | Lệnh gọi Connect đầu tiên: tạo, thêm nội dung, xuất |
multi-page | Core | Tài liệu nhiều trang qua Connect |
image-embedding | Core | Nhúng một hình ảnh qua Connect |
html-table | Core | Kết xuất một bảng HTML qua Connect |
font-typography | Core | Phông chữ và kiểu chữ qua Connect |
exception-aware | Core | Các lệnh gọi công cụ có nhận biết ngoại lệ |
environment-diagnostics | Core | Các công cụ chẩn đoán môi trường |
layout-inspection | Core | Kiểm tra bố cục mà không kết xuất |
worker-safe | Core | Sử dụng theo lô an toàn với worker |
batch-pdf-generation-with-progress-tracking | Core | Tạo hàng loạt PDF có theo dõi tiến độ bất đồng bộ |
rest-invoice-end-to-end | Core | Một hóa đơn qua REST: gửi, thăm dò, tải xuống, xác minh cục bộ |
output-approval | Core | Cổng kiểm soát đầu ra có con người tham gia |
mcp-agent-session | Core | Một phiên agent MCP được ghi lại với vòng phê duyệt khứ hồi |
event-hooks | Core | Các hook sự kiện vòng đời |
fill-pdf-form | Pro | Điền biểu mẫu PDF qua Connect |
extract-text-content | Pro | Trích xuất nội dung văn bản qua Connect |
digital-signature | Pro | Ký một tệp PDF (PAdES B-B và B-T) qua Connect |
accessibility-check | Pro | Kiểm tra khả năng tiếp cận PDF/UA |
pii-redaction | 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 | Pro | Ánh xạ các vai trò mốc ARIA sang cấu trúc đã gắn thẻ |
figure-caption | Pro | Figure có thể tiếp cận với Caption được lồng bên trong |
aria-noteref-pattern | Pro | Mẫu tham chiếu và nội dung chú thích cuối trang |
compliance-check | Enterprise | Chạy bài kiểm tra theo một tiêu chuẩn được đặt tên |
forensic-analysis | Enterprise | Phân tích pháp y trên một tệp PDF đã ký |
ltv-health-check | Enterprise | Kiểm tra tình trạng LTV (B-LT/B-LTA, chỉ có ở Enterprise) |
batch-compliance | Enterprise | Kiểm tra tiêu chuẩn theo lô |
ai-ready-certification | Enterprise | Kiểm tra mức độ sẵn sàng cho AI (không phải chứng nhận) |
page-artifacts | Enterprise | Đánh dấu các thành phần trang trí phân trang là artifact |
conformance-mode | 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 | Enterprise | Số liệu viết dọc CJK |
opentelemetry | Core | Quan sát Connect bằng OpenTelemetry |
tagged-pdf-tutorial | 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.