> ## 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.

# Regole e avvisi di Document AI

> Regole di Document AI in Didit: gestione documenti illeggibili, manomissioni, campi mancanti, discrepanze del nome e controlli incrociati.

## Panoramica

Document AI genera uno stato per ciascun documento caricato a partire da due livelli di regole, e gli stati per singolo documento si combinano nello stato della funzionalità secondo la precedenza **Rifiutata > In revisione > Approvata**.

1. **Regole di base** — controlli integrati, ciascuno associato a un'azione configurabile: `DECLINE`, `REVIEW` o `NO_ACTION`.
2. **Regole di stato personalizzate** — le tue condizioni su qualsiasi campo estratto, inclusi i riferimenti incrociati con altri passaggi.

## Regole di base

Ogni regola seguente viene rilevata automaticamente durante l'estrazione e l'analisi forense. Configura l'azione per ciascuna nella scheda **Regole** della funzionalità Document AI.

| Regola | Campo di configurazione | Si attiva quando |
| - | - | - |
| **Documento illeggibile** | `document_ai_unreadable_document_action` | Il documento non può essere letto, non è possibile estrarre alcun dato oppure non è stato possibile controllare il file per intero |
| **Campi obbligatori mancanti** | `document_ai_missing_required_fields_action` | Non è possibile estrarre un campo contrassegnato come **obbligatorio** |
| **Manomissione del documento** | `document_ai_document_tampering_action` | L'analisi forense rileva segni di manipolazione |
| **Discrepanza del nome** | `document_ai_name_mismatch_action` | Il nome sul documento non corrisponde al soggetto verificato: l'identità del titolare in un workflow di persona (KYC) oppure l'azienda in un workflow aziendale (KYB) (sotto `document_ai_name_match_score_threshold`) |
| **File non supportato** | `document_ai_unsupported_file_action` | Il tipo di file caricato non è supportato |
| **Tentativi superati** | `document_ai_max_attempts_exceeded_action` | L'utente supera `document_ai_max_retry_attempts` |

Il controllo **Discrepanza del nome** confronta il campo del nome indicato nel documento con il soggetto verificato, usando un punteggio da 0 a 100: in un workflow di persona (KYC) con l'ID verificato (e con i dati attesi forniti alla creazione della sessione), e in un workflow aziendale (KYB) con l'azienda verificata (l'azienda abbinata al registro delle imprese oppure il nome atteso dell'azienda). Imposta la soglia con `document_ai_name_match_score_threshold`.

## Regole di stato personalizzate

Le regole di stato personalizzate ti consentono di impostare uno stato (`Approved`, `In Review`, `Declined` o `No Action`) quando viene soddisfatta una condizione su un campo estratto. Ciascuna regola è:

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

Per **fare riferimento incrociato a un altro passaggio**, imposta `value_type: "field"` e indirizza `value` a un altro percorso di campo:

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

Ogni regola corrispondente contribuisce con il proprio stato, e prevale il più severo tra questi e lo stato di base (Rifiutata > In revisione > Approvata). Di conseguenza, una regola può aumentare la gravità ma non può mai riportare a un livello meno severo uno stato `Declined`/`In Review` determinato dal rischio. Le regole `No Action` vengono registrate ma lasciano lo stato invariato.

> [!NOTE]
>
> I campi estratti sono indirizzabili come `document_ai.<field_key>` utilizzando la `key` configurata per ciascun campo. I campi numerici e di data supportano operatori di confronto (`greater_than`, `less_than`, intervalli di date); i campi di testo supportano l'uguaglianza, `contains` e `fuzzy_match`.


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