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

# Revisione KYC e AML con AI: agente Investigator

> Con Didit, l'Investigator prepara un report con fonti per ogni verifica, alert e caso in revisione: tu scegli quanto può decidere da solo.

> [!WARNING]
>
> L'Investigator è una funzionalità nuova e non è ancora attiva per tutte le organizzazioni. Chiedi a Didit di attivarla. Richiede il piano Growth o superiore e non viene mai eseguito sulle applicazioni sandbox.

L'Investigator esamina gli elementi che attendono l'intervento di una persona. Per ciascuno legge il record, scrive un report con una raccomandazione e le evidenze a supporto, e poi attende il tuo revisore oppure, se lo consenti, decide autonomamente.

## Cosa esamina

| Coda | Elemento | Si avvia quando |
| - | - | - |
| KYC | Una sessione di verifica | La sessione passa a **In revisione**. |
| KYB | Una verifica aziendale | La sessione passa a **In revisione**. |
| AML | Una sessione con un riscontro del monitoraggio AML continuo | Arriva un nuovo riscontro. |
| Transazioni | Un alert di transazione | La transazione passa a **In revisione**. |
| Casi | Un caso | Il caso viene aperto o riaperto. |

Se il tuo team decide prima sull'elemento, l'esecuzione dell'Investigator si chiude senza una decisione.

## Il report

Ogni report contiene:

