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 Conversational Analytics 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 su campi specifici, specificare i campi migliori per il filtro e definire calcoli personalizzati.

Nota: questa pagina descrive gli agenti di dati di Explore, ovvero gli agenti di dati che eseguono query su Explore. Per informazioni sugli agenti dei dati per le dashboard definite dall'utente e le dashboard LookML, consulta le pagine della documentazione Eseguire query su una dashboard definita dall'utente con un agente della dashboard e Creare e gestire agenti dei dati per le dashboard LookML, rispettivamente.

Questa pagina ti guida attraverso le seguenti procedure:

• Crea e modifica gli agenti di dati
• Condividi gli agenti di dati con altri utenti
• Pubblicare agenti di dati in altre applicazioni
• Eliminare gli agenti di dati

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

Prima di iniziare

L'utilizzo di Conversational Analytics è gestito tramite una combinazione di accesso ai contenuti, accesso ai dati e accesso alle funzionalità. Pensa a un agente di dati come a un altro tipo di contenuto di Looker, come una dashboard, un Look o una cartella. Per interagire con gli agenti di dati, devi disporre di un ruolo di Looker con le autorizzazioni necessarie per i modelli su cui si basa la singola esplorazione o su cui l'agente di dati eseguirà 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 di dati, consulta la tabella delle autorizzazioni nella pagina della documentazione Configura Analisi conversazionale in Looker.

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

• Analisi conversazionale:
  • Analisi conversazionale (pagina Conversazioni): attiva questa impostazione per consentire l'accesso alla pagina Conversazioni per gli agenti di dati con Esplorazioni e chat dirette con un'esplorazione.
• Opzioni aggiuntive:
  • Analisi avanzata: per consentire all'agente di utilizzare l'Analisi avanzata, che traduce le tue domande in linguaggio naturale in codice Python ed esegue questo codice per fornire analisi e visualizzazioni avanzate, attiva l'impostazione Analisi avanzata. Questa impostazione è facoltativa.
• Abilita le funzionalità di Trusted Tester
  • Agentic Workflows [Anteprima]: per creare Agentic Workflows che indicano all'agente di monitorare le modifiche ai tuoi dati.
  • 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 di dati

Poiché si tratta di una tecnologia in fase iniziale, Gemini per i prodotti Google Cloud può generare output apparentemente plausibili, ma di fatto errati. Ti consigliamo di verificare tutti gli output di Gemini per i prodotti Google Cloud prima di utilizzarli. Per saperne di più, consulta Gemini for Google Cloud e l'AI responsabile.

Per creare un nuovo agente di dati, segui questi passaggi:

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 sull'agente di 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 di dati. Questi Esplora verranno visualizzati nel riquadro Esplora selezionati della finestra.
     3. Per aggiungere l'esplorazione selezionata all'agente di 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, consulta Scrittura delle istruzioni per l'agente.

5. Se vuoi, seleziona Opzioni avanzate per espandere la sezione e configurare le seguenti impostazioni:

   • Abilita analisi avanzate: attiva questa impostazione per abilitare Analisi avanzate per tutte le conversazioni con l'agente.
   • Mostra ragionamento: attiva questo pulsante di attivazione/disattivazione per consentire all'agente di visualizzare i passaggi di ragionamento, le query Looker generate e le tabelle di dati sottostanti in tutte le risposte di ogni conversazione.
   • Mostra informazioni di debug: attiva questo pulsante per consentire all'agente di mostrare i passaggi eseguiti per tutte le risposte in ogni conversazione.

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

7. 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.

Scrivi le istruzioni dell'agente

Quando crei un agente dati, puoi aggiungere istruzioni in formato libero che definiscono il comportamento principale dell'agente dati e forniscono un contesto di base da considerare prima di elaborare il prompt di un utente.

Importante: sebbene il campo Istruzioni sia facoltativo e la struttura sia a tua discrezione, ti consigliamo di fornire istruzioni ben strutturate per consentire all'agente di fornire risposte più accurate e pertinenti.

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
• Persona: un ruolo o una competenza, un personaggio o un tono che assegni all'agente

