Criar e gerenciar agentes de dados do recurso Detalhar

Com os agentes de dados, você pode organizar a experiência de Análise de conversação para seus usuários. Com os agentes, você pode fornecer contexto e instruções à análise de conversas para que ela responda a perguntas de maneira mais eficaz em casos de uso específicos. Os agentes permitem que os analistas mapeiem termos comerciais para campos específicos, especifiquem os melhores campos para filtragem e definam cálculos personalizados.

Esta página orienta você nos seguintes processos:

Saiba como e quando o Gemini para Google Cloud usa seus dados.

Antes de começar

O uso das Análises de conversação é gerenciado por uma combinação de acesso ao conteúdo, acesso aos dados e acesso ao recurso. Pense em um agente de dados como outro tipo de conteúdo do Looker, como um painel, um Look ou uma pasta. Para interagir com agentes de dados, é necessário ter um papel do Looker com as permissões necessárias para os modelos que embasam a Análise individual ou que o agente de dados vai consultar. Em alguns casos, você também vai precisar de acesso ao próprio agente. Para mais informações sobre as permissões e o acesso necessários para gerenciar e usar agentes de dados do usuário, consulte a tabela de permissões na página de documentação Configurar o Conversational Analytics no Looker.

Criar e editar agentes de dados

Para criar um novo agente de dados, siga estas etapas:

  1. Acesse a página Conversas.
  2. Na guia Agentes, selecione + Novo agente. Ou, no painel à esquerda, selecione sparkGerenciar agentes e clique em + Novo agente.

  3. Na página Novo agente, forneça as seguintes informações sobre seu agente de dados.

    • Nome do agente: insira um nome para o agente. O nome precisa ser único e descritivo.
    • Descrição do agente: descreva brevemente o que o agente pode fazer e os dados que ele usa. Os usuários vão ver essa descrição quando selecionarem o agente para iniciar uma conversa ou quando você compartilhar o agente com eles. Por isso, verifique se a descrição explica claramente o objetivo do agente e como ele pode ser útil.
    • Dados: siga estas etapas para se conectar a até cinco análises detalhadas do Looker:
      1. No campo Dados, clique em + Selecionar análises detalhadas.
      2. Na janela Pesquisar análises detalhadas, clique nas análises que você quer incluir no agente de dados. Essas análises vão aparecer no painel Análises detalhadas selecionadas da janela.
      3. Para adicionar a análise detalhada selecionada ao agente de dados, clique em Salvar.

  4. Instruções: forneça contexto para ajudar as Análises de conversação a entender como interagir com seus dados e fornecer respostas precisas e relevantes. Para exemplos dos tipos de contexto que você pode fornecer, consulte Como escrever instruções para o agente.

  5. Se quiser ativar as Análises avançadas para todas as conversas com seu agente, selecione Ativar as Análises avançadas.

  6. Se quiser, teste seu agente para refinar as instruções e configurações.

  7. Para salvar o novo agente de dados, clique em Salvar.

Depois de salvar o agente de dados, você pode compartilhar o agente com outros usuários e iniciar uma conversa com ele.

Escrever instruções para o agente

Ao criar um agente de dados, você pode adicionar instruções de formato livre que definem o comportamento principal dele e fornecem um contexto fundamental para considerar antes de processar um comando do usuário.

Confira alguns exemplos de contexto que você pode fornecer no campo Instruções:

  • Campos principais: os campos mais importantes para análise
  • Campos excluídos: campos que o agente de dados deve evitar
  • Filtragem e agrupamento: campos que o agente deve usar para filtrar e agrupar dados
  • Consultas de ouro: pares de perguntas em linguagem natural e as consultas do recurso Detalhar correspondentes
  • Persona: uma função ou especialidade, um personagem ou um tom que você atribui ao agente

Para dicas e práticas recomendadas sobre como escrever instruções para o agente, consulte a página de documentação Práticas recomendadas para configurar a Análise Conversacional no Looker.

Definir uma consulta de ouro do Looker

Para definir cada consulta de ouro do Looker para uma Análise específica, forneça valores para os dois campos a seguir:

  • natural_language_questions: a pergunta em linguagem natural que um usuário pode fazer
  • looker_query: a consulta de ouro do Looker que corresponde à pergunta em linguagem natural

Para o campo natural_language_questions, considere as perguntas que um usuário pode fazer sobre essa análise detalhada e escreva essas perguntas em linguagem natural. É possível incluir mais de uma pergunta no valor desse campo. É possível obter o valor do campo looker_query nos metadados da consulta do recurso Detalhar.

