Connect 上的 AI 就绪度检查

命名说明。 此工作流是一项 AI 就绪度检查，并非认证。此工具会在四个维度上产出分级评分。该检查并不证明此文档已针对任何用途「取得认证」。为保持连续性，slug 保留历史沿用的 ai-ready-certification 片段，但此工作流是一项就绪度评估，独立流程可以佐证或推翻该评估。

概览

此示例通过 Connect 传输层之上的 AI 就绪度工具，从四个维度为文档评分：完整性（取证）、长存性（长期验证健康状态）、结构（已标记/可访问的内容）与机器可读性（文本提取）。此工具属于 Enterprise 层级。可通过 class_exists() 探测发现它；只有在服务器端同时安装了 nextpdf/premium 时，它才会注册。文档的创建与渲染使用核心工具。

分级结果（一个字母评级加上各维度分数）是此工具自身给出的就绪度评估。它并非认证。获得「Grade A」结果，只表示此工具在自身检查范围内未发现问题，并不表示任何权责机构已经认证此文档。

安装

composer require nextpdf/server

通过一次 tools/list 调用确认 Enterprise AI 就绪度工具存在。请参见 /connect/tool-catalog/。

概念总览

结构维度会奖励已标记的自然语言结构，使内容能够按阅读顺序被机器提取（ISO 32000-2 §14.7）。长存性维度反映长期验证素材。PAdES 基准层级彼此不同，而 B-LT/B-LTA 长存性素材是 Enterprise 专属能力（ETSI EN 319 142-2 §5.5）。标准规定要求，检查器评估文档；软件本身并不会自我认证（PDF/A-4 §6.2.3）。因此，该分数是一项就绪度信号，并非符合性或法律证明。

API 接口

工具名称通过 tools/list 针对运行中的注册表进行验证。权威目录是 /connect/tool-catalog/。此示例不重复列出工具数量。

代码示例——快速上手

使用核心工具创建并渲染文档，然后运行就绪度检查：

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

工具名称 ai_ready_certify 是已注册的协议名称。如上方命名说明所述，它执行的工作流 是一项就绪度检查。

代码示例——生产环境

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; }

响应包含一个顶层评级，以及各维度的分数（integrity、longevity、structure、machine_readability），并附上发现项与建议。请将该评级视为需要采取行动的就绪度信号，而非一张证书。

边界情况与陷阱

文档尚未渲染。 此检查需要一份已定稿的 PDF；请先渲染文档。
仅含扫描图像的 PDF。 机器可读性维度分数会偏低；请在检查前先做 OCR。
不含任何签名。 长存性维度仅为提示性质，并非失败。此工具会报告缺少 LTV 素材；它不会将此视为篡改而扣分。
工具不存在。 如果未安装 nextpdf/premium，Enterprise AI 就绪度工具便不会注册；该调用会因未知工具错误而失败。

性能

前置数据中的预算是文档层面的上限。大型文档可能触及此工具的分析超时；请拆分处理，而非调高全局超时。

安全性说明

完整性维度复用了取证分析，因此其「干净」子裁决适用相同限制。它只表示在已执行的分析范围内未检测到修改，并非防篡改保证。请勿在会对外输出的日志级别记录文档路径或完整报告。

符合性

主张	条款	reference_id
由检查器评估文档；软件本身并不自我认证	PDF/A-4 §6.2.3
已标记的自然语言结构 → 可按阅读顺序被机器提取	ISO 32000-2 §14.7
B-LT/B-LTA 长存性素材各不相同，且为 Enterprise 专属	ETSI EN 319 142-2 §5.5

支持 AI 就绪度检查并不等于认证。分级结果是一项就绪度评估。任何认证判定都应由独立流程做出。

商业背景

AI 就绪度工具属于 Enterprise 层级，只有在服务器端同时安装了 nextpdf/premium 时才会注册。

Connect 细节

传输可用性（MCP / REST / gRPC）

此调用通过共享工具执行器，在 MCP tools/call、REST 工具端点与 gRPC 服务上以相同方式发起。

HITL 风险层级

文档创建与渲染属于警示层级；就绪度检查为只读。默认情况下，这些操作都不是 approval_required。请参见 /connect/hitl-risk-tiers/。

确认门 JSON 信封

这些工具不会触发该门，除非操作者通过覆盖配置将其中一项提升为 approval_required。信封与一次性令牌的契约位于 /connect/hitl-risk-tiers/。

另请参阅

/cookbook/connect/compliance-check/ —— 针对特定具名标准的检查。
/cookbook/connect/forensic-analysis/ —— 完整性维度的详细说明。
/cookbook/connect/ltv-health-check/ —— 长存性维度的详细说明。
/connect/tool-catalog/ —— 各层级工具集的计算方式。