Intenti e addestramento NLP
Questa pagina descrive la configurazione del motore NLP interno del chatbot: creazione degli intenti, addestramento supervisionato e gestione delle frasi non riconosciute. Riguarda i chatbot che utilizzano il motore di classificazione interno, non la modalità Askme AI.
Le tab Intenti e Addestramento sono visibili solo quando la modalità Askme AI del chatbot è disattivata. Con la modalità Askme AI attiva, la classificazione delle richieste è gestita dall'agente collegato.
Prerequisiti
- Un chatbot creato con la modalità Askme AI disattivata (vedi Creare e configurare un chatbot).
Creare un intento
Un intento rappresenta un'intenzione dell'utente che il bot deve riconoscere (ad esempio "richiedi orari" o "richiedi assistenza"). Al primo inserimento è disponibile un set di intenti predefiniti come punto di partenza. Ogni intento si configura in un dialogo a più sezioni:
- Informazioni — nome univoco dell'intento, descrizione (usata solo se in futuro si attiva la modalità Askme AI, per aiutare l'agente a comprendere il contesto), stato attivo, ed eventuali azioni automatiche: passaggio a operatore, chiusura chat o chiusura del widget, tra loro mutuamente esclusive per chiusura e passaggio a operatore;
- Frasi d'esempio — le frasi, per lingua, che alimentano l'addestramento del classificatore per questo intento;
- Risposte — il testo di risposta per ciascuna lingua, con editor di testo ricco.

Webhook per intento
Per un singolo intento è possibile collegare un webhook verso un servizio esterno: quando l'intento viene riconosciuto, la risposta viene generata dal servizio esterno anziché dal testo configurato. Il testo di risposta configurato nell'intento resta disponibile come risposta di riserva in caso di errore del webhook.
Addestrare il bot
Il pannello Addestramento consente di testare in tempo reale il riconoscimento delle frasi: si digita una frase di prova e il sistema restituisce l'intento riconosciuto, la lingua rilevata e la percentuale di accuratezza calcolata dal motore di classificazione (Naive Bayes). Se il risultato non è corretto, è possibile correggere l'intento assegnato e approvare la frase, aggiungendola al set di addestramento.

Il pannello di addestramento è disabilitato quando è attivo un webhook globale sul bot: in quel caso la classificazione locale non viene utilizzata.
Le modifiche agli intenti (nuove frasi, nuovi intenti) richiedono un nuovo addestramento esplicito prima di essere effettive nelle conversazioni reali: il pulsante "Addestra" nella tab Informazioni generali del bot avvia il processo.
Soglia di accuratezza
È possibile impostare una soglia minima di accuratezza al di sotto della quale una frase non viene considerata correttamente classificata e viene invece indirizzata al messaggio di fallback. Una soglia più alta riduce le risposte errate ma aumenta i casi di fallback; una soglia più bassa fa l'opposto.
Rivedere le frasi non classificate
Le frasi realmente scritte dagli utenti durante le conversazioni che non hanno trovato una corrispondenza sufficientemente accurata vengono raccolte in un elenco dedicato di frasi non classificate. Da qui è possibile assegnare ciascuna frase all'intento corretto (arricchendo così l'addestramento) oppure scartarla. Questa revisione periodica è il meccanismo principale per migliorare l'accuratezza del bot nel tempo.
Lingue supportate
Il rilevamento automatico della lingua della frase copre un ampio numero di lingue.
L'estrazione automatica di date e orari dalle frasi (ad esempio "domani alle 15") è supportata solo per la lingua italiana; nelle altre lingue questo riconoscimento non è disponibile.
Risultato atteso
Dopo l'addestramento, le frasi di prova coerenti con gli intenti configurati vengono riconosciute con un'accuratezza superiore alla soglia impostata e ricevono la risposta corretta.
Problemi comuni
| Problema | Causa probabile | Soluzione |
|---|---|---|
| Il bot risponde sempre con il fallback | Addestramento non eseguito dopo l'aggiunta di intenti o frasi | Eseguire l'addestramento dal pannello dedicato |
| Le tab Intenti e Addestramento non sono visibili | Modalità Askme AI attiva sul bot | Disattivare la modalità Askme AI oppure gestire l'intent detection dall'agente, vedi Modalità Askme AI |
| Il pannello di addestramento è disabilitato | Webhook globale attivo sul bot | Disattivare il webhook oppure gestire la classificazione lato servizio esterno |
| Frasi con data/ora non riconosciute correttamente | Lingua diversa dall'italiano | Comportamento atteso: l'estrazione di date/orari è disponibile solo in italiano |