Per suggerimenti e best practice sulla scrittura delle 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 di riferimento in alcune documentazioni di Google, sono coppie predefinite di domande in linguaggio naturale e le relative query di esplorazione di Looker esatte e corrispondenti. Queste coppie di domande e query fungono da "standard di riferimento" verificati della verità che insegnano all'agente come gestire richieste aziendali complesse senza fare supposizioni. 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 chat dirette con un'esplorazione o per gli agenti di dati della dashboard.
• Devi utilizzare un'esplorazione già definita per l'agente. Se fai riferimento a un'esplorazione non utilizzata dall'agente di dati, verrà 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 Esplora che contengono campi personalizzati o 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

Suggerimenti per la definizione delle query verificate:

• Includi diversi tipi di domande e query con una varietà di filtri e valori di filtro.
• Considera le domande che un utente potrebbe porre in merito a un'esplorazione e scrivile in linguaggio naturale.

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 risposta corrispondente:
   • 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, quindi salva l'URL risultante da utilizzare.
5. Fai clic su Salva.

Modifica una query verificata

Per modificare una query verificata esistente:

1. Nella conversazione con l'agente, seleziona Modifica agente.
2. Nella sezione 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 delete Elimina query verificata.

Testa un agente

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

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

Modifica 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 da modificare.
3. Aggiorna i dettagli dell'agente in base alle tue esigenze. Puoi modificare i dettagli specificati al momento della creazione dell'agente, tra cui le impostazioni Nome agente, Descrizione agente, Dati, Istruzioni e Opzioni avanzate. Puoi anche scegliere di attivare Code Interpreter per l'agente.
4. Per salvare le modifiche, fai clic su Aggiorna.

Condividi agenti di dati condivisi

La condivisione consente ad altri utenti di chattare con l'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.

Nota: concedere a un utente l'accesso ai contenuti di un agente non concede anche l'accesso all'esplorazione utilizzata dall'agente. Quando condividi un agente, assicurati che gli utenti dispongano anche delle autorizzazioni necessarie per utilizzare Conversational Analytics con il modello su cui si basa l'esplorazione. L'amministratore di Looker potrebbe dover concedere queste autorizzazioni.

Per condividere un agente di dati, segui questi passaggi:

1. Nella pagina Conversazioni, seleziona 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. 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 un'email di notifica, 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.

Revoca l'accesso a un agente dati

Per revocare l'accesso a un agente, segui questi passaggi:

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 di cui vuoi rimuovere l'accesso.
4. Dopo aver apportato tutte le modifiche, fai clic su Salva.

Se gli utenti rimossi hanno una conversazione in corso, avranno comunque 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.

Pubblica un agente di dati

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

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 Google Cloud applicazioni, il che li aiuta a trovare l'agente migliore per le loro esigenze di analisi.

Nota: l'integrazione di Looker con Gemini Enterprise è in anteprima con assistenza limitata. Ti invitiamo a condividere il tuo feedback per aiutarci a migliorare. Per segnalare bug o problemi, invia un'email all'indirizzo [e-mail] con i seguenti dettagli:

