Risoluzione dei problemi
Un'esecuzione non riuscita
Come trovare un’esecuzione non riuscita nella Cronologia, leggerne l’errore e risolvere le cause più comuni.
Un’esecuzione non riesce quando un passaggio non può essere completato: uno strumento restituisce un errore, un’app non è connessa, il workspace non ha crediti oppure il piano non consente un passaggio. Ogni esecuzione viene salvata, così puoi leggere cosa è successo in un secondo momento.
Sintomi#
- L’agente si ferma a metà oppure fornisce una risposta vuota o generica.
- Un workflow termina in anticipo, oppure una riga di un batch mostra Non riuscito.
- Un’esecuzione pianificata non ha fatto nulla.
- Dopo aver fatto clic su pubblica vedi un banner di errore, ad esempio “Convalida non riuscita. Correggi gli errori evidenziati nei componenti.”
Trovare l’esecuzione nella Cronologia#
- Fai clic su Cronologia nella barra laterale.
- Attiva il filtro Messaggi di errore per elencare solo le sessioni che contengono un errore. Puoi anche filtrare per Agente o workflow e per chatbot.
- Apri una sessione. Usa Semplice o Dettagliato per cambiare il livello di dettaglio visualizzato.
- Scorri gli eventi. Sono etichettati come Messaggio utente, Output del chatbot, Messaggio di sistema, Hook della chat, Chiamata strumento e Query dell’agente. Tra gli eventi Chiamata strumento cerca quello che segnala l’errore.
Il pannello delle metriche sopra la tabella (Mostra metriche) mostra l’andamento di Errori totali nel tempo. Il tuo piano limita quanto indietro può risalire la cronologia. Vedi piani e limiti. Per le esecuzioni in batch, la tabella ha le colonne Stato e Errore, e Riesegui non riuscite o Riprova riga eseguono di nuovo le righe non riuscite.
Errori comuni e soluzioni#
| Cosa vedi | Causa | Soluzione |
|---|---|---|
| “Crediti insufficienti per eseguire questa azione. Ricarica i tuoi crediti.” | Il saldo è a zero | Crediti esauriti |
| “Limite di credito del workspace raggiunto” | Un limite di spesa del workspace | Aumentalo in Impostazioni → Crediti |
| “NAME non è configurato. Configura prima l’integrazione.” | Il passaggio richiede un’app non connessa | Connettila in Integrazioni |
| “…è connesso ma mancano i permessi richiesti. Riconnetti l’integrazione e concedi i permessi aggiuntivi.” | Alla connessione manca un permesso | Riconnetti e accetta tutti i permessi |
| “…richiede una nuova autorizzazione. Il token di aggiornamento è scaduto o revocato. Riconnetti l’integrazione.” | L’accesso è scaduto o è stato revocato | Riconnetti l’account |
| “Il componente NAME può essere usato solo con il piano …” | Il passaggio non è incluso nel tuo piano | Sostituisci il passaggio oppure esegui l’upgrade |
| “Limite consentito di … raggiunto. Esegui l’upgrade del tuo piano.” | Hai raggiunto il limite del piano mentre creavi qualcosa | Rimuovine uno oppure esegui l’upgrade |
| “Convalida non riuscita. Correggi gli errori evidenziati nei componenti.” | A un passaggio mancano impostazioni obbligatorie | Correggi i passaggi evidenziati, poi pubblica di nuovo |
Esecuzioni pianificate#
Se il workspace esaurisce i crediti, il sistema disattiva la pianificazione invece di riprovare all’infinito. Aprila e riattivala quando hai di nuovo crediti. Vedi pianificazioni.
Risolvere il problema#
- Trova la sessione non riuscita e copia l’errore esatto.
- Confrontalo con la tabella, applica la soluzione e riesegui lo stesso input.
- Se l’errore proviene da un servizio esterno e non riesci a capirne il motivo, prova il passaggio da solo dalla canvas. Vedi test e log di esecuzione.
Scopri quanto è costata un'esecuzione
Controlla Transazioni se non sei sicuro di quanto ha consumato un’esecuzione. Ogni addebito è elencato con il suo tipo e contesto. Vedi crediti.