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

# Override del supervisore AI

> Scopri come sovrascrivere il routing del supervisore AI per imporre una selezione deterministica degli agenti.

Quando il tuo chatbot utilizza una configurazione multi-agente, il **supervisore AI** determina automaticamente quale agente rivolto all’utente sia più adatto a gestire l’ultima richiesta.\
Tuttavia, possono esserci situazioni in cui desideri avere un controllo più **deterministico** su quale agente debba occuparsi del compito.

In questo articolo ti mostriamo come utilizzare gli **AI Supervisor Overrides** per definire regole logiche che, una volta soddisfatte, passano direttamente a un agente specifico.

Nella scheda **AI Agents** troverai un pulsante che espande le **AI Supervisor Settings**:

<Frame>
  <img src="https://mintcdn.com/innoq/9CizSgZikx55e9_4/images/supervisor-overrides-1.png?fit=max&auto=format&n=9CizSgZikx55e9_4&q=85&s=f32615fa8a48e9b2e8c259988c9b94f9" width="1363" height="797" data-path="images/supervisor-overrides-1.png" />
</Frame>

Dopo aver aperto le impostazioni, puoi definire nella scheda **Rules** condizioni logiche che vengono valutate ogni volta che l’utente invia una richiesta.\
Quando una condizione è soddisfatta, la decisione del supervisore AI viene ignorata e l’agente definito prende immediatamente in carico l’elaborazione.

Per aggiungere una nuova regola, fai clic su **Create new rule**.\
Per modificare le regole, apri l’opzione **Edit** nel menu a tre punti in alto a destra.

<Note>
  Tieni presente che potrebbe essere necessario scorrere verso il basso il menu a discesa per visualizzare altre opzioni durante la creazione della regola.
</Note>

Una volta completate le regole, assicurati di **Connect** — solo allora diventeranno attive.\
Le regole vengono valutate in un ordine prestabilito. Non appena una regola restituisce **TRUE**, tutte le regole successive vengono ignorate e questa viene eseguita immediatamente.

<Frame>
  <img src="https://mintcdn.com/innoq/9CizSgZikx55e9_4/images/supervisor-overrides-2.png?fit=max&auto=format&n=9CizSgZikx55e9_4&q=85&s=c50993d5e9adcd2cd320390ee9b15384" width="781" height="561" data-path="images/supervisor-overrides-2.png" />
</Frame>

Un buon esempio di utilizzo degli AI Supervisor Overrides è la **configurazione ritardata della raccolta dei lead**.\
Immaginiamo un caso in cui il chatbot debba rispondere alle FAQ generiche, ma iniziare a raccogliere i dati degli utenti solo dopo 2 o 3 domande.\
Se l’utente si rifiuta di fornire i dati, il chatbot deve comunque continuare ad assisterlo in modo anonimo.

Per prima cosa, è necessario disporre di una configurazione standard di raccolta dei lead, come descritto nell’articolo [Lead Collection](/lead-collection).\
Una volta completato questo passaggio, prosegui qui.

A questo punto, dovresti aver configurato due agenti rivolti all’utente:

<Frame>
  <img src="https://mintcdn.com/innoq/9CizSgZikx55e9_4/images/supervisor-overrides-3.png?fit=max&auto=format&n=9CizSgZikx55e9_4&q=85&s=ec9d4c66c3f96d42f962ec2a07ff68a8" width="1361" height="799" data-path="images/supervisor-overrides-3.png" />
</Frame>

Ora apri le AI Supervisor Settings e fai clic su **Create new rule**.\
Nel menu a tre punti in alto a destra, apri **Edit** per configurare la regola.\
Per il nostro caso d’uso, impostiamo la seguente condizione:

<Frame>
  <img src="https://mintcdn.com/innoq/9CizSgZikx55e9_4/images/supervisor-overrides-5.png?fit=max&auto=format&n=9CizSgZikx55e9_4&q=85&s=2e918bba9aed2d88ee70992945a722c5" width="781" height="259" data-path="images/supervisor-overrides-5.png" />
</Frame>

Questo significa:\
Non appena il **numero totale di richieste dell’utente** raggiunge esattamente **3**, il supervisore AI imposta l’agente attivo su **Lead Collection**.\
Fai clic su **Save**.

