Kiểm tra mức độ sẵn sàng cho AI qua Connect

Lưu ý về cách đặt tên. Quy trình này là một bài kiểm tra mức độ sẵn sàng cho trí tuệ nhân tạo (AI), không phải là chứng nhận. Công cụ chấm điểm tài liệu theo bốn tiêu chí và trả về kết quả phân loại. Bài kiểm tra không khẳng định rằng tài liệu được “chứng nhận” cho bất kỳ mục đích nào. Slug vẫn giữ lại đoạn ai-ready-certification mang tính lịch sử để đảm bảo tính liên tục, nhưng quy trình vẫn là một bản đánh giá mức độ sẵn sàng để một quy trình độc lập có thể xác nhận hoặc ghi đè.

Tổng quan nhanh

Hướng dẫn này chấm điểm tài liệu theo bốn tiêu chí: tính toàn vẹn (pháp y), độ bền lâu dài (tình trạng xác thực dài hạn), cấu trúc (nội dung được gắn thẻ/dễ tiếp cận) và khả năng đọc bằng máy (trích xuất văn bản). Quy trình chạy công cụ kiểm tra mức độ sẵn sàng cho AI qua các kênh truyền tải Connect. Công cụ này thuộc gói Enterprise. Công cụ được phát hiện qua phép thăm dò class_exists() và chỉ được đăng ký khi nextpdf/premium được cài đặt cùng với máy chủ. Việc tạo và kết xuất tài liệu vẫn dùng các công cụ lõi.

Kết quả phân loại gồm một điểm chữ cùng với điểm số cho từng tiêu chí, và là bản đánh giá mức độ sẵn sàng do riêng công cụ đưa ra. Đó không phải là chứng nhận. Kết quả “Hạng A” nghĩa là các kiểm tra của công cụ không tìm thấy vấn đề nào trong phạm vi kiểm tra. Điều đó không có nghĩa là một cơ quan có thẩm quyền đã chứng nhận tài liệu.

Cài đặt

composer require nextpdf/server

Xác nhận công cụ kiểm tra mức độ sẵn sàng cho AI thuộc gói Enterprise hiện có bằng cách gọi tools/list. Xem /connect/tool-catalog/.

Tổng quan khái niệm

Tiêu chí cấu trúc ghi nhận cấu trúc được gắn thẻ và diễn đạt theo ngôn ngữ tự nhiên, giúp nội dung có thể được máy trích xuất theo trình tự đọc (ISO 32000-2 §14.7). Tiêu chí độ bền lâu dài phản ánh dữ liệu xác thực dài hạn. Các mức baseline của PAdES là riêng biệt, và dữ liệu độ bền lâu dài B-LT/B-LTA là tính năng chỉ có ở gói Enterprise (ETSI EN 319 142-2 §5.5). Tiêu chuẩn nêu các yêu cầu để công cụ kiểm tra đánh giá; phần mềm tạo ra tài liệu không tự chứng nhận (PDF/A-4 §6.2.3). Vì vậy điểm số là một tín hiệu về mức độ sẵn sàng, không phải là xác nhận tuân thủ hay xác nhận pháp lý.

Bề mặt API

Đối chiếu tên công cụ với sổ đăng ký đang chạy bằng tools/list. Danh mục chính thức là /connect/tool-catalog/. Hướng dẫn này không nhắc lại số lượng công cụ.

Mã ví dụ — khởi đầu nhanh

Tạo và kết xuất tài liệu bằng các công cụ lõi, sau đó chạy bài kiểm tra mức độ sẵn sàng:

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "ai_ready_certify",
    "arguments": { "document_id": "<id of a rendered document>" }
  }
}

Tên công cụ ai_ready_certify là tên giao thức đã đăng ký. Quy trình mà nó thực hiện là một bài kiểm tra mức độ sẵn sàng, đúng như lưu ý về cách đặt tên ở trên.

Mã ví dụ — môi trường vận hành

curl -sS -X POST https://connect.example.com/v1/tools/ai_ready_certify \
  -H 'Authorization: Bearer '"$NEXTPDF_CONNECT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"document_id":"<id>"}' \
  -o /tmp/ai-ready.json -w '%{http_code}' > /tmp/ai-ready-status || {
    echo "transport failure invoking ai_ready_certify" >&2; exit 1; }

