Ispezione dei flussi di lavoro agentici

Modifica online

Flow Inspector offre una visione consolidata della cronologia di esecuzione del flusso di lavoro dell'agente e consente di verificare come è stato eseguito un flusso di lavoro dall'inizio alla fine. Ogni volta che viene eseguito un flusso di lavoro, dettagli quali stato, tempistiche, ambiente, iniziatore e messaggi diagnostici vengono automaticamente acquisiti e visualizzati in un formato strutturato.

È possibile aprire l'ispettore del flusso dal generatore di flussi, dall'elenco degli strumenti o dal set di strumenti di un agente.

Controllo del flusso nel contesto degli spazi di lavoro in IBM Cloud

Solo nell'ambiente di sviluppo ( IBM Cloud ): se un flusso di lavoro è associato a un'area di lavoro, gli amministratori e i costruttori che hanno accesso a tale area di lavoro possono visualizzare le esecuzioni del flusso di lavoro nell'ispettore dei flussi.

Per ulteriori informazioni sugli spazi di lavoro, consulta la panoramica sugli spazi di lavoro.

Apri l'ispettore del flusso da Flow Builder

Aprendo l'ispettore del flusso dal generatore di flussi, vengono visualizzati contemporaneamente sia l'ispettore del flusso che il generatore di flussi. Questa vista consente di esaminare i dati di esecuzione mentre si visualizza la struttura del flusso di lavoro, senza dover cambiare vista.

Per aprire l'ispettore del flusso dal generatore di flussi:

Nel Flow Builder, clicca sull'icona situata sul lato sinistro del generatore di flussi di lavoro.

L'ispettore del flusso si apre con le istanze del flusso di lavoro relative al flusso corrente. Selezionando "Visualizza dettagli" per un'istanza del flusso di lavoro, si aprono i dettagli dell'esecuzione del flusso accanto al generatore di flussi. Attiva l'opzione "Usa sempre i dati dell'ultima esecuzione come predefiniti" per visualizzare i dettagli dell'esecuzione più recente del flusso ogni volta che si apre l'ispettore dei flussi. Questa opzione consente di accedere rapidamente ai risultati dei test recenti senza dover cercare manualmente l'esecuzione più recente.

Nei dettagli dell'esecuzione del flusso, è possibile fare clic su "Mostra nel flusso" per qualsiasi evento del flusso, in modo da aprire il nodo corrispondente nel generatore di flussi di lavoro

I dettagli del flusso aperti dal generatore di flussi non includono la scheda "Parametri del flusso".

Apri Flow Inspector dall'elenco degli strumenti o dal set di strumenti dell'agente

È possibile accedere all'ispettore del flusso dall'elenco degli strumenti o dal set di strumenti di un agente relativo a uno strumento specifico. Quando si apre l'ispettore di flusso da queste posizioni, è possibile visualizzare sia la scheda Eventi di flusso che quella Parametri di flusso.

Dal menu , seleziona " Build ".

In un ambient IBM Cloud, seleziona l'area di lavoro associata al tuo flusso di lavoro dall'elenco delle aree di lavoro.

Seleziona tutti gli strumenti.
Seleziona l'icona delle opzioni relativa allo strumento che desideri visualizzare.
Seleziona "Apri ispettore di flusso ".

Per aprire l'ispettore del flusso da un set di strumenti dell'agente:

Apri l'agente in cui è configurato lo strumento.
Seleziona la sezione "Toolset".
Seleziona l'icona delle opzioni relativa allo strumento che desideri visualizzare.
Seleziona "Apri ispettore di flusso ".

L'ispettore del flusso si apre e mostra le istanze del flusso di lavoro selezionato. Per impostazione predefinita, vengono visualizzate le istanze più recenti avviate dall'utente.

Visualizzazione dell'elenco delle esecuzioni del flusso

Quando si apre il flow inspector, viene visualizzato l'elenco delle esecuzioni del flusso di lavoro associate al flusso di lavoro selezionato. Questo elenco fornisce informazioni complete su ciascuna istanza di esecuzione, inclusi l'iniziatore, la durata, l'ambiente e il modello utilizzato durante l'esecuzione.

Ogni voce relativa all'esecuzione di un flusso di lavoro agentico include i seguenti dettagli:


Dettaglio	Descrizione
Stato di esecuzione del flusso	Indica il risultato o lo stato attuale dell'esecuzione: - Esito positivo: l'esecuzione del flusso è stata completata senza errori - Esito negativo: si è verificato un problema in una o più istanze - In esecuzione: l'esecuzione è ancora in corso - In attesa dell'utente: il flusso è in pausa fino a quando un utente non fornisce un input
Iniziato da	Identifica l'utente o il sistema che ha attivato l'esecuzione del flusso
Agente	Visualizza il nome dell'agente associato all'esecuzione
Ora di inizio	Visualizza la data e l'ora di inizio dell'esecuzione del flusso
Ambiente	Specifica dove è avvenuta l'esecuzione: ambiente di prova o ambiente live
ID istanza	Un identificatore univoco per fare riferimento e individuare l'esecuzione del flusso

Utilizzo dei filtri nell'ispettore del flusso

L'inspector Flow include una sezione filtro che consente di perfezionare l'elenco delle esecuzioni del flusso di lavoro e individuare in modo efficiente istanze specifiche. È possibile filtrare le esecuzioni del flusso di lavoro in base a ora, stato, ambiente, agente o iniziatore. Per cercare un'istanza specifica, inserisci l 'ID dell'istanza nel campo di ricerca.

