Creare e gestire gli agenti di dati

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

Questa pagina ti guida attraverso le seguenti procedure:

• Creare e modificare gli agenti dati
• Condividere gli agenti 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

Considera un agente dati come un altro tipo di contenuti di Looker, ad esempio una dashboard, un look o una cartella.

L'utilizzo di un agente dati viene gestito tramite una combinazione di accesso ai contenuti, accesso ai dati e accesso alle funzionalità. Per eseguire le attività descritte nella tabella seguente, devi disporre di un ruolo Looker con le autorizzazioni necessarie per i modelli che l'agente dati interrogherà e, in alcuni casi, l'accesso all'agente stesso.

Attività	Autorizzazioni Looker richieste	Livello di accesso richiesto per l'agente dati
Creare, modificare, condividere ed eliminare agenti	Aggiunto il giorno 25.18 admin_agents	Non deve essere concesso l'accesso ai contenuti
Creare, modificare, condividere ed eliminare agenti	Aggiunto il giorno 25.18 save_agents Gli utenti possono creare agenti che utilizzano solo le esplorazioni per le quali è stata concessa questa autorizzazione sul modello sottostante. Per modificare, eliminare o condividere un agente dati creato da un altro utente, agli utenti deve essere concesso un ruolo che contenga questa autorizzazione per ogni modello utilizzato dall'agente.	Gestisci accesso; Modifica (questo accesso viene concesso automaticamente se l'utente crea l'agente; in caso contrario, l'accesso Gestisci accesso; Modifica deve essere concesso dal creatore dell'agente condividendolo)
Pubblicare agenti in altre Google Cloud applicazioni	Aggiunta versione 26.6 publish_agent_externally Gli utenti pubblicano gli agenti esistenti in altre applicazioni Google Cloud , come Gemini Enterprise.	Gestisci accesso; Modifica (questo accesso viene concesso automaticamente se l'utente crea l'agente; in caso contrario, l'accesso Gestisci accesso; Modifica deve essere concesso dal creatore dell'agente condividendolo)
Chatta con un agente dei dati dalla scheda Agenti in Analisi conversazionale	access_data (su ogni modello che contiene le esplorazioni utilizzate dall'agente dati) Aggiunta della versione 25.18 chat_with_agent (su ogni modello che contiene le esplorazioni utilizzate dall'agente dati)	Accesso Visualizza
Chattare con un'esplorazione di Looker dalla scheda Esplorazioni in Analisi conversazionale	access_data (su ogni modello che contiene le esplorazioni utilizzate dall'agente dati) Aggiunto il giorno 25.18 chat_with_explore

Looker dispone anche dei seguenti ruoli predefiniti che contengono sottoinsiemi di queste autorizzazioni per tutti i modelli dell'istanza:

• Gestore agenti di Analisi conversazionale: con questo ruolo, un utente può creare, modificare, condividere, eliminare e chattare con gli agenti per i quali dispone dell'accesso Gestisci accesso; Modifica e chattare con Esplora
• Utente di Analisi conversazionale: con questo ruolo, un utente può chattare con un agente per cui dispone dell'accesso Visualizzazione.
• Amministratore: per impostazione predefinita, questo ruolo (amministratore Looker) dispone di tutte le autorizzazioni e dell'accesso ai contenuti nell'istanza.

Un amministratore di Looker può concedere questi ruoli e autorizzazioni nella pagina Ruoli della sezione Amministrazione dell'istanza di Looker. Per saperne di più sui ruoli di Looker, consulta la pagina di documentazione Impostazioni di amministrazione - Ruoli.

Il creatore dell'agente dati può gestire l'accesso dei singoli utenti all'agente condividendolo.

Creare e modificare gli agenti 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 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 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 da 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, consulta Istruzioni per l'agente di scrittura.

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

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.

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.

Importante :anche se il campo Istruzioni è facoltativo e la struttura è 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
• Query d'oro: coppie di domande in linguaggio naturale e le query di esplorazione corrispondenti
• Persona: un ruolo o un'esperienza, un personaggio o un tono che assegni all'agente

Nota: i tipi di contesto creato che puoi fornire a un agente di dati in Looker differiscono leggermente da quelli che puoi fornire a un agente che stai creando utilizzando l'API Analisi conversazionale. Alcuni dei contenuti che fornisci nel campo Istruzioni in Looker, ad esempio le query d'oro, possono essere forniti a un agente come contesto strutturato utilizzando l'API Conversational Analytics.

Per suggerimenti e best practice per la scrittura di istruzioni per gli agenti, consulta Best practice per la configurazione di Analisi conversazionale in Looker.

Definisci una query di riferimento di Looker

Per definire ogni query di riferimento di Looker per una determinata esplorazione, fornisci i valori per entrambi i seguenti campi:

