Creare e gestire gli agenti di dati di Explore

Gli agenti di dati ti consentono di curare l'esperienza di Analisi conversazionale per i tuoi utenti. Con gli agenti, puoi fornire ad Analisi conversazionale contesto e istruzioni per consentirgli di rispondere alle domande in modo più efficace per casi d'uso specifici. Gli agenti consentono agli analisti di mappare i termini aziendali a campi specifici, specificare i campi migliori per il filtro e definire calcoli personalizzati.

Questa pagina ti guida attraverso le seguenti procedure:

Scopri come e quando Gemini per Google Cloud utilizza i tuoi dati.

Prima di iniziare

L'utilizzo di Conversational Analytics viene gestito tramite una combinazione di accesso ai contenuti, accesso ai dati e accesso alle funzionalità. Considera un agente dati come un altro tipo di contenuti di Looker, ad esempio una dashboard, un look o una cartella. Per interagire con gli agenti di dati, devi disporre di un ruolo Looker con le autorizzazioni richieste per i modelli alla base della singola esplorazione o che l'agente di dati eseguirà una query. In alcuni casi, dovrai anche accedere all'agente stesso.

Per saperne di più sulle autorizzazioni e sull'accesso necessari per gestire e utilizzare gli agenti dati, consulta la tabella delle autorizzazioni nella pagina di documentazione Configurare Conversational Analytics in Looker.

Gli agenti di esplorazione di Analisi conversazionale sono disponibili quando un amministratore di Looker ha attivato le seguenti funzionalità nella pagina di amministrazione Gemini in Looker:

  • Analisi conversazionale
  • Abilita le funzionalità di Trusted Tester
    • Agentic Workflows [Anteprima]: per creare Agentic Workflows che istruiscono l'agente a monitorare le modifiche ai tuoi dati.
    • Query verificate [Anteprima]: per definire le query verificate, coppie di domande in linguaggio naturale e query di Esplora corrispondenti, come contesto per l'agente. Questa funzionalità di anteprima è disponibile solo in Looker (originale).
    • Pubblica su Gemini Enterprise [Anteprima]: per pubblicare l'agente su Gemini Enterprise, rendendo il contesto e l'analisi predefiniti dell'agente disponibili a un pubblico più ampio.

Creare e modificare gli agenti dati

Per creare un nuovo agente dati:

  1. Vai alla pagina Conversazioni.
  2. Nella scheda Agenti, seleziona + Nuovo agente. In alternativa, nel riquadro a sinistra, seleziona sparkGestisci agenti, quindi seleziona + Nuovo agente.

  3. Nella pagina Nuovo agente, fornisci le seguenti informazioni sul tuo agente dei dati.

    • Nome agente: inserisci un nome per l'agente. Il nome deve essere univoco e descrittivo.
    • Descrizione dell'agente: descrivi brevemente cosa può fare questo agente e i dati che utilizza. Gli utenti vedranno questa descrizione quando selezionano l'agente per avviare una conversazione o quando condividi l'agente con loro, quindi assicurati che la descrizione spieghi chiaramente lo scopo dell'agente e come può essere utile.
    • Dati: segui questi passaggi per connetterti a un massimo di cinque esplorazioni di Looker esistenti:
      1. Nel campo Dati, fai clic su + Seleziona esplorazioni.
      2. Nella finestra Cerca esplorazioni, fai clic sulle esplorazioni che vuoi includere nell'agente dati. Questi esplora verranno visualizzati nel riquadro Esplora selezionati della finestra.
      3. Per aggiungere l'esplorazione selezionata all'agente dati, fai clic su Salva.

  4. Istruzioni: fornisci il contesto per aiutare Analisi conversazionale a capire come interagire con i tuoi dati e fornire risposte accurate e pertinenti. Per esempi dei tipi di contesto che puoi fornire, vedi Scrivere istruzioni per l'agente.

  5. (Facoltativo) Per attivare Advanced Analytics per tutte le conversazioni con il tuo agente, seleziona Attiva Advanced Analytics.

  6. (Facoltativo) Seleziona Opzioni avanzate per espandere la sezione e configurare le seguenti impostazioni:

    • Mostra ragionamento: attiva questo pulsante per visualizzare i passaggi di ragionamento dell'agente, le query Looker generate e le tabelle di dati sottostanti nelle risposte.
    • Mostra informazioni di debug: attiva questo pulsante per visualizzare i passaggi eseguiti dall'agente per ogni risposta per facilitare la risoluzione dei problemi.

  7. Se vuoi, puoi testare l'agente per perfezionare le istruzioni e le impostazioni.

  8. Per salvare il nuovo agente dati, fai clic su Salva.

Dopo aver salvato l'agente dati, puoi condividerlo con altri utenti e avviare una conversazione con l'agente.