As consultas de ouro são compatíveis com os seguintes campos:

  • model (string): o modelo do LookML usado para gerar a consulta. Este campo é obrigatório.
  • explore (string): a Análise usada para gerar a consulta. Este é um campo obrigatório.
  • fields[] (string): os campos a serem recuperados da Análise, incluindo dimensões e métricas. Esse campo é opcional.
  • filters[] (string): os filtros a serem aplicados à Análise. Esse campo é opcional.
  • sorts[] (string): a classificação a ser aplicada à Análise. Esse campo é opcional.
  • limit (string): o limite de linhas de dados a ser aplicado à Análise. Esse campo é opcional.

Para recuperar os metadados da consulta da ferramenta Explorar diretamente dela, siga estas etapas:

  1. Na Análise, selecione o menu Abrir ações e clique em Receber LookML.
  2. Selecione a guia Painel.
  3. Copie os detalhes da consulta do LookML. Por exemplo, a imagem a seguir mostra o LookML de uma Análise chamada Order Items:

Copie os metadados selecionados para usar na sua consulta de ouro do Looker:

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

Testar um agente

Ao criar ou editar um agente, a página de detalhes dele inclui o painel Visualizar seu agente. Para testar as configurações e instruções do agente, inicie uma conversa com ele.

Clique em Atualizar para que uma mudança seja refletida na prévia. Se o status de salvamento for Not saved, as atualizações nas configurações não serão refletidas na prévia.

Editar um agente de dados

Para editar um agente de dados, siga estas etapas:

  1. Na página Conversas, selecione sparkGerenciar agentes.
  2. Na página Gerenciar agentes, selecione o agente de dados que você quer editar.
  3. Atualize os detalhes do agente conforme necessário. Você pode modificar os detalhes especificados ao criar o agente, incluindo os campos Nome do agente, Descrição do agente, Dados e Instruções. Você também pode ativar o Interpretador de código para seu agente.
  4. Para salvar as alterações, clique em Atualizar.

Compartilhar agentes de dados

Com o compartilhamento, outros usuários podem conversar com seu agente e as análises detalhadas dele. Você pode compartilhar um agente de dados com outros usuários concedendo acesso ao conteúdo dele. Somente um usuário com as permissões e acesso ao conteúdo adequados pode compartilhar um agente. Depois que um agente é criado, pode levar alguns minutos para que ele possa ser compartilhado.

Para compartilhar um agente de dados, siga estas etapas:

  1. Na página Conversas, selecione sparkGerenciar agentes no painel à esquerda.
  2. Abra o menu do agente escolhido clicando no ícone Mais opções e depois em Compartilhar.
  3. Depois de adicionar uma pessoa ou grupos à seção Quem pode acessar este agente e escolher o nível de permissões, clique em Adicionar para colocar na lista compartilhada.
  4. Se quiser que os novos usuários ou grupos recebam uma notificação por e-mail, marque a caixa de seleção Enviar e-mail para as pessoas que você acabou de adicionar.
  5. Depois de fazer todas as mudanças, clique em Salvar.

Também é possível compartilhar um agente que você acabou de criar ou um que está editando. Para isso, clique em Compartilhar na página de configurações do agente e siga as etapas mencionadas acima.

Revogar o acesso a um agente de dados

Para revogar o acesso a um agente, siga estas etapas:

  1. Na página Conversas, clique em sparkGerenciar agentes no painel à esquerda.
  2. Abra o menu do agente escolhido clicando no ícone Mais opções e depois em Compartilhar.
  3. Clique no X ao lado do usuário ou dos grupos que precisam ter o acesso removido.
  4. Depois de fazer todas as mudanças, clique em Salvar.

Se os usuários removidos tiverem uma conversa em andamento, eles ainda terão acesso por um ou dois minutos enquanto as mudanças são propagadas.

Se um usuário tentar fazer mais perguntas depois que o acesso a um agente for removido, ele vai receber a mensagem 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.

Publicar um agente de dados

Você pode publicar seu agente de dados no Gemini Enterprise, disponibilizando o contexto e a análise predefinidos do agente para um público mais amplo, incluindo usuários que não conhecem a interface do Looker. O Gemini Enterprise funciona como um hub central em que os usuários podem gerenciar agentes de dados criados em vários aplicativos do Google Cloud , o que ajuda a encontrar o melhor agente para as necessidades de análise.

O procedimento para criar agentes de dados de Análises de conversação no Looker e publicá-los para conversar no Gemini Enterprise envolve tarefas realizadas na instância do Looker, na página do Gemini Enterprise no console Google Cloud e na instância do Gemini Enterprise.

Para criar um agente de dados no Looker e disponibilizá-lo aos usuários no Gemini Enterprise, os usuários com as seguintes funções precisam seguir estas etapas, que são descritas em mais detalhes nas seções associadas:

  1. Editores de agentes de dados (recurso do Looker): publique o agente no Looker.
  2. Administrador do Discovery Engine (papel do IAM): conceda acesso ao agente no console Google Cloud .
  3. Usuário do Discovery Engine (papel do IAM); usuário do agente de dados (recurso do Looker): converse com o agente na instância do Gemini Enterprise.

