Flow Report - Analizza un Singolo Agentic Flow in ConvyAI
Overview
La pagina Flow Report mostra la stessa analisi della Dashboard, limitata a un solo Agentic Flow. Usala per capire come si comporta un singolo flusso: se si completa, quanto impiega, quanti token consuma, quali esiti produce e quali nodi falliscono.
Puoi aprirla:
- dalla pagina Agentic Flows, con il pulsante Report di un flusso, che apre il report su quel flusso;
- dalla Dashboard, nel riquadro Executions by flow: usa l'azione Flow Report di una riga per aprire la pagina su quel flusso, oppure il link Flow Report in fondo al riquadro per aprire la pagina e scegliere il flusso da lì.
La pagina è disponibile sui tenant con il modulo Agentic Orchestrator abilitato, ai ruoli che accedono alla Dashboard: agenticorchestrator_admin, agenticorchestrator_user e i livelli utente superiori. Il link Back to Dashboard riporta alla Dashboard.
Seleziona un flusso
Usa il selettore in alto nella pagina per scegliere il flusso. Elenca i flussi che hanno almeno un'esecuzione, compresi quelli rinominati o cancellati, e ne mostra il nome più recente. Se apri la pagina senza un flusso, il selettore riporta Select a flow e i riquadri restano vuoti finché non ne scegli uno.
Cambiando flusso i riquadri si ricaricano sul nuovo flusso. Il periodo non cambia. Flusso e periodo scelti restano dopo il refresh della pagina e si perdono alla chiusura della scheda del browser.
Zona Active
La zona Active mostra i riquadri In progress e Waiting del flusso selezionato, con lo stesso significato della Dashboard, comprese le fasce di tempo di attesa. Si aggiorna ogni minuto.
Zona Trends
La zona Trends analizza le esecuzioni del flusso selezionato terminate nel periodo scelto.
Il selettore del periodo funziona come nella Dashboard: stessi preset, stesso default (Last 7 days), stesso confronto con il periodo precedente, stesso refresh. Vedi Scegli il periodo. Il periodo è condiviso con la Dashboard: se lo cambi qui, lo trovi cambiato anche lì, e viceversa.
Executions, Completion rate e Duration
Questi riquadri mostrano gli stessi numeri della Dashboard, per il flusso selezionato. Vedi Leggi i riquadri per come leggerli e Cosa significano p50 e p95 per i percentili.
| Riquadro | Cosa mostra | Delta |
|---|---|---|
| Executions | Esecuzioni del flusso terminate nel periodo. | Solo direzione e dimensione. |
| Completion rate | Percentuale di esecuzioni completate. | Punti percentuali. Favorevole se aumenta. |
| Duration | Durata mediana (p50) delle esecuzioni completate, con sotto il p95. | Sul p50. Favorevole se diminuisce. |
La suddivisione tra errori e interruzioni è nella card Technical outcome.
Tokens per execution
Media dei token Input, Output e Thinking per esecuzione del flusso, con delta, p95 e totale del periodo, come descritto nella Dashboard. Se nel periodo il flusso non ha eseguito nessun nodo AI Agent, il riquadro mostra No AI Agent executions in this period.
Executions over time
Un grafico a barre impilate delle esecuzioni del flusso terminate in ogni intervallo, divise in Completed, Errors e Stopped. Passa il mouse su una barra per vedere l'intervallo e i numeri. Clicca una barra per aprire il Monitoring sulle esecuzioni del flusso terminate in quell'intervallo, oppure clicca un segmento per filtrare anche sull'esito corrispondente.
Technical outcome
Un grafico a torta di come sono terminate le esecuzioni del flusso: Completed, Errors o Stopped. La legenda e il tooltip mostrano, per ogni fetta, il numero di esecuzioni e la percentuale sul totale. Lo stop è un'interruzione volontaria e non conta come errore.
Se nel periodo non è terminata nessuna esecuzione, la card mostra No executions ended in this period. Clicca una fetta o la sua voce in legenda per aprire il Monitoring sulle esecuzioni del flusso con quell'esito nel periodo selezionato.
Results
Mostra cosa ha dichiarato il flusso tramite i suoi nodi Result, cioè come si sono conclusi i tuoi processi secondo i valori che hai definito. In testa compaiono tre numeri:
| Numero | Significato |
|---|---|
| Executions | Esecuzioni del flusso terminate nel periodo. |
| Outcomes emitted | Totale degli esiti emessi dai nodi Result nel periodo. |
| Ended without outcome | Esecuzioni terminate senza aver emesso alcun esito. |
Un'esecuzione può emettere più esiti, anche lo stesso valore più volte, quindi Outcomes emitted può essere maggiore di Executions. I tre numeri non vanno sommati.
Sotto i numeri, un elenco a barre mostra i valori emessi, dal più frequente, con il numero di esiti e la percentuale su Outcomes emitted. Ogni riga mostra anche il valore dello stesso esito nel periodo precedente, senza freccia né delta: la piattaforma non conosce il significato di business dei tuoi valori, quindi non ti dice se una variazione è positiva o negativa. I valori compaiono esattamente come li hai scritti nel nodo Result.
L'elenco mostra i 5 valori più frequenti. Tutti gli altri sono raggruppati in Other values. Contano tutte le esecuzioni terminate, qualunque sia lo stato finale, perché un esito emesso prima di un errore o di un'interruzione resta valido. Le righe non sono cliccabili.
Errors by node
Mostra dove si concentrano gli errori del flusso. Tre card mostrano i tre nodi con più errori nel periodo, dal maggiore. Ogni card mostra:
- nome e tipo del nodo, per esempio HTTP Request;
- gli errori del nodo nel periodo e nel periodo precedente;
- il delta, come variazione percentuale: favorevole se gli errori diminuiscono, sfavorevole se aumentano;
- due sparkline con gli errori nel tempo: continua per il periodo corrente, tratteggiata per il precedente.
Ogni sparkline ha una scala propria: leggila per vedere l'andamento del nodo e confronta i nodi usando il numero di errori.
Sotto le card, Other nodes riassume gli errori dei nodi restanti, Not attributed gli errori senza un nodo associato (mostrato solo se maggiore di zero) e viene riportato il totale degli errori del periodo.
Argomenti correlati
- Dashboard - vista del tenant su esecuzioni attive e trend
- Monitoring - elenca, filtra e ispeziona le singole esecuzioni
- Nodo Result - definisci l'esito di processo di un'esecuzione