Criar e gerenciar agentes de dados

Os agentes de dados permitem que você organize a experiência de Análises de conversação para seus dados. Com agentes, é possível fornecer contexto e instruções para que as Análises de conversação respondam 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:

• Criar e editar agentes de dados
• Compartilhar agentes de dados
• Excluir agentes de dados

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

Antes de começar

Pense em um agente de dados como outro tipo de conteúdo do Looker, como um painel, uma análise ou uma pasta.

**Observação**: para compartilhar agentes de dados e usar as permissões descritas nesta seção, atualize sua instância do Looker para a versão 25.18.9 ou mais recente.

O uso de um agente de dados é gerenciado por uma combinação de acesso ao conteúdo, acesso aos dados e acesso ao recurso. Para realizar as tarefas descritas na tabela a seguir, você precisa receber um papel do Looker que tenha as permissões necessárias para os modelos que o agente de dados vai consultar e, em alguns casos, acesso ao próprio agente.

Tarefa	Permissões necessárias do Looker	Nível necessário de acesso ao agente de dados
Criar, editar, compartilhar e excluir agentes	Adicionado na versão 25.18 admin_agents	Nenhum acesso ao conteúdo precisa ser concedido
Criar, editar, compartilhar^* e excluir agentes ^* Esse recurso está disponível para usuários cujas instâncias do Looker estão na versão 25.18.10 ou mais recente.	Adicionado na versão 25.18 save_agents	Gerenciar acesso; Editar (esse acesso é concedido automaticamente se o usuário criar o agente. Caso contrário, o criador do agente precisa conceder o acesso Gerenciar acesso; Editar compartilhando o agente)
Conversar com um agente de dados na guia Agentes das Análises de conversação	access_data (em cada modelo que contém as análises usadas pelo agente de dados) Adicionado na versão 25.18 chat_with_agent	Acesso de leitura
Conversar com uma análise do Looker na guia Análises das Análises de conversação	access_data (em cada modelo que contém as análises usadas pelo agente de dados) Adicionado na versão 25.18 chat_with_explore

O Looker também tem os seguintes papéis padrão que contêm subconjuntos dessas permissões para todos os modelos na instância:

• Gerente de agentes de Análises de conversação: com esse papel, um usuário pode criar, editar, compartilhar, excluir e conversar com agentes para os quais tem acesso de Gerenciar acesso; Editar e conversar com análises.
• Usuário de Análises de conversação: com esse papel, um usuário pode conversar com um agente para o qual tem acesso de leitura.
• Administrador: por padrão, esse papel (administrador do Looker) tem todas as permissões e acesso ao conteúdo na instância.

Um administrador do Looker pode conceder esses papéis e permissões na página Papéis da seção Administrador da instância do Looker. Para mais informações sobre os papéis do Looker, consulte a página de documentação Configurações de administrador – Papéis.

O criador do agente de dados pode gerenciar o acesso de usuários individuais ao agente compartilhando-o.

Criar e editar agentes de dados

Como uma tecnologia em estágio inicial, os produtos do Gemini para Google Cloud podem 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 agente de dados, siga estas etapas:

1. Acesse a página Conversas.
2. Na guia Agentes, selecione + Novo agente. Ou, no painel esquerdo, 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: digite um nome para o agente. O nome precisa ser único e descritivo.
   • Descrição do agente: descreva brevemente o que esse 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. Portanto, verifique se a descrição explica claramente a finalidade 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, 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 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 Escrever instruções do agente.

5. Opcional: para ativar o Intérprete de código para todas as conversas com seu agente, selecione Ativar Análises Avançadas.

6. Opcional: você pode testar seu 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 do agente

Ao criar um agente de dados, é possível fornecer os seguintes tipos de contexto 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
• Sinônimos: termos alternativos para campos-chave

Dica: se você tiver um papel do Looker que permita editar o LookML, poderá definir sinônimos para os campos na análise usando o parâmetro synonyms do LookML.

Confira alguns exemplos de instruções para ajustar e testar com seu agente:

• A menos que indicado de outra forma, sempre filtre os dados em Order Items Created Year = 2024
• Consideramos clientes "fiéis" aqueles com Order Items Count > 5
• Se alguém disser algo sobre "Localização", isso significa "Cidade do usuário"
• Se a pergunta mencionar "Idosos", esses são usuários com User Age > 65
• Se uma pergunta for sobre receita, use "Vendas totais"
• Quando alguém diz "por produto", a menos que diga especificamente "nome", agrupe por product category
• Pedidos "bem-sucedidos" significa que o status dos itens do pedido é "Concluído"
• Sempre que houver uma pergunta sobre uma linha do tempo ou ao longo do tempo, sempre use Order Item Created Date como o campo para agrupar por

Testar um agente

Ao criar ou editar um agente, a página de detalhes do agente inclui o painel Visualizar o agente. Você pode testar as configurações e instruções do agente iniciando uma conversa com ele.

É necessário clicar em Atualizar para que uma mudança seja refletida na visualização. 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 os campos Nome do agente, Descrição do agente, Dados e Instruções. Você também pode ativar o Intérprete de código para seu agente.
4. Para salvar as alterações, clique em Atualizar.

Compartilhar agentes de dados

O compartilhamento permite que outros usuários conversem com seu agente e as análises dele. Você pode compartilhar um agente de dados com outros usuários concedendo 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 do usuário de um agente a um usuário não concede acesso à Análise que o agente usa. Ao compartilhar um agente, verifique se os usuários também têm as permissões necessárias para usar as Análises de conversação com o modelo em que a análise 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 esquerdo.
2. Abra o menu do agente escolhido clicando no ícone Mais opções e clique em Compartilhar.
3. Depois de adicionar uma pessoa ou grupos à seção Quem pode acessar esse agente e escolher o nível de permissões que eles devem ter, clique em Adicionar para colocá-los na lista compartilhada.
4. Se você quiser que 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 que todas as mudanças forem feitas, clique em Salvar.

Também é possível compartilhar um agente que você acabou de criar ou um que está editando clicando em Compartilhar na página de configurações do agente e seguindo 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 esquerdo.
2. Abra o menu do agente escolhido clicando no ícone Mais opções e clique em Compartilhar.
3. Clique no X ao lado do usuário ou dos grupos que devem ter o acesso removido.
4. Depois que todas as mudanças forem feitas, 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 forem 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.

Excluir um agente de dados

Cuidado: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 com o agente de dados são mantidas.

Para excluir um agente de dados, siga estas etapas:

1.Na página Conversas, clique em sparkGerenciar agentes no painel esquerdo. 1. Abra o menu do agente escolhido clicando no ícone Mais opções e clique 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 um agente de dados permanentemente manualmente ou pode 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 automaticamente.

Excluir um agente de dados permanentemente

Para excluir um agente de dados permanentemente, 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.

Recursos relacionados

• Visão geral das Análises de conversação no Looker: a página de destino das Análises de conversação com uma lista de links de recursos principais para toda a documentação das Análises de conversação.

• Criar e gerenciar agentes de dados: com os agentes de dados, é possível personalizar o agente de consulta de dados com tecnologia de IA fornecendo contexto e instruções específicos para seus dados, o que ajuda as Análises de conversação a gerar respostas mais precisas e contextualmente relevantes.

• Práticas recomendadas para configurar as Análises de conversação no Looker: estratégias e práticas recomendadas para ajudar os administradores do Looker e os desenvolvedores do LookML a configurar, implantar e otimizar as Análises de conversação.

• Ativar as Análises Avançadas com o Intérprete de código: o Intérprete de código nas Análises de conversação 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 Intérprete de código permite análises e visualizações mais complexas.