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 consentirle 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 filtraggio 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

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

L'utilizzo di un agente di 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 avere un ruolo Looker con le autorizzazioni richieste per i modelli su cui l'agente di dati eseguirà query e, in alcuni casi, l'accesso all'agente stesso.

Attività Autorizzazioni Looker richieste Livello di accesso all'agente di dati richiesto
Creare, modificare, condividere ed eliminare gli agenti Aggiunta 25.18 admin_agents Non è necessario concedere l'accesso ai contenuti
Creare, modificare, condividere ed eliminare gli agenti Aggiunta 25.18 save_agents

Gli utenti possono creare agenti che utilizzano solo le esplorazioni per le quali hanno ricevuto questa autorizzazione sul modello sottostante. Per modificare, eliminare o condividere un agente di dati creato da un altro utente, agli utenti deve essere assegnato un ruolo che contenga questa autorizzazione su 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 condividendo l'agente)
Chattare con un agente di dati dalla scheda Agenti in Analisi conversazionale access_data (su ogni modello che contiene le esplorazioni utilizzate dall'agente di dati)

Aggiunta 25.18 chat_with_agent (su ogni modello che contiene le esplorazioni utilizzate dall'agente di 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 di dati)

Aggiunta 25.18 chat_with_explore

Looker ha anche i seguenti ruoli predefiniti che contengono sottoinsiemi di queste autorizzazioni per tutti i modelli nell'istanza:

  • Gestore degli agenti di Analisi conversazionale: con questo ruolo, un utente può creare, modificare, condividere, eliminare e chattare con gli agenti per i quali ha accesso Gestisci accesso; Modifica e chattare con le esplorazioni
  • Utente di Analisi conversazionale: con questo ruolo, un utente può chattare con un agente per il quale ha accesso Visualizza
  • Amministratore: per impostazione predefinita, questo ruolo (amministratore di 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 ulteriori informazioni sui ruoli di Looker, consulta la pagina di documentazione Impostazioni di amministrazione - Ruoli.

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

Creare e modificare gli agenti di dati

Per creare un nuovo agente di dati:

  1. Vai alla pagina Conversazioni.
  2. Nella scheda Agenti, seleziona + Nuovo agente. In alternativa, nel riquadro a sinistra, seleziona sparkGestisci agenti, quindi + 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 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 in che modo 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. Queste esplorazioni verranno visualizzate nel riquadro Esplorazioni selezionate 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 comprendere come interagire con i tuoi dati e fornire risposte accurate e pertinenti. Per esempi dei tipi di contesto che puoi fornire, consulta Scrivere istruzioni per gli agenti.

  5. (Facoltativo) Per attivare l'interprete di codice per tutte le conversazioni con l'agente, seleziona Attiva Analisi avanzata.

  6. (Facoltativo) Puoi testare l'agente per perfezionare le istruzioni e le impostazioni.

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

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

Scrivere istruzioni per gli agenti

Quando crei un agente di dati, puoi aggiungere istruzioni in formato libero che definiscono il comportamento principale dell'agente di dati 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
  • Filtraggio e raggruppamento: campi che l'agente deve utilizzare per filtrare e raggruppare i dati
  • Query di riferimento: coppie di domande in linguaggio naturale e le relative query di esplorazione
  • Persona: 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 gli agenti, consulta le Best practice per la configurazione di Analisi conversazionale in Looker.

Definire una query di riferimento di Looker

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

  • 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

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 dell'esplorazione.

Le query di riferimento supportano i seguenti campi:

  • model (stringa): il modello LookML utilizzato per generare la query. Questo campo è obbligatorio.
  • explore (stringa): l'esplorazione utilizzata per generare la query. Questo campo è obbligatorio.
  • fields[] (stringa): i campi da recuperare dall'esplorazione, 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.

Puoi recuperare i metadati della query dell'esplorazione direttamente dall'esplorazione seguendo questi passaggi:

  1. Nell'esplorazione, seleziona il menu Azioni di esplorazione , quindi 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 denominata 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.

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

Modificare un agente di dati esistente

Per modificare un agente di 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 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 l'interprete di codice per l'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 relative esplorazioni. Puoi condividere un agente di dati con altri utenti concedendo l'accesso ai contenuti dell'agente. 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 di dati:

  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 un singolo utente o 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 che stai modificando facendo clic su Condividi nella pagina delle impostazioni dell'agente e seguendo i passaggi sopra indicati.

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 comunque accesso per un minuto o due durante la propagazione delle modifiche.

Se un utente tenta di porre altre domande dopo la rimozione dell'accesso a un agente, vedrà 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.

Eliminare un agente di dati

Per eliminare un agente di dati:

1.Nella pagina Conversazioni, fai clic su sparkGestisci agenti nel riquadro a sinistra. 1. Apri il menu dell'agente scelto facendo clic sull'icona Altre opzioni, quindi fai clic 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 ripristinarlo 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 di dati

Per eliminare definitivamente un agente di 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.

Ripristinare un agente di dati dal cestino

Per ripristinare un agente di 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 l'icona , quindi fai clic su Ripristina.