Criar e gerenciar agentes de dados do recurso Detalhar

Com os agentes de dados, você pode organizar a experiência da Análise Conversacional 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 da Análise Conversacional é 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 dashboard, 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, consulte a tabela de permissões na página de documentação Configurar a Análise Conversacional no Looker.

Os agentes do recurso "Análise Conversacional" estão disponíveis quando um administrador do Looker ativa os seguintes recursos na página de administração do Gemini no Looker:

  • Análise Conversacional
  • Ativar recursos do Trusted Tester
    • Fluxos de trabalho agênticos [Prévia]: para criar fluxos de trabalho agênticos que instruem seu agente a monitorar mudanças nos seus dados.
    • Consultas verificadas [prévia]: para definir consultas verificadas, pares de perguntas em linguagem natural e consultas do recurso Detalhar correspondentes, como contexto para seu agente. Esse recurso de pré-lançamento está disponível apenas no Looker (original).
    • Publicar no Gemini Enterprise [Prévia]: para publicar seu agente no Gemini Enterprise, disponibilizando o contexto predefinido e a análise do agente para um público mais amplo.

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: digite 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 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 a Análise Conversacional 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, selecione Opções avançadas para abrir a seção e configurar as seguintes opções:

    • Mostrar raciocínio: ative essa opção para mostrar as etapas de raciocínio do agente, as consultas do Looker geradas e as tabelas de dados subjacentes nas respostas.
    • Mostrar informações de depuração: ative essa opção para mostrar as etapas executadas pelo agente em cada resposta e facilitar a solução de problemas.

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

  8. 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
  • 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 consultas verificadas

As consultas verificadas (também chamadas de consultas de ouro em algumas documentações do Google) são pares predefinidos de perguntas em linguagem natural e as consultas exatas e correspondentes do Looker Explore. Esses pares de perguntas e consultas funcionam como "padrões de ouro" verificados de verdade que ensinam o agente a lidar com solicitações comerciais complexas sem adivinhar. Consultas verificadas bem definidas podem ajudar a melhorar a precisão das respostas do agente de dados da Análise.

Limites das consultas verificadas

Ao usar consultas verificadas, lembre-se dos seguintes limites:

  • As consultas verificadas estão disponíveis apenas para agentes de dados do recurso Detalhar. Eles não estão disponíveis para conversas independentes ou agentes de dados do painel.
  • É necessário usar uma Análise já definida para o agente. Se você fizer referência a uma análise detalhada que não é usada pelo agente de dados, a mensagem de erro 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. vai aparecer.
  • As consultas verificadas não são compatíveis com as consultas do recurso Detalhar que contêm campos personalizados ou tabelas dinâmicas.
  • Embora não haja limite para o número de consultas verificadas que podem ser adicionadas, recomendamos incluir no máximo de 30 a 50 pares de perguntas e consultas por agente.

Criar uma consulta verificada

Para adicionar uma consulta verificada a um agente de dados novo ou atual, siga estas etapas:

  1. Crie um agente de dados ou edite um agente de dados que use pelo menos uma análise detalhada como fonte de dados.
  2. Na página de criação ou edição do agente, selecione + Adicionar consulta verificada.
  3. Em Adicionar consulta verificada, insira a pergunta em linguagem natural e a resposta correspondente:
    • Pergunta: insira uma pergunta em linguagem natural que um usuário pode fazer.
    • Resposta: cole o URL da análise que captura a consulta ou visualização correta.
  4. Para verificar a consulta do recurso Detalhar, clique em Visualizar.
    • Outra opção: deixe o campo Resposta em branco e clique em Visualizar para criar uma consulta do zero no criador de análises detalhadas e salve o URL resultante para usar.
  5. Clique em Salvar.

Editar uma consulta verificada

Para editar uma consulta verificada, siga estas etapas:

  1. Na conversa com o agente, selecione Editar agente.
  2. Em Consultas verificadas, encontre a consulta que você quer editar.
  3. Clique em Editar consulta verificada.
  4. Na caixa de diálogo Editar consulta verificada, faça mudanças na pergunta ou na resposta.
  5. Clique em Salvar.

Excluir uma consulta verificada

Para excluir uma consulta verificada, siga estas etapas:

  1. Na conversa com o agente, selecione Editar agente.
  2. Em Consultas verificadas, encontre a consulta que você quer excluir.
  3. Clique em Excluir consulta verificada.

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. É possível modificar os detalhes especificados ao criar o agente, incluindo as configurações de Nome do agente, Descrição do agente, Dados, Instruções e Opções avançadas. 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 um e-mail de notificação, 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 as análises 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.

Antes de começar

O procedimento para criar um agente de dados no Looker e disponibilizá-lo aos usuários 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.

Os usuários com as seguintes funções precisam seguir as etapas descritas 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 Gemini Enterprise (função do IAM); usuário do agente de dados (recurso do Looker): converse com o agente na instância do Gemini Enterprise.

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.
  • A conta de serviço do Looker no projeto Google Cloud que hospeda o mecanismo do Gemini Enterprise precisa receber o papel do Identity and Access Management Administrador do Discovery Engine. Ao conceder essa função, uma licença do Gemini Enterprise é atribuída à conta quando o primeiro agente de dados é publicado. Se não houver licenças do Gemini Enterprise disponíveis para atribuir à conta de serviço do Looker, a página do mecanismo do Gemini Enterprise no console Google Cloud vai mostrar o erro "Falha ao alocar cota para criação de agente". Um usuário com o papel do Identity and Access Management Administrador do Discovery Engine precisa provisionar uma nova licença do Gemini Enterprise ou reatribuir uma licença atual para a conta de serviço do Looker.

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 exibida na página Gemini no Looker, no painel Administrador.
  4. Depois de publicar o 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 individual.

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 Gemini Enterprise no 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 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 Gemini Enterprise 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 agente, 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.
  2. Abra o menu do agente escolhido clicando no ícone Mais opções e clique em Excluir.
  3. 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.