Risolvere i problemi di configurazione dei bot
SI APPLICA A: SDK v4
Un bot può generare diversi tipi di errori, come l'impossibilità di rispondere, la restituzione di errori o il funzionamento in un canale ma non in un altro. Il primo passaggio per la risoluzione dei problemi di un bot consiste nel testarlo in Web Chat. In questo modo sarà possibile determinare se il problema è riconducibile al bot (il bot non funziona in qualsiasi canale) o a un determinato canale (il bot funziona in alcuni canali ma non in altri).
Testare nella chat Web
- Aprire la risorsa bot nel portale di Azure.
- Aprire il riquadro Test in Web Chat (Esegui test in Web Chat).
- Inviare un messaggio al bot.
Se il bot non risponde con l'output previsto, passare a Bot non funziona in chat Web. In caso contrario, passare a Il bot funziona in Web Chat ma non in altri canali.
Il bot non funziona in chat Web
Esistono molti motivi per cui un bot non funziona. Molto probabilmente, l'applicazione bot è inattiva e non può ricevere messaggi o il bot riceve i messaggi, ma non risponde. Ecco alcune delle possibili cause:
- Il bot è inattivo e non può essere raggiunto.
- Il bot si è arrestato in modo anomalo.
- L'endpoint del bot non è corretto.
- Il bot riceve correttamente i messaggi, ma non può rispondere.
Per verificare se il bot è in esecuzione:
- Aprire il riquadro Panoramica.
- Copiare il valore dell'endpoint di messaggistica e incollarlo nel browser.
Se l'endpoint restituisce l'errore HTTP 404 o 405, significa che il bot è raggiungibile ed è in grado di rispondere ai messaggi. Per esaminare i problemi di timeout, vedere gli articoli relativi al timeout e alla risoluzione degli errori HTTP 5xx.
Se l'endpoint restituisce un errore di tipo "il sito non è raggiungibile" o "la pagina non è raggiungibile", il bot è inattivo ed è necessario ridistribuirlo.
Il bot funziona in Web Chat ma non in altri canali
Se il bot funziona come previsto in Web Chat ma non in altri canali, le possibili cause sono:
Problemi di configurazione del canale
È possibile che i parametri di configurazione del canale, come il nome utente e la password del bot, siano stati impostati in modo errato o che siano stati modificati esternamente. Ad esempio, un bot è stato configurato con il canale Facebook per una determinata pagina e la pagina è stata eliminata in un secondo momento. La soluzione più semplice consiste nel rimuovere il canale e ripetere la configurazione del canale di nuovo.
Per un elenco di canali supportati e istruzioni su come configurare ognuno di essi, vedere l'elenco Canali in Connessione un bot ai canali.
Comportamento specifico del canale
L'implementazione di alcune funzionalità può variare a seconda del canale. Ad esempio, non tutti i canali supportano le schede adattive. La maggior parte dei canali supporta azioni (pulsanti), ma viene eseguito il rendering in modo specifico del canale. Se si notano differenze nella modalità di funzionamento dei tipi di messaggio nei diversi canali, vedere l'articolo Informazioni di riferimento sui canali.
Di seguito sono riportati i collegamenti che possono essere utili per i singoli canali:
- Add bots to Microsoft Teams apps (Aggiungere bot ad app Microsoft Teams)
- Facebook: Introduzione alla piattaforma Messenger
- Skype for Developers (Skype per sviluppatori)
- Slack: abilitazione delle interazioni con i bot
Interruzione del servizio per i canali
In alcuni casi potrebbero verificarsi interruzioni del servizio per alcuni canali. In genere, tali interruzioni sono di breve durata. Se però si ritiene che si sia verificata un'interruzione del servizio, visitare il sito Web o i social media del canale.
Un altro modo per determinare se si è verificata un'interruzione del servizio per un canale consiste nel creare un bot di test (ad esempio un semplice Echo Bot) e aggiungere un canale. Se il bot di test funziona con alcuni canali ma non con altri, il problema non si trova nel bot di produzione.
Informazioni aggiuntive
Vedere come eseguire il debug di un bot e gli altri articoli sul debug in tale sezione.