Com os agentes de dados, você pode organizar a experiência das Análises de conversação para seus dados. 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
Pense em um agente de dados como outro tipo de conteúdo do Looker, como um painel, um Look ou uma pasta.
O uso de um agente de dados é gerenciado por uma combinação de acesso a conteúdo, dados e recursos. Para realizar as tarefas descritas na tabela a seguir, é necessário ter um papel do Looker com as permissões necessárias para os modelos que seu 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 do agente de dados |
|---|---|---|
| Criar, editar, compartilhar e excluir agentes |
Adicionado em 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 com instâncias do Looker na versão 25.18.10 ou mais recente. |
Adicionado em 25.18
save_agents |
Gerenciar acesso; Editar (esse acesso é concedido automaticamente se o usuário criar o agente. Caso contrário, o acesso Gerenciar acesso; Editar precisa ser concedido pelo criador do agente ao compartilhar o agente) |
| Conversar com um agente de dados na guia Agentes do Conversational Analytics | access_data (em cada modelo que contém as Análises usadas pelo agente de dados)
Adicionado em 25.18
chat_with_agent |
Acesso de visualização |
| Conversar com uma análise detalhada do Looker na guia Análises detalhadas das Análises de conversação | access_data (em cada modelo que contém as Análises usadas pelo agente de dados)
Adicionado em 25.18
chat_with_explore |
O Looker também tem as seguintes funções padrão que contêm subconjuntos dessas permissões para todos os modelos na instância:
- Gerente de agentes do Conversational Analytics: com essa função, um usuário pode criar, editar, compartilhar, excluir e conversar com agentes que têm acesso de Gerenciar acesso; Editar e conversar com as análises detalhadas.
- Usuário da análise de conversação: com essa função, um usuário pode conversar com um agente a que tem acesso de Leitura.
- Administrador: por padrão, essa função (administrador do Looker) tem todas as permissões e acesso ao conteúdo em toda a instância.
Um administrador do Looker pode conceder essas funções e permissões na página Funções 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 do administrador – Papéis.
O criador do agente de dados pode gerenciar o acesso de usuários individuais a ele compartilhando o agente.
Criar e editar agentes de dados
Para criar um novo agente de dados, siga estas etapas:
- Acesse a página Conversas.
- Na guia Agentes, selecione + Novo agente. Ou, no painel à esquerda, selecione sparkGerenciar agentes e clique em + Novo agente.
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 a finalidade do agente e como ele pode ser útil.
- Dados: siga estas etapas para se conectar a até cinco análises detalhadas do Looker:
- No campo Dados, clique em + Selecionar análises detalhadas.
- 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 detalhadas selecionadas da janela.
- Para adicionar a análise detalhada selecionada ao agente de dados, clique em Salvar.
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.
Se quiser ativar o Interpretador de Códigos para todas as conversas com seu agente, selecione Ativar as Análises Avançadas.
Se quiser, teste seu agente para refinar as instruções e configurações.
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, é possível fornecer os seguintes tipos de contexto no campo Instruções:
- Campos-chave: 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
Confira algumas instruções de exemplo 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 falar 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 "Total de vendas"
- Quando alguém diz "por produto", a menos que especifique "nome", agrupe por
product category - Pedidos "concluídos" significa que o status dos itens do pedido é "Concluído".
- Sempre que houver uma questão de linha do tempo ou ao longo do tempo, use
Order Item Created Datecomo o campo para agrupar por.
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:
- Na página Conversas, selecione sparkGerenciar agentes.
- Na página Gerenciar agentes, selecione o agente de dados que você quer editar.
- Atualize os detalhes do 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 Interpretador de código para seu agente.
- 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. Para compartilhar um agente de dados com outros usuários, conceda 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:
- Na página Conversas, selecione sparkGerenciar agentes no painel à esquerda.
- Abra o menu do agente escolhido clicando no ícone Mais opções e depois em Compartilhar.
- 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 incluir na lista compartilhada.
- 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.
- Depois de fazer todas as mudanças, clique em Salvar.
Você também pode compartilhar um agente que 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:
- Na página Conversas, clique em sparkGerenciar agentes no painel à esquerda.
- Abra o menu do agente escolhido clicando no ícone Mais opções e depois em Compartilhar.
- Clique no X ao lado do usuário ou dos grupos que precisam ter o acesso removido.
- 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.
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 manualmente 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:
- Acesse a página Conversas.
- No painel de navegação à esquerda, expanda a seção Lixeira.
- Para abrir o menu do agente escolhido, selecione o ícone e clique em Excluir permanentemente.
- 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:
- Acesse a página Conversas.
- No painel de navegação à esquerda, expanda a seção Lixeira.
- 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 para os principais recursos e 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íficas para seus dados. Isso ajuda a Análise de conversação a gerar respostas mais precisas e contextualmente relevantes.
Práticas recomendadas para configurar o Conversational Analytics no Looker: estratégias e práticas recomendadas para ajudar administradores do Looker e desenvolvedores de LookML a configurar, implantar e otimizar o Conversational Analytics.
Ativar a análise avançada com o Intérprete de código: o Intérprete de código no Conversational Analytics 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 Code Interpreter permite análises e visualizações mais complexas.