Criar e gerenciar agentes de dados

Os agentes de dados permitem que você organize a experiência de Análise Conversacional para seus dados. Com os agentes, você pode fornecer contexto e instruções para a Análise Conversacional, permitindo que ela responda a perguntas de maneira mais eficaz para 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, uma análise ou uma pasta.

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 25.18 admin_agents Nenhum acesso ao conteúdo precisa ser concedido
Criar, editar, compartilhar e excluir agentes Adicionado 25.18 save_agents

Os usuários podem criar agentes que usam apenas as análises para as quais receberam essa permissão no modelo subjacente. Para editar, excluir ou compartilhar um agente de dados criado por outro usuário, os usuários precisam receber um papel que contenha essa permissão em todos os modelos usados pelo agente.		 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 compartilhando o agente)
Conversar com um agente de dados na guia Agentes da Análise Conversacional access_data (em cada modelo que contém as análises usadas pelo agente de dados)

Adicionado 25.18 chat_with_agent (em cada modelo que contém as análises usadas pelo agente de dados)		 Acesso de leitura
Conversar com uma análise do Looker na guia Análises da Análise Conversacional access_data (em cada modelo que contém as análises usadas pelo agente de dados)

Adicionado 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álise conversacional: com esse papel, um usuário pode criar, editar, compartilhar, excluir e conversar com agentes para os quais tem acesso Gerenciar acesso; Editar e conversar com análises
  • Usuário de análise conversacional: 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 na 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 agente.

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, 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 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 Escrever instruções do agente.

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

  6. Opcionalmente, 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, você pode adicionar instruções de formato livre que definem o comportamento principal do agente de dados e fornecem um contexto fundamental a ser considerado antes de processar um comando do usuário.

Confira alguns exemplos dos tipos 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
  • Sinônimos: termos alternativos para campos principais
  • Consultas principais: pares de perguntas em linguagem natural e as consultas de análise correspondentes
  • Persona: um papel ou especialização, caráter ou tom que você atribui ao agente

Confira algumas instruções de exemplo para ajustar e testar com seu agente:

Agent Instructions

You are an expert e-commerce analyst. When answering questions about our sales
data, adhere to the following definitions and patterns:

Default Filtering: Unless stated otherwise, always filter the data on Order
Items Created Year = 2024. Customer Loyalty: We consider "loyal" customers to be
those with Order Items Count > 5. Business Terms:  "Successful" orders are those
where Order Items status = "Complete".  "Revenue" always refers to the Total
Sales field.  "Location" means User City. Grouping Rules: When someone says "by
product", unless they specifically say "name", group by product category.

Looker Golden Queries

Pay close attention to the patterns in the provided golden query below. Use it
as a primary reference for generating Looker queries that are
related to revenue and order status:

Question: "How much revenue did we generate from successful orders in 2024?"
Looker query:
    Model: thelook_ecommerce
    Explore: order_items
    Fields: [order_items.total_sales]
    Filters: [{field: order_items.status, value: "Complete"},
    {field: order_items.created_year, value: "2024"}]

Always keep these patterns and definitions in mind when generating your answers.

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. 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 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.

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 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.

Você também pode compartilhar um agente que 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 à esquerda.
  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

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 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 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 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.