Gestire i workflow basati su agenti

La pagina utente Gestisci workflow consente di gestire e visualizzare le informazioni sui workflow agentici di Conversational Analytics attivi e inattivi che hai creato o per i quali sei stato aggiunto come destinatario.

Per andare alla pagina utente Gestisci workflow, seleziona il menu Profilo e poi Workflow. Questa pagina viene visualizzata nel menu del profilo solo se un amministratore di Looker ti ha concesso le autorizzazioni create_alerts e see_alerts.

Informazioni sul workflow

La pagina utente Gestisci workflow fornisce informazioni sui workflow di tua proprietà o per i quali sei elencato come destinatario:

Colonna Definizione
Nome workflow Il titolo del workflow, impostato dall'agente all'avvio del workflow. L'agente genera un titolo del workflow predefinito in base ai contenuti della conversazione. Fai clic sul nome del workflow per aprire la pagina Dettagli del workflow.
Proprietario Il nome dell'utente che ha creato il flusso di lavoro.
Tempo di esecuzione medio La durata della query del flusso di lavoro in secondi.
Condizione soddisfatta Un Sì o un No che indica se le condizioni del workflow sono state soddisfatte l'ultima volta che è stata eseguita la query del workflow. Viene visualizzato il simbolo -- se la query del workflow non è ancora stata eseguita o se è stata eseguita, ma non è stato possibile determinare se le condizioni del workflow sono state soddisfatte. Questa colonna mostra le icone di avviso o di errore relative a eventuali avvisi o errori visualizzati quando viene eseguita la query del flusso di lavoro o viene inviata la notifica del flusso di lavoro. Passa il puntatore sopra l'icona di avviso o errore per visualizzare il messaggio di errore associato, se applicabile.

Un'icona di avviso con un avviso di flusso di lavoro obsoleto indica che i dati nel riquadro della dashboard non sono cambiati tra le due query del flusso di lavoro più recenti. Scopri di più su questo messaggio nella sezione Messaggi di errore e avviso relativi agli avvisi di questa pagina.
Frequenza La frequenza con cui viene eseguito il flusso di lavoro per verificare se le condizioni sono state soddisfatte o superate.
Stato Questa colonna indica se il flusso di lavoro è attivo o disattivato.

Un flusso di lavoro viene contrassegnato come Disattivato quando un utente disattiva il proprio flusso di lavoro dalla pagina utente o quando un amministratore di Looker lo disattiva. Se disabiliti il flusso di lavoro, le notifiche verranno messe in pausa per tutti i destinatari del flusso di lavoro.
Attività Un link che ti indirizza alla pagina Attività del flusso di lavoro.
Menu Opzioni Un menu da cui puoi eseguire azioni aggiuntive sul workflow. Scopri di più nella sezione Opzioni di gestione del workflow di questa pagina.

Gestisci i workflow per l'istanza di Looker

La gestione del flusso di lavoro può comportare le seguenti attività:

In linea con ogni flusso di lavoro è presente un menu Opzioni con le seguenti selezioni:

  • Visualizza flusso di lavoro
  • Modifica workflow
  • Disabilita workflow (se il workflow è attivo)
  • Abilita workflow (se il workflow è disabilitato)

Fai clic su Visualizza workflow per aprire la pagina Dettagli.

Fai clic su Modifica flusso di lavoro per aprire e modificare le impostazioni del flusso di lavoro. Fai clic su Salva flusso di lavoro per salvare le modifiche oppure su Annulla per chiudere la finestra di modifica senza salvare.

Gestire lo stato di un workflow

Anche se non puoi eliminare definitivamente un workflow, puoi controllare se è attivo. Quando lo Stato di un workflow è Attivo, la query del workflow continua a essere eseguita in base alla frequenza specificata nel workflow per verificare se le condizioni sono state soddisfatte. Se le condizioni sono state soddisfatte, i destinatari del flusso di lavoro vengono avvisati con il metodo di notifica specificato nel flusso di lavoro. Quando lo Stato di un workflow è Disattivato, non viene eseguita alcuna query del workflow e non vengono inviate notifiche. La pagina Dettagli di un workflow disattivato non mostra risultati nella visualizzazione del workflow.