Antes de começar

Antes de publicar um agente, os seguintes requisitos precisam ser atendidos:

  • Um administrador do Looker precisa ativar a configuração Publicar no Gemini Enterprise na página Gemini no Looker do painel Administrador.
  • Um administrador do Looker precisa conceder a você um papel que contenha a permissão publish_agent_externally. Você também precisa ter permissão para editar um agente de dados.

Publicar um agente de dados no Gemini Enterprise

Para concluir as etapas descritas nesta seção, você precisa ter um papel do Looker que contenha a permissão publish_agent_externally e o acesso a conteúdo e permissões adequados para editar agentes de dados.

Para publicar um agente, siga estas etapas:

  1. Edite o agente.
  2. Selecione Configurações de publicação para abrir a janela Configurações de publicação do agente.
  3. Na janela Configurações de publicação do agente, ative a configuração Gemini Enterprise e selecione Atualizar. Ao ativar essa configuração, o agente é publicado na instância do Gemini Enterprise que aparece na página Gemini no Looker do painel Administrador.
  4. Depois de publicar seu agente, selecione Compartilhar para conceder acesso a outros usuários do Looker ou Iniciar conversa para abrir uma nova conversa com o agente de dados.

Conceder acesso ao agente no Gemini Enterprise

Para concluir as etapas descritas nesta seção, você precisa ter o papel do Identity and Access Management Administrador do Discovery Engine no projeto Google Cloud que contém o mecanismo do Gemini Enterprise.

Para conversar com um agente no Gemini Enterprise, o usuário precisa ter acesso à instância do Gemini Enterprise e ao agente específico.

Para conceder acesso a um usuário à instância do Gemini Enterprise, um administrador do Discovery Engine precisa atribuir a ele o papel do IAM Usuário do Discovery Engine para o projeto Google Cloud que contém o mecanismo do Gemini Enterprise.

Para conceder a um usuário acesso a um agente individual, o administrador do Discovery Engine precisa concluir as seguintes etapas no console do Google Cloud :

  1. Acesse o projeto Google Cloud que contém o mecanismo do Gemini Enterprise.
  2. Abra a página do produto Gemini Enterprise.
  3. Selecione a página Apps na navegação principal e escolha o nome da instância do Gemini Enterprise.
  4. Na navegação principal, selecione Agentes.
  5. Selecione o agente a quem você quer conceder acesso.
  6. Selecione a guia Permissões do usuário.
  7. Selecione Adicionar usuário.
  8. Na janela Adicionar papéis de permissões de usuário ao agente, adicione cada usuário e atribua a eles a função Usuário do agente.

Conversar com o agente no Gemini Enterprise

Para concluir as etapas descritas nesta seção, você precisa ter o papel do Identity and Access Management Usuário do Discovery Engine no projeto Google Cloud que contém o mecanismo do Gemini Enterprise. Você também precisa ter as permissões e o acesso ao conteúdo adequados para conversar com o agente na instância do Looker.

Para conversar com um agente de dados em uma instância do Gemini Enterprise, siga estas etapas:

  1. Abra sua instância do Gemini Enterprise.
  2. Selecione Agentes na navegação principal.
  3. Na página Agentes, selecione o agente com quem você quer conversar. Quando você seleciona um agente, uma janela de conversa é aberta para que você possa fazer perguntas sobre seus dados.

Na primeira vez que você conversar com um representante, será necessário autorizar o acesso dele à sua identidade do Looker.

Excluir um agente de dados

Para excluir um agente de dados, siga estas etapas:

1.Na página Conversas, clique em sparkGerenciar agentes no painel à esquerda. 1. Abra o menu do agente escolhido clicando no ícone Mais opções e em Excluir. 1. Na janela Excluir agente?, clique em Mover para a lixeira para excluir o agente de dados.

Os agentes movidos para a lixeira serão excluídos permanentemente após 30 dias. Você pode excluir permanentemente um agente de dados de forma manual ou restaurar um agente de dados da lixeira antes que ele seja excluído permanentemente. Se você não fizer nada, o agente será excluído permanentemente após 30 dias de forma automática.

Excluir permanentemente um agente de dados

Para excluir permanentemente um agente de dados, siga estas etapas:

  1. Acesse a página Conversas.
  2. No painel de navegação à esquerda, expanda a seção Lixeira.
  3. Para abrir o menu do agente escolhido, selecione o ícone e clique em Excluir permanentemente.
  4. Na janela Tem certeza?, clique em Excluir definitivamente.

Restaurar um agente de dados da lixeira

Para restaurar um agente de dados da lixeira, siga estas etapas:

  1. Acesse a página Conversas.
  2. No painel de navegação à esquerda, expanda a seção Lixeira.
  3. Para abrir o menu do agente escolhido, selecione o ícone e clique em Restaurar.