• natural_language_questions: La domanda in linguaggio naturale che un utente potrebbe porre
• looker_query: la query di riferimento di Looker che corrisponde alla domanda in linguaggio naturale

Suggerimenti per definire le query di riferimento di Looker:

Includi diversi tipi di domande e query con una varietà di filtri e valori dei filtri.

Sebbene non esista un limite al numero di query di riferimento che puoi includere in looker_golden_queries, ti consigliamo di non includere più di 30-50 coppie di domande e query.

Per il campo natural_language_questions, considera le domande che un utente potrebbe porre su questa esplorazione e scrivile in linguaggio naturale. Puoi includere più di una domanda nel valore di questo campo. Puoi ottenere il valore per il campo looker_query dai metadati della query di Esplora.

Le query dorate supportano i seguenti campi:

• model (stringa): il modello LookML utilizzato per generare la query. Questo è un campo obbligatorio.
• explore (stringa): l'esplorazione utilizzata per generare la query. Questo è un campo obbligatorio.
• fields[] (stringa): i campi da recuperare da Esplora, incluse dimensioni e misure. Questo è un campo facoltativo.
• filters[] (stringa): i filtri da applicare all'esplorazione. Questo è un campo facoltativo.
• sorts[] (stringa): l'ordinamento da applicare all'esplorazione. Questo è un campo facoltativo.
• limit (stringa): il limite di righe di dati da applicare all'esplorazione. Questo è un campo facoltativo.

Nota: Analisi conversazionale non supporta le query di riferimento che contengono pivots o campi personalizzati.

Per recuperare i metadati delle query di Esplora direttamente da Esplora:

1. In Esplora, seleziona il menu Azioni di Esplora e poi seleziona Ottieni LookML.
2. Seleziona la scheda Dashboard.
3. Copia i dettagli della query da LookML. Ad esempio, l'immagine seguente mostra il codice LookML per un'esplorazione chiamata Order Items:

Copia i metadati selezionati da utilizzare nella query di riferimento di Looker:

  model: thelook
  explore: order_items
  fields: [order_items.order_id, orders.status]
  sorts: [orders.status, order_items.order_id]
  limit: 500

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, inclusi i campi Nome agente, Descrizione agente, Dati e Istruzioni. 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.

Nota: la concessione dell'accesso ai contenuti di un agente a un utente 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 Analisi conversazionale con il modello su cui si basa l'esplorazione. L'amministratore di Looker potrebbe dover concedere queste autorizzazioni.

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 dati

Per revocare l'accesso a un agente:

1. Nella pagina Conversazioni, fai clic su 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. 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 dopo la rimozione dell'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

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini delle Offerte pre-GA" nella sezione 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.

La pubblicazione dell'agente ti consente di condividerlo in altre applicazioni su Google Cloud. Puoi condividere il tuo agente con le seguenti Google Cloud applicazioni:

• Gemini Enterprise

Prima di poter pubblicare un agente, un amministratore di Looker deve attivare l'impostazione Pubblica su Gemini Enterprise nella pagina Gemini in Looker del pannello Amministrazione e concederti un ruolo che contenga l'autorizzazione publish_agent_externally.

Per pubblicare un agente:

1. Modifica l'agente.
2. Seleziona Impostazioni di pubblicazione per aprire la finestra Impostazioni di pubblicazione.
3. Nella finestra Impostazioni di pubblicazione, attiva l'impostazione Gemini Enterprise e seleziona Pubblica. L'attivazione di questa impostazione pubblica l'agente nell'istanza Gemini Enterprise visualizzata.

4. Nell'istanza di Gemini Enterprise, un utente con le seguenti autorizzazioni deve concedere agli utenti l'accesso all'agente:

   • discoveryengine.projects.get
   • resourcemanager.projects.get
   • serviceusage.services.list

   Queste autorizzazioni sono disponibili nel ruolo Amministratore di Discovery Engine.

Nota: l'integrazione di Looker e Gemini Enterprise è in anteprima con supporto limitato. 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

Eliminare un agente di dati

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

Per eliminare un agente dati:

1.Nella pagina Conversazioni, fai clic su ScintillaGestisci agenti nel riquadro a sinistra. 1. Apri il menu dell'agente scelto facendo clic sull'icona Altre opzioni e poi su Elimina. 1. 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 puoi ripristinare un agente di dati dal cestino prima che venga eliminato definitivamente. Se non intervieni, l'agente verrà eliminato definitivamente in modo automatico dopo 30 giorni.

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.

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.

• 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 l'analisi avanzata con l'interprete di codice: l'interprete di codice in Analisi conversazionale traduce le domande in linguaggio naturale in codice Python ed esegue il codice. Rispetto alle query standard basate su SQL, l'utilizzo di Python da parte di Code Interpreter consente analisi e visualizzazioni più complesse.