Criar e gerenciar agentes de dados do recurso Detalhar

Com os agentes de dados, você pode organizar a experiência de 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 de negócios para campos específicos, especifiquem os melhores campos para filtragem e definam cálculos personalizados.

Observação: esta página descreve os agentes de dados de análise, que consultam as análises. Para informações sobre agentes de dados para dashboards definidos pelo usuário e do LookML, consulte as páginas de documentação Consultar um dashboard definido pelo usuário com um agente de dashboard e Criar e gerenciar agentes de dados para dashboards do LookML, respectivamente.

Esta página orienta você nos seguintes processos:

• Criar e editar agentes de dados
• Compartilhar agentes de dados pessoais compartilhados com outros usuários
• Publicar agentes de dados em outros aplicativos
• Excluir agentes de dados

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, você precisa ter um papel do Looker com as permissões necessárias para os modelos que estão na base da 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 de Análise Conversacional Explore estão disponíveis quando um administrador do Looker ativa os seguintes recursos na página Administrador do Gemini no Looker:

• Análise conversacional:
  • Análise conversacional (página de conversas): ative essa configuração para permitir o acesso à página Conversas para agentes de dados com Análises e conversas diretas com uma Análise.
• Outras opções:
  • Análise avançada: para permitir que o agente use a Análise avançada, que traduz suas perguntas em linguagem natural para código Python e executa esse código para fornecer análises e visualizações avançadas, ative a configuração Análise avançada. Essa configuração é opcional.
• Ativar recursos do Trusted Tester
  • Agentic Workflows [pré-lançamento]: para criar Agentic Workflows que instruem o agente a monitorar mudanças nos seus dados.
  • Publicar no Gemini Enterprise [pré-lançamento]: para publicar seu agente no Gemini Enterprise, disponibilizando o contexto e as análises predefinidos do agente para um público mais amplo.

Criar e editar agentes de dados

Como uma tecnologia em estágio inicial, os produtos do Gemini para Google Cloudpodem gerar uma saída plausível, mas que é factualmente incorreta. Recomendamos que você valide todas as saídas dos produtos do Gemini para Google Cloud antes de usá-las. Para mais informações, consulte Gemini para Google Cloud e IA responsável.

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, em seguida, + Novo agente.

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

   • Nome do agente: insira um nome para o agente. O nome precisa ser exclusivo 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, explique claramente o objetivo do agente e como ele pode ser útil.
   • Dados: siga estas etapas para se conectar a até cinco análises do Looker:
     1. No campo Dados, clique em + Selecionar análises.
     2. Na janela Pesquisar análises detalhadas, clique nas análises que você quer incluir no agente de dados. Elas vão aparecer no painel Análises detalhadas selecionadas da janela.
     3. Para adicionar a Análise 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 ver exemplos dos tipos de contexto que você pode fornecer, consulte Como escrever instruções para o agente.

5. Se quiser, selecione Opções avançadas para expandir a seção e definir as seguintes configurações:

   • Ativar as Análises Avançadas: ative essa configuração para habilitar as Análises Avançadas em todas as conversas com seu agente.
   • Mostrar raciocínio: ative essa opção para permitir que o agente mostre as etapas de raciocínio, as consultas do Looker geradas e as tabelas de dados subjacentes em todas as respostas de cada conversa.
   • Mostrar informações de depuração: ative essa opção para permitir que o agente mostre as etapas executadas em todas as respostas de cada conversa.

6. Se quiser, você pode testar o agente para refinar as instruções e as configurações dele.

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.

Importante: embora o campo Instruções seja opcional e a estrutura fique a seu critério, recomendamos que você forneça instruções bem estruturadas para que o agente possa dar respostas mais precisas e relevantes.

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 o Conversational Analytics 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 correspondentes do recurso Explorar do Looker. 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, considere os seguintes limites:

• As consultas verificadas estão disponíveis apenas para agentes de dados do recurso Explorar. Eles não estão disponíveis para conversas diretas com uma análise detalhada ou para agentes de dados do painel.
• Você precisa usar uma Análise já definida para o agente. Se você fizer referência a uma Análise que não é usada pelo agente de dados, vai aparecer 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..
• As consultas verificadas não são compatíveis com consultas de análise 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

Dicas para definir consultas verificadas:

• Inclua diferentes tipos de perguntas e consultas com uma variedade de filtros e valores de filtro.
• Pense nas perguntas que um usuário pode fazer sobre essa Análise e escreva-as em linguagem natural.

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 da Análise, 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 que você quer excluir.
3. Clique em delete 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 visualização.

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 sobre o 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 pessoais compartilhados

O compartilhamento permite que outros usuários conversem com seu agente e as Análises dele. Para compartilhar um agente de dados com outros usuários, conceda acesso ao conteúdo do agente. Somente um usuário com as permissões e o acesso ao conteúdo adequados pode compartilhar um agente. Depois que um agente é criado, pode levar alguns minutos para que ele possa ser compartilhado.

Observação: conceder acesso ao conteúdo de um agente não dá acesso à análise detalhada que o agente usa. Ao compartilhar um agente, verifique se os usuários também têm as permissões necessárias para usar a Análise Conversacional com o modelo em que a análise detalhada se baseia. Talvez o administrador do Looker precise conceder essas permissões.

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 você quiser que os novos usuários ou grupos recebam um e-mail de notificação, marque a caixa de seleção Enviar um 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 devem 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

Visualizar