Scrivere istruzioni per l'agente

Quando crei un data agent, puoi aggiungere istruzioni in formato libero che definiscono il comportamento principale del data agent e forniscono un contesto di base da considerare prima di elaborare il prompt di un utente.

Ecco alcuni esempi dei tipi di contesto che puoi fornire nel campo Istruzioni:

  • Campi chiave: i campi più importanti per l'analisi
  • Campi esclusi: campi che l'agente di dati deve evitare
  • Filtri e raggruppamento: campi che l'agente deve utilizzare per filtrare e raggruppare i dati
  • Ruolo: un ruolo o un'esperienza, un personaggio o un tono che assegni all'agente

Per suggerimenti e best practice per la scrittura di istruzioni per l'agente, consulta la pagina della documentazione Best practice per la configurazione di Conversational Analytics in Looker.

Definisci query verificate

Le query verificate (chiamate anche query dorate in alcune documentazioni di Google) sono coppie predefinite di domande in linguaggio naturale e le relative query di esplorazione di Looker esatte. Queste coppie di domande e query fungono da "gold standard" di verità verificati che insegnano all'agente come gestire richieste aziendali complesse senza fare ipotesi. Le query verificate ben definite possono contribuire a migliorare l'accuratezza delle risposte dell'agente di dati di Explore.

Limiti delle query verificate

Quando utilizzi le query verificate, tieni presente i seguenti limiti:

  • Le query verificate sono disponibili solo per gli agenti di dati di Esplora. Non sono disponibili per le conversazioni autonome o per gli agenti di dati delle dashboard.
  • Devi utilizzare un'esplorazione già definita per l'agente. Se fai riferimento a un'esplorazione non utilizzata dall'agente dati, viene visualizzato il messaggio di errore This query will not be used as it references an Explore that has not been defined in this agent. For best results, make sure that verified queries are based on Explores used in this agent.
  • Le query verificate non supportano le query di esplorazione che contengono campi personalizzati o tabelle pivot.
  • Sebbene non esista un limite al numero di query verificate che puoi aggiungere, ti consigliamo di includere non più di 30-50 coppie di domande e query per agente.

Crea una query verificata

Per aggiungere una query verificata a un agente dati nuovo o esistente:

  1. Crea un nuovo agente di dati o modifica un agente di dati esistente che utilizza almeno un'esplorazione come origine dati.
  2. Nella pagina di creazione o modifica dell'agente, seleziona + Aggiungi query verificata.
  3. In Aggiungi query verificata, inserisci la domanda in linguaggio naturale e la relativa risposta:
    • Domanda: inserisci una domanda in linguaggio naturale che un utente potrebbe porre.
    • Risposta: incolla l'URL dell'esplorazione che acquisisce la query o la visualizzazione corretta.
  4. Per verificare la query Esplora, fai clic su Anteprima.
    • In alternativa: lascia vuoto il campo Risposta e fai clic su Anteprima per creare una query da zero in Esplora e poi salva l'URL risultante da utilizzare.
  5. Fai clic su Salva.

Modificare una query verificata

Per modificare una query verificata esistente:

  1. Nella conversazione con l'agente, seleziona Modifica agente.
  2. In Query verificate, trova la query verificata che vuoi modificare.
  3. Fai clic su Modifica query verificata.
  4. Nella finestra di dialogo Modifica query verificata, apporta modifiche alla domanda o alla risposta.
  5. Fai clic su Salva.

Eliminare una query verificata

Per eliminare una query verificata:

  1. Nella conversazione con l'agente, seleziona Modifica agente.
  2. Nella sezione Query verificate, trova la query verificata che vuoi eliminare.
  3. Fai clic su Elimina query verificata.

Testare un agente

Quando crei o modifichi un agente, la pagina dei dettagli dell'agente include il riquadro Visualizza l'anteprima dell'agente. Puoi testare le impostazioni e le istruzioni dell'agente avviando una conversazione con l'agente.

Per visualizzare una modifica nell'anteprima, devi fare clic su Aggiorna. Se lo stato del salvataggio è Not saved, gli aggiornamenti alle impostazioni non verranno visualizzati nell'anteprima.

Modificare un agente dati esistente

Per modificare un agente dati esistente:

  1. Nella pagina Conversazioni, seleziona sparkGestisci agenti.
  2. Nella pagina Gestisci agenti, seleziona l'agente di dati che vuoi modificare.
  3. Aggiorna i dettagli dell'agente in base alle tue esigenze. Puoi modificare i dettagli specificati durante la creazione dell'agente, incluse le impostazioni di Nome agente, Descrizione dell'agente, Dati, Istruzioni e Opzioni avanzate. Puoi anche scegliere di attivare Code Interpreter per il tuo agente.
  4. Per salvare le modifiche, fai clic su Aggiorna.

