> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Document AI 规则与警告

> Didit Document AI 基础规则与自定义状态规则解析：涵盖无法读取的证件、缺少必填字段、证件篡改、姓名不匹配以及字段级交叉比对。

## 概述

Document AI 通过两层规则为每个上传的证件生成状态，且每个证件的状态会按照 **已拒绝 > 审核中 > 已通过** 的优先级顺序合并为该功能的状态。

1. **基础规则**：内置检查项，每项均映射到一个可配置的操作：`DECLINE`、`REVIEW` 或 `NO_ACTION`。
2. **自定义状态规则**：针对任何提取字段的自定义条件，包括与其他步骤的交叉比对。

## 基本规则

以下每条规则都会在提取和取证分析过程中自动检测。请在 Document AI 功能的 **规则** 选项卡中配置每项规则的操作。

| 规则 | 配置字段 | 触发条件 |
| - | - | - |
| **文件无法读取** | `document_ai_unreadable_document_action` | 证件无法读取、无法提取任何数据，或无法完整检查文件 |
| **缺少必填字段** | `document_ai_missing_required_fields_action` | 标记为 **必填** 的字段无法提取 |
| **证件篡改** | `document_ai_document_tampering_action` | 取证分析检测到篡改迹象 |
| **姓名不匹配** | `document_ai_name_mismatch_action` | 证件上的姓名与已验证主体不匹配（低于 `document_ai_name_match_score_threshold`）：在个人（KYC）工作流中，已验证主体是持证人的身份；在企业（KYB）工作流中，已验证主体是公司 |
| **不支持的文件** | `document_ai_unsupported_file_action` | 上传的文件类型不受支持 |
| **超过尝试次数** | `document_ai_max_attempts_exceeded_action` | 用户超过 `document_ai_max_retry_attempts` |

**姓名不匹配**检查使用 0–100 分的评分，将证件上标记的姓名字段与已验证主体进行比对：在个人（KYC）工作流中，与已验证的证件信息进行比对（以及创建会话时提供的预期信息）；在企业（KYB）工作流中，与已验证的公司进行比对（即与公司登记信息匹配的公司，或预期公司名称）。请使用 `document_ai_name_match_score_threshold` 设置阈值。

## 自定义状态规则

自定义状态规则允许您在提取字段满足某个条件时设置状态（`Approved`、`In Review`、`Declined` 或 `No Action`）。每条规则包含：

```json theme={null}
{
  "field": "document_ai.balance",
  "operator": "greater_than",
  "value": 50000,
  "status": "In Review"
}
```

如需**与其他步骤进行交叉比对**，请设置 `value_type: "field"` 并将 `value` 指向另一个字段路径：

```json theme={null}
{
  "field": "document_ai.account_holder",
  "operator": "fuzzy_match",
  "value": "kyc.full_name",
  "value_type": "field",
  "score": 80,
  "status": "Declined"
}
```

每个匹配的规则都会提供其状态，并且在这些状态与基础状态中，最严格的状态将最终生效（已拒绝 > 审核中 > 已通过）。因此，规则可以提升严重级别，但绝不能将由风险触发的 `Declined`/`In Review` 恢复为较低级别。`No Action` 规则会被记录，但不会改变状态。

> [!NOTE]
>
> 提取的字段可通过 `document_ai.<field_key>` 访问，其中使用的是您为每个字段配置的 `key`。数字和日期字段支持比较运算符（`greater_than`、`less_than`、日期范围）；文本字段支持相等比较、`contains` 和 `fuzzy_match`。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.