Impostazioni amministrative - Workflows

La pagina di amministrazione Gestisci flussi di lavoro è il punto in cui gli amministratori di Looker possono gestire i flussi di lavoro agentici di analisi conversazionale creati da qualsiasi utente dell'istanza. La pagina Amministrazione è accessibile dalla sezione Avvisi e pianificazioni del pannello Amministrazione. La pagina di amministrazione Gestisci workflow elenca informazioni su tutti i workflow attivi e inattivi.

Gli utenti possono visualizzare le informazioni sui flussi di lavoro che hanno creato o per i quali sono elencati come destinatari nella pagina utente Gestisci flussi di lavoro, disponibile dal menu del profilo utente.

Informazioni sul workflow

La pagina di amministrazione Gestisci workflow fornisce le seguenti informazioni su tutti i workflow nell'istanza di Looker:

Colonna Definizione
Nome workflow Il titolo del flusso di lavoro, impostato dall'agente all'avvio del flusso di lavoro. 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 workflow o viene inviata la notifica del workflow. Passa il mouse sopra l'icona di avviso o errore per visualizzare il messaggio di errore associato, se applicabile.

Un'icona di avviso con un avviso di workflow obsoleto indica che i dati nel riquadro della dashboard non sono cambiati tra le due query del workflow 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 Gestisci flussi di lavoro o quando un amministratore di Looker disattiva il flusso di lavoro. Se disabiliti il flusso di lavoro, le notifiche verranno sospese per tutti i destinatari del flusso di lavoro.
Attività Un link che ti indirizza alla pagina Attività del workflow.
Menu Opzioni Un menu da cui puoi eseguire azioni aggiuntive sul flusso di lavoro. Scopri di più nella sezione Opzioni di gestione del flusso di lavoro in 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 è disattivato)

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 flusso di lavoro

Anche se non puoi eliminare definitivamente un workflow, puoi controllare se è attivo. Quando un workflow ha lo Stato 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 riceveranno una notifica in base al metodo di notifica specificato nel flusso di lavoro. Quando un flusso di lavoro ha lo stato Disattivato, non viene eseguita alcuna query del flusso di lavoro e non vengono inviate notifiche. La pagina Dettagli di un workflow disattivato non mostra risultati nella visualizzazione del workflow.

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

  • Mettere temporaneamente in pausa le notifiche del workflow per riconfigurare le condizioni del workflow
  • 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 di amministrazione Gestisci workflow, trova 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 flusso di lavoro che possono essere visualizzate dal proprietario del flusso di lavoro e da tutti i destinatari del flusso di lavoro. Mostra 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 flusso di lavoro, 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 di amministrazione Gestisci workflow, gli amministratori di Looker possono visualizzare la pagina Dettagli per qualsiasi workflow nell'istanza in uno dei seguenti modi:

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

Nella pagina Dettagli, gli amministratori di Looker possono eseguire le seguenti operazioni:

  1. Seleziona il campo di testo per aggiungere il contesto del 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 flusso di lavoro, senza dover attendere la frequenza specificata del flusso di lavoro. Se le condizioni del flusso di lavoro sono soddisfatte, una notifica verrà inviata 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 workflow ha controllato i dati modificati tra le due query del workflow 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 flusso di lavoro ha verificato il valore di soglia indicato nelle condizioni del flusso di lavoro
  • 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à, gli amministratori di Looker possono 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 di amministrazione 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. Se applicabile, i messaggi di errore 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 flussi di lavoro configurati per inviare notifiche all'app mobile Slack o Looker, il messaggio di errore Notification delivery failed with existing configuration viene visualizzato quando il flusso di lavoro determina che le condizioni del flusso di lavoro sono state soddisfatte, ma la notifica non è stata recapitata. Questo errore può verificarsi se qualcosa nella configurazione di Slack è cambiato dalla creazione del workflow, ad esempio se il workspace di Slack a cui veniva inviato il workflow è stato disconnesso dall'istanza di Looker o se il canale Slack a cui veniva inviato il workflow è stato eliminato oppure 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 flusso di lavoro non sono cambiati tra le due query del flusso di lavoro più recenti. Tieni il puntatore su questa icona per visualizzare il messaggio 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.