Condividere gli agenti di dati

La condivisione consente ad altri utenti di chattare con il tuo agente e le sue esplorazioni. Puoi condividere un agente dati con altri utenti concedendogli l'accesso ai contenuti. Solo un utente con le autorizzazioni e l'accesso ai contenuti appropriati può condividere un agente. Una volta creato un agente, potrebbero essere necessari alcuni minuti prima che possa essere condiviso.

Per condividere un agente dati:

  1. Nella pagina Conversazioni, seleziona scintillaGestisci agenti nel riquadro a sinistra.
  2. Apri il menu dell'agente scelto facendo clic sull'icona Altre opzioni, quindi fai clic su Condividi.
  3. Dopo aver aggiunto una persona o dei gruppi alla sezione Chi può accedere a questo agente e aver scelto il livello di autorizzazioni che devono avere, fai clic su Aggiungi per inserirli nell'elenco condiviso.
  4. Se vuoi che i nuovi utenti o gruppi ricevano una notifica via email, seleziona la casella di controllo Invia un'email alle persone che hai appena aggiunto.
  5. Dopo aver apportato tutte le modifiche, fai clic su Salva.

Puoi anche condividere un agente che hai appena creato o uno che stai modificando facendo clic su Condividi nella pagina delle impostazioni dell'agente e seguendo i passaggi sopra descritti.

Revocare l'accesso a un agente di dati

Per revocare l'accesso a un agente:

  1. Nella pagina Conversazioni, fai clic su SparkGestisci agenti nel riquadro a sinistra.
  2. Apri il menu dell'agente scelto facendo clic sull'icona Altre opzioni, quindi fai clic su Condividi.
  3. Fai clic sulla X accanto all'utente o ai gruppi a cui deve essere rimosso l'accesso.
  4. Dopo aver apportato tutte le modifiche, fai clic su Salva.

Se gli utenti rimossi hanno una conversazione in corso, avranno ancora accesso per un minuto o due mentre le modifiche vengono propagate.

Se un utente tenta di porre altre domande una volta rimosso l'accesso a un agente, visualizzerà il messaggio The agent in this conversation may not be shared with you, or may have been deleted. You can view any past conversations with the agent, but can't ask new questions.

Pubblicare un agente di dati

Puoi pubblicare il tuo agente dati in Gemini Enterprise, rendendo il contesto e l'analisi predefiniti dell'agente disponibili a un pubblico più ampio, inclusi gli utenti che potrebbero non avere familiarità con l'interfaccia di Looker. Gemini Enterprise funge da hub centrale in cui gli utenti possono gestire gli agenti di dati creati in diverse applicazioni, il che li aiuta a trovare l'agente migliore per le loro esigenze di analisi. Google Cloud

Prima di iniziare

La procedura per creare un agente dati in Looker e renderlo disponibile agli utenti in Gemini Enterprise prevede attività eseguite nell'istanza di Looker, nella pagina Gemini Enterprise della console Google Cloud e nell'istanza di Gemini Enterprise.

Gli utenti con i seguenti ruoli devono seguire i passaggi descritti nelle sezioni associate:

  1. Editor degli agenti di dati (funzionalità di Looker): pubblica l'agente in Looker.
  2. Amministratore Discovery Engine (ruolo IAM): concede l'accesso all'agente nella console Google Cloud .
  3. Utente Gemini Enterprise (ruolo IAM); Utente agente dati (funzionalità di Looker): chatta con l'agente nell'istanza Gemini Enterprise.

Prima di poter pubblicare un agente, devono essere soddisfatti i seguenti requisiti:

  • Un amministratore di Looker deve attivare l'impostazione Pubblica su Gemini Enterprise nella pagina Gemini in Looker del pannello Amministrazione.
  • Un amministratore di Looker deve concederti un ruolo che contenga l'autorizzazione publish_agent_externally. Devi anche essere in grado di modificare un agente dati.
  • Al account di servizio Looker nel progetto Google Cloud che ospita il motore Gemini Enterprise deve essere concesso il ruolo Identity and Access Management Discovery Engine Admin. La concessione di questo ruolo assegna una licenza Gemini Enterprise all'account quando il primo agente dati viene pubblicato. Se non sono disponibili licenze Gemini Enterprise da assegnare al account di servizio Looker, la pagina del motore Gemini Enterprise nella console Google Cloud mostra l'errore "Impossibile allocare la quota per la creazione di agenti". Un utente con il ruolo Identity and Access Management Discovery Engine Admin deve quindi eseguire il provisioning di una nuova licenza Gemini Enterprise o riassegnare una licenza esistente per il account di servizio Looker.

Pubblicare un agente dati su Gemini Enterprise

