Crie e faça a gestão de agentes de dados

Os agentes de dados permitem-lhe organizar a experiência das Estatísticas de conversas para os seus dados. Com os agentes, pode fornecer às Estatísticas de conversas contexto e instruções para que possa responder a perguntas de forma mais eficaz para casos de utilização específicos. Os agentes permitem que os analistas mapeiem termos empresariais para campos específicos, especifiquem os melhores campos para filtragem e definam cálculos personalizados.

Esta página oferece orientações sobre os seguintes processos:

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

Antes de começar

Pense num agente de dados como outro tipo de conteúdo do Looker, como um painel de controlo, um Look ou uma pasta.

A utilização de um agente de dados é gerida através de uma combinação de acesso ao conteúdo, acesso aos dados e acesso a funcionalidades. Para realizar as tarefas descritas na tabela seguinte, tem de lhe ser atribuída uma função do Looker com as autorizações necessárias para os modelos que o seu agente de dados vai consultar e, em alguns casos, acesso ao próprio agente.

Tarefa Autorizações do Looker necessárias Nível de acesso do agente de dados necessário
Criar, editar, partilhar e eliminar agentes Adicionado 25,18 admin_agents Não pode ser concedido acesso a conteúdo
Criar, editar, partilhar e eliminar agentes Adicionado 25,18 save_agents

Os utilizadores podem criar agentes que usam apenas as explorações para as quais lhes foi concedida esta autorização no modelo subjacente. Para editar, eliminar ou partilhar um agente de dados criado por outro utilizador, os utilizadores têm de ter uma função que contenha esta autorização em todos os modelos usados pelo agente.		 Gerir acesso; Editar (este acesso é concedido automaticamente se o utilizador criar o agente; caso contrário, o acesso Gerir acesso; Editar tem de ser concedido pelo criador do agente através da partilha do agente)
Converse no chat com um agente de dados a partir do separador Agentes na análise conversacional access_data (em cada modelo que contém as explorações usadas pelo agente de dados)

Adicionado 25.18 chat_with_agent (em cada modelo que contém as explorações usadas pelo agente de dados)		 Acesso de visualização
Converse com um Looker Explore a partir do separador Explorações nas Estatísticas de conversas access_data (em cada modelo que contém as explorações usadas pelo agente de dados)

Adicionado 25,18 chat_with_explore

O Looker também tem as seguintes funções predefinidas que contêm subconjuntos destas autorizações para todos os modelos na instância:

  • Gestor do agente de estatísticas conversacionais: com esta função, um utilizador pode criar, editar, partilhar, eliminar e conversar com agentes para os quais tem acesso de gestão de acesso; edição e conversar com explorações
  • Utilizador do Analytics conversacional: com esta função, um utilizador pode conversar com um agente para o qual tem acesso de visualização
  • Administrador: por predefinição, esta função (administrador do Looker) tem todas as autorizações e acesso ao conteúdo na instância.

Um administrador do Looker pode conceder estas funções e autorizações na página Funções na secção Administração da instância do Looker. Para mais informações sobre as funções do Looker, consulte a página de documentação Definições de administração – Funções.

O criador do agente de dados pode gerir o acesso de utilizadores individuais ao agente partilhando o agente.

Crie e edite agentes de dados

Para criar um novo agente de dados, siga estes passos:

  1. Navegue para a página Conversas.
  2. No separador Agentes, selecione + Novo agente. Em alternativa, no painel do lado esquerdo, selecione sparkGerir agentes e, de seguida, selecione + Novo agente.

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

    • Nome do agente: introduza um nome para o agente. O nome deve ser exclusivo e descritivo.
    • Descrição do agente: descreva brevemente o que este agente pode fazer e os dados que utiliza. Os utilizadores veem esta descrição quando selecionam o agente para iniciar uma conversa ou quando partilha o agente com eles. Por isso, certifique-se de que a descrição explica claramente o objetivo do agente e como pode ser útil.
    • Dados: siga estes passos para estabelecer ligação a até cinco análises detalhadas do Looker existentes:
      1. No campo Dados, clique em + Selecionar explorações.
      2. Na janela Pesquisar explorações, clique nas explorações que quer incluir no agente de dados. Estas explorações são apresentadas no painel Explorações selecionadas da janela.
      3. Para adicionar a análise detalhada selecionada ao agente de dados, clique em Guardar.

  4. Instruções: forneça contexto para ajudar as Estatísticas de conversas a compreender como interagir com os seus dados e fornecer respostas precisas e relevantes. Para ver exemplos dos tipos de contexto que pode fornecer, consulte o artigo Escrever instruções do agente.

  5. Opcionalmente, para ativar o intérprete de código para todas as conversas com o seu agente, selecione Ativar estatísticas avançadas.

  6. Opcionalmente, pode testar o seu agente para refinar as instruções e as respetivas definições.

  7. Para guardar o novo agente de dados, clique em Guardar.

Depois de guardar o agente de dados, pode partilhá-lo com outros utilizadores e iniciar uma conversa com o agente.

Escreva instruções do agente

Quando cria um agente de dados, pode disponibilizar os seguintes tipos de contexto no campo Instruções:

  • Campos principais: os campos mais importantes para a 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