È possibile ridurre grandi insiemi di risultati applicando uno o più dei seguenti filtri:


Tipo di filtro	Descrizione
Intervallo di tempo	Seleziona un intervallo predefinito, ad esempio ultima ora, ultime 6 ore, ultimo giorno o ultima settimana. È anche possibile scegliere un intervallo personalizzato inserendo la data di inizio, la data di fine e gli orari.
Stato del flusso	Filtra le esecuzioni del flusso di lavoro in base allo stato di esecuzione: in attesa dell'utente, in esecuzione, completata o non riuscita.
Ambiente	Il display funziona per ambienti specifici, come bozze o live.
Agente	Filtra le esecuzioni associate a uno o più agenti selezionati.
Iniziatore	Filtra le esecuzioni avviate dagli utenti selezionati.

Dopo aver selezionato i criteri di filtro, seleziona Applica filtri per visualizzare le esecuzioni del flusso di lavoro filtrate.

Per cancellare tutte le selezioni, seleziona Cancella filtri.

Visualizzazione dei dettagli dell'esecuzione del flusso

Selezionando un'esecuzione del flusso di lavoro si apre una vista dettagliata di quella specifica istanza. Riassume l'iniziatore, le informazioni sull'agente, l'ambiente di esecuzione, la durata dell'esecuzione e qualsiasi modello utilizzato durante l'esecuzione. Ogni scheda di dettaglio include un collegamento diretto al generatore di flussi di lavoro, in modo da poter accedere al nodo corrispondente.

L'intestazione dei dettagli dell'esecuzione del flusso include azioni che consentono di aggiornare, rivedere, esportare o condividere le informazioni relative all'esecuzione del flusso di lavoro. Queste azioni consentono di lavorare in modo efficiente con le informazioni relative all'esecuzione del flusso di lavoro e supportano sia scenari di revisione collaborativa che tecnica.

Le seguenti azioni sono disponibili nell'intestazione dei dettagli dell'esecuzione del flusso:


Azione	Descrizione
Condividi	Copia un link all'esecuzione del flusso di lavoro che puoi condividere con gli utenti che dispongono delle autorizzazioni appropriate. La funzione supporta la collaborazione durante la revisione e la convalida del flusso di lavoro.
Copia payload JSON	Copia la rappresentazione JSON completa dell'esecuzione del flusso di lavoro, inclusi input, output, variabili di flusso e metadati. Il payload JSON è utile per l'auditing, il debug, l'esportazione dei dati di esecuzione o l'inclusione delle informazioni di esecuzione nei casi di assistenza.
Visualizza il riepilogo AI	Apre un riepilogo generato dall'intelligenza artificiale dell'esecuzione del flusso di lavoro. Il riepilogo evidenzia gli eventi chiave, le azioni principali eseguite durante l'esecuzione del flusso di lavoro e eventuali problemi rilevati. Il riassunto generato dall'intelligenza artificiale fornisce una panoramica del comportamento del flusso senza richiedere la revisione di ogni singola fase.

Gestione dei dettagli dell'esecuzione del flusso

I dettagli dell'esecuzione del flusso comprendono due sezioni:

Eventi di flusso, che mostrano la sequenza di azioni intraprese durante l'esecuzione.
Parametri di flusso, che visualizzano i dati utilizzati dal flusso di lavoro.

Eventi di flusso

Gli eventi di flusso mostrano un riepilogo di ogni azione che si è verificata durante l'esecuzione del flusso di lavoro. Quando selezioni un evento nell'elenco degli eventi di flusso, la sezione dei dettagli mostra le informazioni relative a quel nodo specifico. L'evento include:

Nome nodo
Tipo dell'evento
Durata runtime
Opzione per aprire il nodo nel generatore di flussi di lavoro per visualizzarne o aggiornarne la configurazione
Stato di esecuzione corrente
Messaggio di errore con un collegamento diretto all'evento associato al guasto
Parametri utilizzati dal nodo

Queste informazioni consentono di monitorare il flusso di esecuzione, convalidare il comportamento previsto e identificare i punti in cui il flusso si è interrotto o ha generato un errore.

Parametri del flusso

Visualizza gli input, gli output e le variabili di flusso forniti al flusso di lavoro. La revisione dei parametri di flusso consente di confermare che i dati sono stati elaborati come previsto.

Per aprire i dettagli dell'esecuzione del flusso:

Dall'elenco delle esecuzioni del flusso, seleziona Visualizza dettagli per l'esecuzione del flusso che desideri controllare.
Dalla finestra dei dettagli dell'esecuzione del flusso:
- Passa dagli eventi di flusso ai parametri di flusso per esaminare l'esecuzione del flusso e i dati utilizzati nel flusso di lavoro.
- Selezionare Eventi di flusso per rivedere la sequenza di azioni nell'esecuzione del flusso di lavoro.
- Fai clic su Apri nel generatore di flussi per aprire il flusso di lavoro in una scheda separata del browser. Il flusso di lavoro si apre con informazioni dettagliate, comprese le modalità di configurazione di ciascun nodo. Se necessario, è possibile aggiornare il flusso.

Dopo aver aggiornato il flusso, esegui nuovamente il flusso di lavoro per generare una nuova istanza del flusso di lavoro con le modifiche applicate.