Phản hồi bao gồm một điểm tổng ở cấp cao nhất và điểm số cho từng tiêu chí (integrity, longevity, structure, machine_readability), cùng với các phát hiện và khuyến nghị. Hãy xem điểm số như một tín hiệu về mức độ sẵn sàng để hành động, không phải là chứng chỉ.

Trường hợp biên & lưu ý

Tài liệu chưa được kết xuất. Bài kiểm tra yêu cầu một tệp PDF đã hoàn thiện; hãy kết xuất tài liệu trước.
Tệp PDF chỉ có ảnh quét. Tiêu chí khả năng đọc bằng máy sẽ nhận điểm thấp; hãy chạy nhận dạng ký tự quang học (OCR) trước khi kiểm tra.
Không có chữ ký nào. Tiêu chí độ bền lâu dài chỉ mang tính tư vấn, không phải là một lỗi. Công cụ báo cáo việc thiếu dữ liệu xác thực dài hạn (LTV); công cụ không trừ điểm vì điều đó như thể đó là sự can thiệp trái phép.
Không có công cụ. Nếu không có nextpdf/premium, công cụ kiểm tra mức độ sẵn sàng cho AI thuộc gói Enterprise sẽ không được đăng ký; lệnh gọi sẽ thất bại với lỗi công cụ không xác định.

Hiệu năng

Ngân sách trong phần front-matter là mức trần được ghi trong tài liệu. Tài liệu lớn có thể chạm ngưỡng thời gian chờ phân tích của công cụ; hãy chia nhỏ chúng thay vì tăng thời gian chờ toàn cục.

Lưu ý bảo mật

Tiêu chí toàn vẹn tái sử dụng phần phân tích pháp y, nên kết luận phụ “sạch” của tiêu chí này đi kèm cùng một lưu ý. Điều đó nghĩa là không phát hiện sự sửa đổi nào trong phạm vi phân tích đã thực hiện, không phải là một đảm bảo chống can thiệp trái phép. Không ghi nhật ký đường dẫn tài liệu hay toàn bộ báo cáo ở cấp nhật ký được gửi ra ngoài.

Tuân thủ

Tuyên bố	Điều khoản	reference_id
Một công cụ kiểm tra đánh giá tài liệu; phần mềm không tự chứng nhận	PDF/A-4 §6.2.3
Cấu trúc được gắn thẻ và dùng ngôn ngữ tự nhiên → có thể trích xuất bằng máy theo trình tự đọc	ISO 32000-2 §14.7
Dữ liệu độ bền lâu dài B-LT/B-LTA là riêng biệt và chỉ có ở gói Enterprise	ETSI EN 319 142-2 §5.5

Việc hỗ trợ bài kiểm tra mức độ sẵn sàng cho AI không phải là chứng nhận. Kết quả phân loại là một bản đánh giá mức độ sẵn sàng. Mọi quyết định về chứng nhận đều do một quy trình độc lập đưa ra.

Bối cảnh thương mại

Công cụ kiểm tra mức độ sẵn sàng cho AI nằm trong gói Enterprise và chỉ được đăng ký khi nextpdf/premium được cài đặt cùng với máy chủ.

Chi tiết riêng cho Connect

Khả năng dùng trên các kênh truyền tải (MCP / REST / gRPC)

Gọi lệnh theo cùng một cách qua Model Context Protocol (MCP) tools/call, điểm cuối công cụ Representational State Transfer (REST) và dịch vụ gRPC, tất cả đều thông qua bộ thực thi công cụ dùng chung.

Bậc rủi ro HITL

Việc tạo và kết xuất tài liệu thuộc mức thận trọng; bài kiểm tra mức độ sẵn sàng là thao tác chỉ đọc. Theo mặc định, không có công cụ nào ở mức approval_required. Xem /connect/hitl-risk-tiers/.

Gói JSON của cổng xác nhận

Các công cụ này không kích hoạt cổng xác nhận trừ khi một thao tác ghi đè của người vận hành nâng một công cụ lên mức approval_required. Hợp đồng về gói dữ liệu và token dùng một lần được mô tả trong /connect/hitl-risk-tiers/.

Xem thêm

/cookbook/connect/compliance-check/ — kiểm tra theo một tiêu chuẩn cụ thể được chỉ định.
/cookbook/connect/forensic-analysis/ — chi tiết về tiêu chí toàn vẹn.
/cookbook/connect/ltv-health-check/ — chi tiết về tiêu chí độ bền lâu dài.
/connect/tool-catalog/ — cách tính số công cụ theo từng gói.