Risoluzione dei problemi
L'agente non risponde
Cosa controllare quando un agente o un chatbot resta in silenzio, mostra un messaggio di errore o dà una risposta generica.
Un agente può non rispondere nella chat di test del builder, in un chatbot sul tuo sito o tramite l’API. La causa è quasi sempre una delle verifiche elencate di seguito. Segui la lista dall’alto verso il basso, perché le prime sono le più comuni e le più rapide da escludere.
Sintomi#
- Invii un messaggio e non ricevi nulla in risposta.
- La chat mostra un errore invece di una risposta.
- Un visitatore del chatbot vede “Oops! Something went wrong. Please contact website owner!”
Cause probabili, in ordine#
1. Il workspace ha esaurito i crediti#
Gli agenti non possono funzionare senza crediti. Cerca l’avviso Read-only mode e controlla il valore dei crediti in fondo alla barra laterale. Chi chiama l’API riceve “Insufficient credits to perform this action. Please recharge your credits.” I visitatori del chatbot vedono “Sorry, you’ve reached your payment limit.” Vedi crediti esauriti.
2. L’abbonamento è terminato o il workspace è in sola lettura#
Se il piano è stato annullato, il workspace è inattivo e le esecuzioni vengono rifiutate con “This workspace is inactive because its subscription ended.” Solo il proprietario può scegliere di nuovo un piano.
3. Un’app necessaria all’agente non è connessa#
Se uno strumento richiede un account che non hai connesso, vedi un avviso come “Slack integration is required, but was not found” o “Component is not integrated”, e un’esecuzione che raggiunge quello strumento fallisce con “is not configured. Please set up the integration first.” Apri Integrations e connettila. Vedi integrazione disconnessa.
4. La memoria è attiva senza una categoria#
Nel builder dell’agente, Memory richiede una categoria. Il builder avvisa “Pick a category, or turn Memory off. The agent refuses to run while Memory is on with none picked.” Scegli una categoria sotto Advanced, oppure disattiva la memoria. Vedi memoria e cronologia chat.
5. Le tue modifiche sono salvate ma non pubblicate#
Le modifiche vengono salvate come bozza. Le persone che usano l’agente live, incluso un chatbot sul tuo sito, vedono l’ultima versione pubblicata finché non fai clic su Publish changes. Un trigger mostra “Publish to activate” finché non lo fai. Vedi condividi e pubblica.
6. Il chatbot è disattivato o soggetto a limiti di frequenza#
In Chatbots, apri il chatbot e controlla che Chatbot enabled sia attivo. I visitatori che inviano troppi messaggi vedono “Too many requests. Please try again later or sign in to continue.” I limiti si trovano sotto Rate Limiting nelle impostazioni del chatbot.
7. Un passaggio o uno strumento ha fallito#
Uno strumento o un passaggio nell’agente può fallire anche quando il modello stesso funziona. Apri History, trova la sessione, attiva il filtro Error messages e leggi l’evento che ha fallito. Vedi un’esecuzione non riuscita.
Risolvi il problema#
- Invia un breve messaggio di test nella chat del builder e annota il testo esatto di qualsiasi errore.
- Confronta quel testo con la lista qui sopra e applica la correzione.
- Pubblica se hai modificato qualcosa, poi riprova dal punto in cui si è verificato il problema, ad esempio il tuo sito.
Testa dove si è verificato l'errore
Riproduci il problema nello stesso punto in cui i tuoi utenti lo riscontrano, che si tratti della chat di test, di un chatbot sul tuo sito o di una chiamata API. Ognuno ha le proprie impostazioni, e un chatbot ha anche i propri limiti di frequenza.