• Una descrizione chiara del problema e del comportamento previsto
• I passaggi per riprodurre il problema
• Eventuali altri dettagli pertinenti

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. Data Agent Editor (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 aziendale Gemini Enterprise (ruolo IAM); Data Agent User (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 le impostazioni Abilita le funzionalità di Trusted Tester e Pubblica su Gemini Enterprise, nonché l'impostazione Analisi conversazionale (pagina Conversazioni), nella pagina Gemini in Looker del pannello Amministratore.
• Un amministratore di Looker deve concederti un ruolo che contenga l'autorizzazione publish_agent_externally. Devi anche essere in grado di modificare un agente di 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 viene pubblicato il primo agente di dati. Se non sono disponibili licenze Gemini Enterprise da assegnare al account di servizio di Looker, la pagina del motore di Gemini Enterprise nella console Google Cloud visualizza l'errore "Impossibile allocare la quota di allocazione per la creazione dell'agente". 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 di Looker.

Nota: la pubblicazione di agenti di dati su Gemini Enterprise non è supportata per le istanze di Looker (Google Cloud core) che utilizzano una connessione di rete privata o ibrida. Per richiedere l'accesso a questa funzionalità per un'istanza di Looker (Google Cloud core) ibrida, contatta [e-mail] con l'URL dell'istanza.

Pubblica 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 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 al tuo agente di dati o selezionare Avvia conversazione per aprire una nuova conversazione con l'agente di dati.

Concedi 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 Discovery Engine Admin 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 di Gemini Enterprise e al singolo agente.

Per concedere a un utente l'accesso all'istanza Gemini Enterprise, un Discovery Engine Admin deve assegnare all'utente il ruolo IAM utente aziendale 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 progetto Google Cloud che contiene il motore di Gemini Enterprise.
2. Apri la pagina di prodotto Gemini Enterprise.
3. Seleziona la pagina App dal menu di 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.

Chatta con l'agente in Gemini Enterprise

Per completare i passaggi descritti in questa sezione, devi disporre del ruolo Identity and Access Management Utente aziendale 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 di Looker.

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

1. Apri la tua 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 interagisci con un agente, devi autorizzare l'accesso dell'agente alla tua identità Looker.

Ripubblica un data agent in Gemini Enterprise

Quando Looker aggiorna le funzionalità o le capacità dell'agente di dati, devi aggiornare o ripubblicare l'agente in modo che le modifiche vengano applicate in Gemini Enterprise.

Looker 26.12 ha introdotto il supporto per i grafici nelle risposte degli agenti. Se l'agente è stato creato prima di Looker 26.12, devi aggiornarlo o ripubblicarlo affinché utilizzi i grafici nelle sue risposte.

Per aggiornare l'agente, segui questi passaggi:

1. Modifica l'agente dati.
2. Modifica i metadati dell'agente.
3. Seleziona Aggiorna.

Per ripubblicare l'agente dati:

1. Modifica l'agente dati.
2. Seleziona Impostazioni di pubblicazione per aprire la finestra Impostazioni di pubblicazione dell'agente.
3. Disattiva l'opzione Gemini Enterprise e seleziona Aggiorna.
4. Attendi che l'agente venga rimosso da Gemini Enterprise.
5. In Looker, modifica l'agente di dati per riaprire la finestra Impostazioni di pubblicazione dell'agente.
6. Seleziona Impostazioni di pubblicazione, attiva il pulsante di attivazione/disattivazione Gemini Enterprise e seleziona Aggiorna.

Elimina un agente di dati

Attenzione: gli utenti con cui hai condiviso questo agente di dati non potranno porre nuove domande dopo l'eliminazione dell'agente; tuttavia, le conversazioni esistenti con l'agente di dati vengono conservate.

Se elimini un agente, verrà eliminato e annullata la pubblicazione in Gemini Enterprise.

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, quindi fai clic 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 di dati manualmente oppure ripristinarlo dal cestino prima che venga eliminato definitivamente. Se non intervieni, l'agente verrà eliminato definitivamente in modo automatico dopo 30 giorni.

Elimina definitivamente un agente di 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 l'icona , quindi fai clic su Elimina definitivamente.
4. Nella finestra Vuoi continuare?, fai clic su Elimina definitivamente.

Ripristina un agente di dati dal cestino

Per ripristinare un agente di dati dal cestino, segui questi passaggi:

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 l'icona , quindi fai clic su Ripristina.

Risorse correlate

• Panoramica di Analisi conversazionale in Looker: la pagina di destinazione di Analisi conversazionale con un elenco di link alle funzionalità chiave di tutta la documentazione di Analisi conversazionale.

• Esegui query su un'esplorazione in linguaggio naturale: avvia una conversazione con un'esplorazione di Looker per chiedere informazioni sui dati dell'esplorazione utilizzando il linguaggio naturale.

• Esegui query su una dashboard definita dall'utente con un agente della dashboard: esegui query e configura gli agenti della dashboard sulle dashboard definite dall'utente.

• Crea e gestisci agenti di dati per le dashboard LookML: utilizza LookML per configurare e gestire agenti di dati con controllo della versione per le dashboard LookML.

• Best practice per la configurazione di Analisi conversazionale in Looker: strategie e best practice per aiutare gli amministratori di Looker e gli sviluppatori LookML a configurare e ottimizzare correttamente Analisi conversazionale.

• Attiva Analisi avanzata: Analisi avanzata all'interno di Analisi conversazionale traduce le tue domande in linguaggio naturale in codice Python ed esegue il codice. Rispetto alle query SQL standard, l'utilizzo di Python da parte della funzionalità Analisi avanzata consente analisi e visualizzazioni più complesse.