* una **raccomandazione**: approvare, rifiutare, richiedere ulteriori informazioni (nuova presentazione per una verifica, in attesa dell'utente per una transazione) oppure escalare,
* un'**affidabilità**: alta, moderata o bassa,
* un riepilogo e il ragionamento,
* **evidenze**: ogni punto è contrassegnato come regolare, un rischio, da verificare, spiegato oppure contesto, e cita le sue fonti,
* per i riscontri di screening, se ciascun riscontro riguarda la stessa persona, una persona diversa oppure non è chiaro,
* i passaggi successivi suggeriti, come aprire un record collegato o un caso.

### Le fonti citate

L'Investigator legge gli stessi dati che i tuoi revisori vedono nella console e nell'API: la decisione sulla verifica, la decisione sulla verifica aziendale, il dettaglio della transazione o il dettaglio del caso. Può anche aprire sessioni, transazioni e casi collegati. Ogni punto delle evidenze cita la sezione del record che ha letto oppure il record collegato che ha aperto. Il report mostra inoltre **Cosa ho verificato**: la panoramica, le sezioni e i record letti, in ordine.

Lavora solo a partire da quel record. Prima che il record raggiunga il modello, Didit rimuove media, link e identificatori interni e maschera le caratteristiche protette. L'Investigator non può modificare i dati. Si limita a scrivere il suo report.

## Fasi

| Fase | Cosa succede | Addebitato |
| - | - | - |
| **Non configurato** | L'Investigator non viene eseguito. | No |
| **Modalità osservazione** | Scrive i report e confronta i propri punteggi con le decisioni del tuo team. I revisori decidono come di consueto. | No |
| **Automazione attiva** | I report compaiono per i revisori e le code possono decidere autonomamente al livello di autonomia che scegli. | Sì |

Esegui la modalità osservazione per 7, 14 (predefinito) o 30 giorni prima di passare alla produzione. La configurazione, la modalità osservazione e i backtest non vengono mai addebitati.

## Livelli di autonomia

Imposta un livello di autonomia per ciascuna coda:

| Livello | Cosa fa |
| - | - |
| **Disattivato** | Gli elementi arrivano ai revisori senza un report. |
| **Suggerire** (predefinito) | Prepara il report. Una persona decide ogni elemento. |
| **Automatico** | Decide gli elementi coperti dalla tua policy, con affidabilità **alta**, quando il suo accordo passato con il tuo team raggiunge la soglia della coda. |
| **Completamente automatico** | Decide anche gli elementi con affidabilità **moderata**. Un campione viene comunque inviato a una persona per i controlli di qualità. |

L'Investigator decide autonomamente solo quando valgono tutte queste condizioni:

* l'applicazione è in produzione, la coda è su **Automatico** o **Completamente automatico** e non è in pausa,
* la policy del tuo team copre l'elemento e prevede di eseguire l'azione raccomandata,
* nessun guardrail trattiene l'elemento,
* il suo accordo con le decisioni passate del tuo team raggiunge la soglia, su almeno 20 decisioni negli ultimi 90 giorni,
* l'elemento non è stato scelto per il campione di controllo qualità, rientra nella quota del rollout e non è stato raggiunto il limite giornaliero.

| Impostazione della coda | Valori |
| - | - |
| Soglia | 80, 85, 90 (predefinito) o 95% di accordo |
| Campione di controllo qualità | 2, 5 (predefinito) o 10% degli elementi decisi va a una persona |
| Limite giornaliero | Predefinito 200 elementi al giorno |
| Rollout | Graduale (25% degli elementi per 14 giorni) oppure tutti gli elementi |
| Limite di importo | Le transazioni al di sopra di questo limite vanno sempre a una persona. Predefinito 25.000 nella valuta della tua applicazione. |
| Avanzamento automatico | Sale di un livello quando l'accordo raggiunge il 98% |

Per portare una coda su **Automatico** o **Completamente automatico**, devi prima eseguire un backtest sulle decisioni passate e confermarne il risultato. Le code **Casi** e **AML** non vengono mai accettate in blocco, e i casi escalati o i casi in attesa di un secondo revisore non vengono mai decisi automaticamente.

## Guardrail

Queste regole sono sempre attive e non possono essere modificate:

* Le corrispondenze con le sanzioni vanno sempre a una persona.
* I motivi legati a frodi e AML non arrivano mai agli utenti finali.
* Nessuna decisione si basa sulle caratteristiche protette.
* L'Investigator non presenta mai una segnalazione regolamentare.
* Ogni decisione viene registrata e può essere sostituita.

## Revisione di un report

Con il livello **Suggerire**, un revisore può:

* **Accetta** la raccomandazione,
* **Modifica e accetta** la raccomandazione,
* **Sostituisci** la raccomandazione, indicando una categoria (contesto mancante, servono informazioni, la policy è diversa, evidenza interpretata male, altro) e un motivo di 10-500 caratteri,
* **Accetta in blocco** fino a 50 elementi contrassegnati come **Pronti da accettare**.

Accettare una raccomandazione applica la decisione tramite il normale percorso dell'elemento, quindi i webhook e le notifiche abituali vengono attivati. Un'escalation apre un caso collegato. Una decisione presa dall'Investigator è etichettata **Deciso dall'Investigatore** sull'elemento.

## Policy del team

Ogni coda ha una policy del team: le tue regole su cosa approvare, rifiutare o escalare. L'Investigator la segue, e decide autonomamente solo quando la policy copre l'elemento. Le policy sono versionate. La scheda **Domande** raccoglie i punti che l'Investigator ha bisogno che il tuo team chiarisca.

## Registro delle attività

La scheda **Attività** registra ogni report, accettazione, modifica, override, decisione automatica, blocco da guardrail e modifica delle impostazioni, indicando chi l'ha effettuata: l'Investigator, una persona, una chiave API o il sistema. Le voci non possono essere modificate. Puoi esportare fino a 10.000 voci in formato CSV.

Ogni decisione che l'Investigator prende autonomamente viene inoltre scritta nel [registro di audit](https://docs.didit.me/it/console/audit-logs.md) della tua organizzazione, sotto **The Investigator** e collegata al relativo report, accanto alle azioni compiute dai membri del team e dalle chiavi API.

## Prezzi

L'Investigator ha un unico prezzo: **\$0.20 per verifica esaminata (KYC, KYB o riscontro AML), per un alert di transazione o per un caso**. Per questo prezzo legge il record, redige un report con citazioni e la propria raccomandazione, e lo consegna al revisore oppure decide autonomamente entro la tua policy.

| Elemento esaminato | Prezzo |
| - | - |
| Verifica (KYC, KYB o riscontro AML), alert di transazione o caso | \$0.20 |

Ti viene addebitato un costo per elemento, una sola volta, e solo quando l'applicazione è in produzione e il report viene accettato, modificato e accettato, oppure quando l'Investigator decide autonomamente. Gli override, gli elementi decisi altrove dal tuo team, le esecuzioni non riuscite, la modalità shadow, la configurazione e i backtest sono gratuiti. Si applicano gli sconti del piano.

Puoi impostare un limite di spesa mensile facoltativo in **Impostazioni**. Al raggiungimento del limite, i nuovi elementi arrivano ai revisori senza report.

## API e webhook

L'API dell'Investigator si trova in `https://verification.didit.me/v3/investigator/` e utilizza la chiave API della tua applicazione (`x-api-key`).

| Endpoint | Scopo |
| - | - |
| `GET summary/`, `GET queue/` | Conteggi della coda ed elementi in attesa. |
| `GET runs/{id}/` | Un report. |
| `POST runs/{id}/accept/`, `POST runs/{id}/override/`, `POST runs/batch-accept/` | Agire sui report. |
| `GET transactions/{id}/` | Il report per una transazione. |
| `GET dashboard/`, `GET performance/`, `GET activity/`, `GET activity/export/` | Risultati e registro di audit. |
| `GET guardrails/` | I guardrail bloccati. |
| `GET` / `PATCH settings/` | Fase e limite di spesa mensile. |

Una chiave API con restrizioni richiede lo scope `decisions` per leggere e agire sui report, e lo scope `applications` per leggere o modificare le impostazioni. I report sulle transazioni richiedono inoltre lo scope `transactions`. Le chiavi limitate ad alcuni workflow o a sessioni approvate vengono rifiutate, perché la coda comprende tutti i workflow. Gli schemi completi delle richieste e delle risposte sono disponibili in [`openapi-25.json`](https://docs.didit.me/openapi-25.json), sotto il tag **Investigator**.

Non esiste un webhook separato per l'Investigator. Il `decision` contenuto nel [webhook `status.updated`](https://docs.didit.me/it/integration/webhooks#blocco-investigator) e in `GET /v3/session/{id}/decision/` include un blocco `investigator` con `status`, `recommendation`, `confidence`, `summary`, `ready_to_accept`, `automated` e `decided_by` (`investigator` o `member`) dell'esecuzione.

## Correlati

> [card] [Revisione manuale](https://docs.didit.me/it/console/manual-review.md)
>
> Come il tuo team esamina le sessioni di verifica.

> [card] [Casi](https://docs.didit.me/it/console/case-management/cases.md)
>
> Gestione dei casi per alert e indagini.


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