> ## 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 формирует статус для каждого загруженного документа на основе двух уровней правил, а статусы отдельных документов объединяются в статус функции в соответствии с приоритетом: **Declined > In Review > Approved**.

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` | Имя в документе не совпадает с верифицированным субъектом: с личностью владельца в сценарии физического лица (KYC) или с компанией в сценарии юридического лица (KYB) (ниже `document_ai_name_match_score_threshold`) |
| **Неподдерживаемый файл** | `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 > Approved). Таким образом, правило может повысить уровень строгости, но никогда не может смягчить обусловленный рисками статус `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.