Successivamente, crea una seconda regola.\
Questa regola è la seguente:

1. Se l’agente corrente è **Lead Collection**,
2. E se il numero di richieste elaborate consecutivamente da questo agente è **inferiore a 4**,
3. E se una delle seguenti informazioni dell’utente **non è stata fornita**: nome, e-mail o numero di telefono,
4. ALLORA resta sull’agente Lead Collection.

Questo significa:\
L’agente Lead Collection rimane attivo fino a quando:

* si sono verificate almeno 4 interazioni, **oppure**
* sono state raccolte tutte le informazioni richieste.

In modalità di modifica, seleziona **Add Rule** per aggiungere nuove condizioni.\
Dopo il passaggio 2, la tua regola apparirà così:

<Frame>
  <img src="https://mintcdn.com/innoq/9CizSgZikx55e9_4/images/supervisor-overrides-6.png?fit=max&auto=format&n=9CizSgZikx55e9_4&q=85&s=a02491e763352958656aa0a94fd7f47b" width="762" height="329" data-path="images/supervisor-overrides-6.png" />
</Frame>

Il passaggio 3 richiede una **condizione di gruppo**, la cui logica è:

* Se la variabile **user\_name** non è specificata
* O la variabile **user\_email** non è specificata
* O la variabile **user\_phone** non è specificata
* ALLORA il gruppo restituisce TRUE

Configuriamo quindi il seguente gruppo:

<Frame>
  <img src="https://mintcdn.com/innoq/9CizSgZikx55e9_4/images/supervisor-overrides-7.png?fit=max&auto=format&n=9CizSgZikx55e9_4&q=85&s=665c601f31458df94fba291f275e147f" width="750" height="409" data-path="images/supervisor-overrides-7.png" />
</Frame>

All’interno di questo gruppo, fai clic su **Add Rule** e definisci le relative condizioni:

<Frame>
  <img src="https://mintcdn.com/innoq/9CizSgZikx55e9_4/images/supervisor-overrides-8.png?fit=max&auto=format&n=9CizSgZikx55e9_4&q=85&s=43ed4567d5db432422d9d7bfed1457d2" width="750" height="668" data-path="images/supervisor-overrides-8.png" />
</Frame>

Infine, assicurati che — come descritto nel passaggio 4 — l’agente **Lead Collection** venga assegnato quando la regola viene eseguita:

<Frame>
  <img src="https://mintcdn.com/innoq/9CizSgZikx55e9_4/images/supervisor-overrides-9.png?fit=max&auto=format&n=9CizSgZikx55e9_4&q=85&s=6b5bf75e2dab378fc14e21e7ea4fdf7b" width="750" height="665" data-path="images/supervisor-overrides-9.png" />
</Frame>

Collega le tue regole tramite il menu a tre punti con l’opzione **Connect**.\
Se l’operazione è andata a buon fine, ogni regola mostrerà uno stato verde **Active**:

<Frame>
  <img src="https://mintcdn.com/innoq/9CizSgZikx55e9_4/images/supervisor-overrides-10.png?fit=max&auto=format&n=9CizSgZikx55e9_4&q=85&s=5bbc94fbe99cb57af66a3cc5952fb4ae" width="749" height="510" data-path="images/supervisor-overrides-10.png" />
</Frame>

Ora puoi testare il chatbot con questi nuovi override nella scheda **Preview**.\
Dovresti notare che il comportamento funziona come previsto.\
In modalità debug, accanto a **Active Agent** apparirà un tag **override** quando una regola di override è attiva.

<Frame>
  <img src="https://mintcdn.com/innoq/9CizSgZikx55e9_4/images/supervisor-overrides-11.png?fit=max&auto=format&n=9CizSgZikx55e9_4&q=85&s=2823eb8134158704072468ed9fb30c0e" width="1365" height="932" data-path="images/supervisor-overrides-11.png" />
</Frame>

Con gli AI Supervisor Overrides puoi creare workflow molto complessi.\
Tuttavia, poiché questa funzione controlla direttamente il funzionamento del supervisore AI, ti consigliamo vivamente di testare accuratamente la configurazione prima di utilizzarla in produzione.