In alcune circostanze, il proprietario di un flusso di lavoro o l'amministratore di Looker potrebbe dover disattivare manualmente un flusso di lavoro, ad esempio:

  • Mettere temporaneamente in pausa le notifiche del flusso di lavoro per riconfigurare le condizioni del flusso di lavoro
  • Risoluzione dei problemi relativi a messaggi di errore o avvisi
  • Risoluzione degli errori di recapito delle notifiche

Per disattivare un flusso di lavoro:

  1. Nella pagina utente Gestisci workflow, individua il workflow da disattivare.
  2. Seleziona il menu Opzioni del flusso di lavoro.
  3. Seleziona Disattiva workflow.

Puoi riattivare il flusso di lavoro in qualsiasi momento seguendo questi passaggi e selezionando Attiva flusso di lavoro.

Visualizzare i dettagli del workflow

La pagina Dettagli è una finestra di dialogo che mostra un riepilogo delle informazioni sul workflow che puoi visualizzare per vedere le seguenti informazioni:

  • Contesto sulle condizioni che attivano il workflow o sul significato dell'attivazione del workflow.
  • Una visualizzazione dei risultati della query del workflow.
  • Il menu Altro nella visualizzazione del workflow, che include l'opzione Esplora da qui. Seleziona questa opzione per aprire un'esplorazione preimpostata con la query del workflow.
  • Il pulsante Testa ora, che esegue una query istantanea del flusso di lavoro.

Dalla pagina utente Gestisci workflow, puoi visualizzare la pagina Dettagli per i workflow di cui sei proprietario o destinatario in uno dei seguenti modi:

  1. Seleziona il menu Opzioni del flusso di lavoro e poi Visualizza flusso di lavoro.
  2. Fai clic sul nome del flusso di lavoro.

Nella pagina Dettagli, puoi eseguire le seguenti operazioni:

  1. Seleziona il campo di testo per aggiungere il contesto sul flusso di lavoro.
  2. Seleziona il menu Altro e poi l'opzione Esplora da qui per aprire un'esplorazione preimpostata con la query del flusso di lavoro.
  3. Seleziona Testa ora per eseguire immediatamente una query del workflow, senza dover attendere la frequenza specificata del workflow. Se le condizioni del workflow vengono soddisfatte, verrà inviata una notifica al proprietario e a eventuali destinatari aggiuntivi.

Fai clic su Fine per chiudere la pagina Dettagli.

Monitorare l'attività del flusso di lavoro

Looker esegue una query del workflow alla frequenza specificata per verificare se le condizioni sono state soddisfatte. I risultati di questi controlli diventano la cronologia del flusso di lavoro, che è visibile nella pagina Attività.

La tabella nella pagina Attività include le seguenti informazioni su ogni job di query del flusso di lavoro:

Intestazione Definizione Valori possibili
Esecuzione alle Il timestamp di avvio della query del workflow Qualsiasi timestamp nel formato DD/MM HH:MM

Esempio: 05/30 18:25
Durata Tempo impiegato per l'esecuzione della query del workflow Qualsiasi durata nel formato 0.81s
Qualcosa di nuovo Un valore booleano che indica se la query del flusso di lavoro ha controllato i dati modificati tra le due query del flusso di lavoro più recenti
  • Yes (se i dati sono stati modificati)
  • No (se i dati non sono cambiati)
Origine L'origine dei dati da cui la query del workflow ha verificato il valore di soglia indicato nelle condizioni del workflow
  • query
  • cache
  • stale cache
  • Se query, cache o stale cache non sono applicabili, il valore Origine sarà vuoto.
Ora di origine Il timestamp della riga del database da cui la query del flusso di lavoro ha verificato il valore di soglia Qualsiasi timestamp nel formato DD/MM HH:MM

Esempio: 05/25 16:01
Condizione soddisfatta Un valore booleano che indica se le condizioni del flusso di lavoro sono state soddisfatte
  • Yes (le condizioni sono state soddisfatte)
  • No (le condizioni non sono state soddisfatte)
Trigger Il valore di soglia che attiverebbe il flusso di lavoro se raggiunto o superato Qualsiasi valore numerico
Osservato Il valore osservato che ha soddisfatto o superato le condizioni del flusso di lavoro e lo ha attivato Qualsiasi valore numerico
Stato Lo stato della query del flusso di lavoro
  • Complete
  • Running
  • Not Started