Per completare i passaggi descritti in questa sezione, devi disporre di un ruolo Looker che contenga l'autorizzazione publish_agent_externally e le autorizzazioni e l'accesso ai contenuti appropriati per modificare gli agenti dati.

Per pubblicare un agente:

  1. Modifica l'agente.
  2. Seleziona Impostazioni di pubblicazione per aprire la finestra Impostazioni di pubblicazione dell'agente.
  3. Nella finestra Impostazioni di pubblicazione dell'agente, attiva l'impostazione Gemini Enterprise e seleziona Aggiorna. Se attivi questa impostazione, l'agente viene pubblicato nell'istanza di Gemini Enterprise visualizzata nella pagina Gemini in Looker del pannello Amministrazione.
  4. Dopo aver pubblicato l'agente, puoi selezionare Condividi per concedere ad altri utenti di Looker l'accesso all'agente di dati oppure selezionare Avvia conversazione per aprire una nuova conversazione con l'agente di dati.

Concedere agli utenti l'accesso all'agente in Gemini Enterprise

Per completare i passaggi descritti in questa sezione, devi disporre del ruolo Identity and Access Management Amministratore Discovery Engine per il progetto Google Cloud che contiene il motore Gemini Enterprise.

Per poter chattare con un agente in Gemini Enterprise, un utente deve avere accesso all'istanza Gemini Enterprise e al singolo agente.

Per concedere a un utente l'accesso all'istanza Gemini Enterprise, un amministratore Discovery Engine deve assegnare all'utente il ruolo IAM Utente Gemini Enterprise per il progetto Google Cloud che contiene il motore Gemini Enterprise.

Per concedere a un utente l'accesso a un singolo agente, l'amministratore di Discovery Engine deve completare i seguenti passaggi nella console Google Cloud :

  1. Vai al Google Cloud progetto che contiene il motore Gemini Enterprise.
  2. Apri la pagina di prodotto Gemini Enterprise.
  3. Seleziona la pagina App dalla navigazione principale, quindi seleziona il nome dell'istanza di Gemini Enterprise.
  4. Nel menu di navigazione principale, seleziona Agenti.
  5. Seleziona l'agente a cui vuoi concedere l'accesso.
  6. Seleziona la scheda Autorizzazioni utente.
  7. Seleziona Aggiungi utente.
  8. Nella finestra Aggiungi ruoli di autorizzazioni dell'utente all'agente, aggiungi ogni utente e assegna il ruolo Utente agente.

Chattare con l'agente in Gemini Enterprise

Per completare i passaggi descritti in questa sezione, devi disporre del ruolo Identity and Access Management Utente Gemini Enterprise per il progetto Google Cloud che contiene il motore Gemini Enterprise. Devi anche disporre delle autorizzazioni e dell'accesso ai contenuti appropriati per chattare con l'agente nell'istanza Looker.

Per chattare con un agente di dati in un'istanza di Gemini Enterprise:

  1. Apri l'istanza di Gemini Enterprise.
  2. Seleziona Agenti nel menu di navigazione principale.
  3. Nella pagina Agenti, seleziona l'agente con cui vuoi chattare. Quando selezioni un agente, si apre una finestra di conversazione in cui puoi porre domande sui tuoi dati.

La prima volta che chatti con un agente, devi autorizzare l'accesso dell'agente alla tua identità Looker.

Eliminare un agente di dati

Per eliminare un agente dati:

  1. Nella pagina Conversazioni, fai clic su SparkGestisci agenti nel riquadro a sinistra.
  2. Apri il menu dell'agente scelto facendo clic sull'icona Altre opzioni e poi su Elimina.
  3. Nella finestra Eliminare l'agente?, fai clic su Sposta nel cestino per eliminare l'agente di dati.

Gli agenti spostati nel cestino verranno eliminati definitivamente dopo 30 giorni. Puoi eliminare definitivamente un agente dei dati manualmente oppure ripristinarlo dal cestino prima che venga eliminato definitivamente. Se non intervieni, l'agente verrà eliminato definitivamente dopo 30 giorni in modo automatico.

Eliminare definitivamente un agente dati

Per eliminare definitivamente un agente dati:

  1. Vai alla pagina Conversazioni.
  2. Nel pannello di navigazione a sinistra, espandi la sezione Cestino.
  3. Per aprire il menu dell'agente scelto, seleziona la relativa icona e fai clic su Elimina definitivamente.
  4. Nella finestra Vuoi procedere?, fai clic su Elimina definitivamente.

Ripristinare un agente di dati dal cestino

Per ripristinare un agente dati dal cestino:

  1. Vai alla pagina Conversazioni.
  2. Nel pannello di navigazione a sinistra, espandi la sezione Cestino.
  3. Per aprire il menu dell'agente scelto, seleziona la relativa icona e poi fai clic su Ripristina.