Seguem-se algumas instruções de exemplo para ajustar e testar com o seu agente:

  • Salvo indicação em contrário, filtre sempre os dados em Order Items Created Year = 2024
  • Consideramos clientes "fiéis" aqueles que têm Order Items Count > 5
  • Se alguém disser algo sobre "Localização", significa a cidade do utilizador
  • Se a pergunta mencionar "Idosos", refere-se a utilizadores com User Age > 65
  • Se uma pergunta for sobre a receita, use o total de vendas
  • Quando alguém diz "por produto", a menos que diga especificamente "nome", agrupe por product category
  • As encomendas "Bem-sucedidas" significam que o estado dos itens de encomenda é "Concluído"
  • Sempre que houver uma questão de cronologia ou ao longo do tempo, use sempre Order Item Created Date como o campo pelo qual agrupar

Teste um agente

Quando cria ou edita um agente, a página de detalhes do agente inclui o painel Pré-visualizar o seu agente. Pode testar as definições e as instruções do agente iniciando uma conversa com o agente.

Tem de clicar em Atualizar para que uma alteração se reflita na pré-visualização. Se o estado de gravação for Not saved, as atualizações às definições não são refletidas na pré-visualização.

Edite um agente de dados existente

Para editar um agente de dados existente, siga estes passos:

  1. Na página Conversas, selecione sparkGerir agentes.
  2. Na página Gerir agentes, selecione o agente de dados que quer editar.
  3. Atualize os detalhes sobre o agente conforme necessário. Pode modificar os detalhes que especificou quando criou o agente, incluindo os campos Nome do agente, Descrição do agente, Dados e Instruções. Também pode optar por ativar o interpretador de código para o seu agente.
  4. Para guardar as alterações, clique em Atualizar.

Partilhe agentes de dados

A partilha permite que outros utilizadores conversem com o seu agente e as respetivas explorações. Pode partilhar um agente de dados com outros utilizadores concedendo acesso ao conteúdo do agente. Apenas um utilizador com as autorizações e o acesso ao conteúdo adequados pode partilhar um agente. Depois de criar um agente, este pode demorar alguns minutos a ficar partilhável.

Para partilhar um agente de dados, siga estes passos:

  1. Na página Conversas, selecione sparkGerir agentes no painel do lado esquerdo.
  2. Abra o menu do agente escolhido clicando no respetivo ícone Mais opções e, de seguida, clique em Partilhar.
  3. Depois de adicionar um indivíduo ou grupos à secção Quem pode aceder a este agente e escolher o nível de autorizações que devem ter, clique em Adicionar para os colocar na lista partilhada.
  4. Se quiser que os novos utilizadores ou grupos recebam um email de notificação, selecione a caixa de verificação Enviar um email às pessoas que acabou de adicionar.
  5. Depois de fazer todas as alterações, clique em Guardar.

Também pode partilhar um agente que acabou de criar ou um que está a editar clicando em Partilhar na página de definições do agente e seguindo os passos mencionados acima.

Revogue o acesso a um agente de dados

Para revogar o acesso a um agente, siga estes passos:

  1. Na página Conversas, clique em faíscaGerir agentes no painel esquerdo.
  2. Abra o menu do agente escolhido clicando no respetivo ícone Mais opções e, de seguida, clique em Partilhar.
  3. Clique no X junto ao utilizador ou aos grupos cujo acesso deve ser removido.
  4. Depois de fazer todas as alterações, clique em Guardar.

Se os utilizadores removidos tiverem uma conversa em curso, continuam a ter acesso durante um ou dois minutos enquanto as alterações são propagadas.

Se um utilizador tentar fazer mais perguntas depois de o acesso a um agente ser removido, vê 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.

Elimine um agente de dados

Para eliminar um agente de dados, siga estes passos:

1.Na página Conversas, clique em sparkGerir agentes no painel esquerdo. 1. Abra o menu do agente escolhido clicando no respetivo ícone Mais opções e, de seguida, clique em Eliminar. 1. Na janela Eliminar agente?, clique em Mover para o lixo para eliminar o agente de dados.

Os agentes movidos para o lixo são eliminados permanentemente após 30 dias. Pode eliminar permanentemente um agente de dados de forma manual ou restaurar um agente de dados do lixo antes de ser eliminado permanentemente. Se não tomar medidas, o agente é eliminado permanentemente após 30 dias automaticamente.

Elimine permanentemente um agente de dados

Para eliminar permanentemente um agente de dados, siga estes passos:

  1. Navegue para a página Conversas.
  2. No painel de navegação do lado esquerdo, expanda a secção Lixo.
  3. Para abrir o menu do agente escolhido, selecione o respetivo ícone e, de seguida, clique em Eliminar permanentemente.
  4. Na janela Tem a certeza?, clique em Eliminar definitivamente.

Restaure um agente de dados do lixo

Para restaurar um agente de dados a partir do lixo, siga estes passos:

  1. Navegue para a página Conversas.
  2. No painel de navegação do lado esquerdo, expanda a secção Lixo.
  3. Para abrir o menu do agente escolhido, selecione o respetivo ícone e, de seguida, clique em Restaurar.