Este produto ou recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

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 talvez não estejam familiarizados com a interface do Looker. O Gemini Enterprise serve 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.

Observação:a integração do Looker com o Gemini Enterprise está em pré-lançamento com suporte limitado. Compartilhe seu feedback para nos ajudar a melhorar. Para informar bugs ou problemas, envie um e-mail para [e-mail] com os seguintes detalhes:

• Uma descrição clara do problema e do comportamento esperado
• Etapas para a reprodução do problema
• Outros detalhes relevantes

Antes de começar

O procedimento para criar um agente de dados no Looker e disponibilizá-lo para os usuários no Gemini Enterprise envolve tarefas que são realizadas na instância do Looker, na página do Gemini Enterprise no console do Google Cloud e na instância do Gemini Enterprise.

Os usuários com os papéis a seguir precisam seguir as etapas descritas nas seções associadas:

1. Editores de agentes de dados (recurso do Looker): publicar o agente no Looker.
2. Administrador do Discovery Engine (papel do IAM): conceda acesso ao agente no console Google Cloud .
3. Usuário corporativo 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 as configurações Ativar recursos de trusted testers e Publicar no Gemini Enterprise, além da configuração Análise Conversacional (página "Conversas"), 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 do Google Cloud que hospeda o mecanismo do Gemini Enterprise precisa receber o papel do Identity and Access Management de administrador do Discovery Engine. A concessão desse papel atribui uma licença do Gemini Enterprise à 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 do Google Cloud vai mostrar o erro "Falha ao alocar cota de alocação para a criação do agente". Um usuário com o papel de administrador do Discovery Engine do Identity and Access Management precisa provisionar uma nova licença do Gemini Enterprise ou reatribuir uma licença atual para a conta de serviço do Looker.

Observação: não é possível publicar agentes de dados no Gemini Enterprise para instâncias do Looker (Google Cloud Core) que usam uma conexão de rede particular ou híbrida. Para solicitar acesso a esse recurso em uma instância híbrida do Looker (Google Cloud Core), entre em contato com [e-mail] e informe o URL da instância.

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 as permissões e o acesso ao conteúdo 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 no painel de admin 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 aos usuários acesso ao agente no Gemini Enterprise

Para concluir as etapas descritas nesta seção, é preciso ter o papel do Identity and Access Management de Administrador do Discovery Engine no projeto do 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 Corporativo 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 seguir estas 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 que você quer conceder acesso.
6. Selecione a guia Permissões do usuário.
7. Selecione Adicionar usuário.
8. Na janela Adicionar permissões do 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 corporativo do Gemini Enterprise para o 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. Ao selecionar 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.

Republicar um agente de dados no Gemini Enterprise

Quando o Looker atualiza os recursos ou as capacidades do agente de dados, você precisa atualizar ou republicar o agente para que essas mudanças entrem em vigor no Gemini Enterprise.

O Looker 26.12 introduziu o suporte a gráficos nas respostas do agente. Se o agente foi criado antes do Looker 26.12, você precisa atualizar ou republicar o agente para que ele use gráficos nas respostas.

Para atualizar o agente, siga estas etapas:

1. Editar o agente de dados.
2. Modifique os metadados do agente.
3. Selecione Update.

Para republicar o agente de dados, siga estas etapas:

1. Edite o agente de dados.
2. Selecione Configurações de publicação para abrir a janela Configurações de publicação do agente.
3. Desative a opção Gemini Enterprise e selecione Atualizar.
4. Aguarde a remoção do agente do Gemini Enterprise.
5. No Looker, edite o agente de dados para reabrir a janela Configurações de publicação do agente.
6. Selecione Configurações de publicação, ative a opção Gemini Enterprise e selecione Atualizar.

Excluir um agente de dados

Atenção:os usuários com quem você compartilhou esse agente de dados não poderão fazer novas perguntas depois que você o excluir. No entanto, as conversas atuais com o agente de dados serão mantidas.

Se você excluir um agente, ele também será excluído e cancelado no Gemini Enterprise.

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, em seguida, 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, abra a seção Lixeira.
3. Para abrir o menu do agente escolhido, selecione o ícone e clique em Excluir permanentemente.
4. Na janela Você 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, abra a seção Lixeira.
3. Para abrir o menu do agente escolhido, selecione o ícone e clique em Restaurar.

Recursos relacionados

• Visão geral da Análise Conversacional no Looker: a página de destino da Análise Conversacional com uma lista de links para todos os recursos principais da documentação da Análise Conversacional.

• Consultar uma Análise em linguagem natural: inicie uma conversa com uma Análise do Looker para fazer perguntas sobre os dados dela usando linguagem natural.

• Consultar um painel definido pelo usuário com um agente de painel: consulte e configure agentes de painel em painéis definidos pelo usuário.

• Criar e gerenciar agentes de dados para dashboards do LookML: use o LookML para configurar e gerenciar agentes de dados com controle de versão para dashboards do LookML.

• Práticas recomendadas para configurar a Análise conversacional no Looker: estratégias e práticas recomendadas para ajudar administradores do Looker e desenvolvedores do LookML a configurar e otimizar a Análise conversacional.

• Ativar a análise avançada: a análise avançada na Análise Conversacional traduz suas perguntas em linguagem natural para código Python e executa esse código. Em comparação com as consultas padrão baseadas em SQL, o uso do Python pelo recurso de análise avançada permite análises e visualizações mais complexas.