Live Monitoring e Replay - Debug delle Esecuzioni Agentic Flow in ConvyAI
Overview
L'Agentic Designer offre due modalità per osservare l'esecuzione di un Agentic Flow sul canvas:
- Live monitoring - avvia una run manuale direttamente dal canvas e osserva l'esecuzione di ogni nodo in tempo reale, oppure aggancia una run già in corso dalla pagina Monitoring.
- Replay storico - riesamina qualsiasi run completato come animazione, con pieno controllo sulla posizione di riproduzione.
Entrambe le modalità portano il canvas in sola lettura e visualizzano il percorso di esecuzione, ma differiscono nel punto di ingresso e nel ciclo di vita della sessione.
Live monitoring
La run manuale ti permette di avviare l'esecuzione di un Agentic Flow direttamente dal canvas e seguirla in tempo reale, senza dover consultare lo storico a posteriori. È utile quando vuoi un feedback immediato durante lo sviluppo - ad esempio per verificare il comportamento di un'integrazione appena configurata, o per vedere fino a quale nodo arriva il flusso con un determinato input.
Avviare una run
Per avviare una run manuale, clicca l'azione di avvio su qualsiasi nodo di tipo trigger nel canvas. Il canvas transisce immediatamente in modalità debug live - durante l'inizializzazione è visibile uno stato intermedio.
Prima di procedere devono essere soddisfatte due condizioni: il flusso deve essere salvato senza modifiche in sospeso, e non deve essere in stato di Lock (quando bloccato, i tasti di avvio sui trigger sono nascosti). Se una run manuale è già attiva sullo stesso flusso, i tasti di avvio rimangono disabilitati fino al termine.
Agganciarsi da Monitoring
Puoi anche unirti a un'esecuzione già in corso, senza doverla avviare tu stesso. Nella pagina Monitoring, ogni run che non ha ancora raggiunto uno stato finale espone un'azione per aprirla in modalità debug live. Questo funziona indipendentemente da chi o cosa ha avviato la run, e anche se il flusso è momentaneamente bloccato in editing da un altro utente - l'aggancio in sola osservazione non è impedito da tale lock.
Seguire l'esecuzione
Non appena la run è attiva, il canvas diventa una vista live di ciò che sta accadendo all'interno del flusso. I nodi si illuminano man mano che vengono raggiunti: il nodo attualmente in esecuzione mostra una progress bar che indica che è in corso, mentre i nodi già completati e quelli non ancora raggiunti hanno aspetti visivi distinti. Ogni ramo percorso si anima in tempo reale al momento dell'attraversamento.
Quando ti agganci a una run già in corso da Monitoring, il canvas ricostruisce immediatamente lo stato di tutti i nodi eseguiti prima del tuo aggancio, per poi proseguire live da quel punto.
Il floating menu si adatta allo stato live: i controlli di modifica scompaiono e una progress bar continua anima il menu per tutta la durata della run. In qualsiasi momento puoi cliccare Info per aprire il pannello di dettaglio della run e ispezionarne i metadati - i campi non ancora valorizzati mostrano un trattino.
Arrestare una run
Se hai bisogno di interrompere l'esecuzione prima che si concluda naturalmente, clicca Stop nel floating menu. La run termina immediatamente e il canvas entra nello stato post-run. Stop è disponibile a chiunque sia agganciato alla run, non solo a chi l'ha avviata.
Più utenti possono agganciarsi contemporaneamente alla stessa run, sia che sia stata avviata manualmente dal canvas sia che sia stata agganciata da Monitoring. Ogni utente ha una vista live indipendente della stessa esecuzione.
Ispezionare il risultato
Quando la run termina - in modo naturale o dopo uno Stop manuale - il canvas entra in uno stato post-run. Un banner persistente mostra l'esito finale e il timestamp di completamento. Tutti i nodi sono ora colorati in base a come si è conclusa l'esecuzione di ognuno, e ogni nodo eseguito riporta il tempo impiegato. Il canvas rimane in sola lettura fino a quando non esci esplicitamente.
Da questo stato hai due possibilità: clicca Replay per rivedere l'animazione dell'esecuzione dall'inizio (al termine il canvas torna qui), oppure clicca Esci dal debug per tornare alla modifica normale.
Errori durante l'esecuzione
Quando un nodo termina con errore, viene evidenziato immediatamente sul canvas con un indicatore visivo. Passando il cursore sull'indicatore si vede il messaggio di errore in un tooltip. L'esecuzione prosegue o si interrompe in base alla logica di error handling definita nel flusso.
Navigare fuori dal canvas
Se tenti di uscire dalla pagina mentre una run è attiva, un alert di conferma ti avvisa che l'esecuzione continuerà in background e che non potrai tornare alla visualizzazione live di questa run. Anche il refresh della pagina con una run attiva mostra un alert, dandoti la possibilità di annullare.
Replay storico
Il Replay è accessibile sia al ruolo agenticorchestrator_admin che al ruolo agenticorchestrator_user.
Avviare un replay
Apri il dettaglio di un'esecuzione dalla pagina Monitoring e clicca Replay. Il canvas si apre in modalità sola lettura con il flusso centrato e adattato automaticamente alla finestra.
Dalla barra di controllo puoi avanzare passo dopo passo oppure saltare direttamente alla fine dell'esecuzione. La barra di scorrimento ti permette di spostarti liberamente nella timeline del run.
Per riprendere la modifica del flusso, esci dalla modalità replay con Fine.
Cosa vedi sul canvas
I nodi eseguiti si evidenziano nell'ordine di attraversamento. I nodi completati con successo sono visivamente distinti da quelli terminati con errore. Se l'esecuzione si è interrotta per un errore, il replay si ferma nello stesso punto e il nodo problematico viene evidenziato immediatamente.
Ogni nodo eseguito mostra il tempo impiegato durante quel run.
Cliccando su un nodo eseguito si apre il pannello di dettaglio con input, output ed eventuali informazioni di errore registrati per quella specifica esecuzione.
Dettagli dell'esecuzione
Dalla modale dei dettagli puoi consultare i metadati del run e copiare l'ID di esecuzione negli appunti.
Argomenti correlati
- Monitoring - visualizza l'elenco delle esecuzioni e accedi ai singoli run