Nella pagina Attività puoi eseguire le seguenti operazioni:

  1. Visualizza la frequenza con cui la query del workflow controlla le sue condizioni.
  2. Visualizza la cronologia del flusso di lavoro.
  3. Utilizza il pulsante Testa ora per eseguire una query del workflow istantanea. Se il workflow viene attivato, una notifica verrà inviata al proprietario e a eventuali destinatari aggiuntivi.

Fai clic su Fine per chiudere la pagina Attività.

Modificare le condizioni del workflow

In alcune circostanze, il proprietario di un flusso di lavoro o l'amministratore di Looker potrebbe dover modificare manualmente la configurazione del flusso di lavoro, ad esempio:

  • Attivazione o disattivazione dell'analisi dei fattori chiave basata su Gemini, che viene visualizzata nella notifica
  • Modifica delle soglie e delle condizioni delle metriche che attivano il flusso di lavoro in base all'evoluzione delle esigenze dell'organizzazione
  • Aggiornamento delle destinazioni di notifica
  • Aggiornamento della frequenza del flusso di lavoro per un migliore allineamento con le norme di memorizzazione nella cache

Per modificare le impostazioni di un flusso di lavoro:

  1. Nella pagina Gestisci flussi di lavoro, seleziona il menu Opzioni per il flusso di lavoro che vuoi modificare.
  2. Seleziona Modifica workflow per aprire la finestra di dialogo di modifica del workflow.
  3. Apporta le modifiche alle impostazioni del flusso di lavoro.
  4. Seleziona Salva avviso per salvare le modifiche.

Effetto dell'eliminazione di agenti, conversazioni, esplorazioni o dashboard sui flussi di lavoro

L'eliminazione di un agente dati o di una conversazione influisce sul flusso di lavoro associato nei seguenti modi:

  • Se un utente elimina la conversazione con l'agente che genera il flusso di lavoro, quest'ultimo rimane attivo. I destinatari delle notifiche del workflow continueranno a riceverle quando le condizioni del workflow vengono soddisfatte.
  • Se un utente elimina l'agente che genera il flusso di lavoro, quest'ultimo rimane attivo. I destinatari delle notifiche del workflow continueranno a riceverle quando le condizioni del workflow vengono soddisfatte.
  • Se un utente elimina l'esplorazione o la dashboard che contiene i dati monitorati dal flusso di lavoro, quest'ultimo rimane attivo. I destinatari delle notifiche del workflow continueranno a riceverle quando le condizioni del workflow vengono soddisfatte.

Messaggi di errore e avviso del flusso di lavoro

La pagina utente Gestisci flussi di lavoro mostra eventuali errori o avvisi visualizzati quando viene eseguito il flusso di lavoro o viene inviata la notifica del flusso di lavoro. I messaggi di errore, se applicabili, vengono visualizzati quando passi il puntatore sopra l'icona di avviso o di errore nella colonna Condizione soddisfatta.

Impossibile inviare la notifica con la configurazione esistente

Per i workflow configurati per inviare notifiche a Slack o all'app mobile Looker, il messaggio di errore Notification delivery failed with existing configuration viene visualizzato quando il workflow determina che le condizioni del workflow sono state soddisfatte, ma la notifica non è stata inviata. Questo errore può verificarsi se qualcosa nella configurazione di Slack è cambiato dalla creazione del workflow, ad esempio se il workspace Slack a cui veniva inviato il workflow è stato disconnesso dall'istanza di Looker, se il canale Slack a cui veniva inviato il workflow è stato eliminato o se Looker non riesce a connettersi alle integrazioni.

Avviso: esecuzione di query sui dati aggiornati

Un'icona di avviso nella colonna Condizione soddisfatta indica che i dati su cui si basa il workflow non sono cambiati tra le due query del workflow più recenti. Se passi il puntatore sopra questa icona, viene visualizzato il messaggio Avviso di avviso obsoleto.

Esistono alcune possibili spiegazioni del motivo per cui i dati non sono cambiati tra le query. Se questo avviso persiste, rivolgiti allo sviluppatore di Looker per verificare che i criteri di memorizzazione nella cache definiti per le esplorazioni dell'agente siano allineati all'impostazione della frequenza del flusso di lavoro.