Criar e gerenciar agentes de dados do recurso Detalhar

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

O uso da Análise de Conversação é gerenciado por uma combinação de acesso ao conteúdo, acesso a dados e acesso ao recurso. Pense em um agente de dados como outro tipo de conteúdo do Looker, como um painel, uma análise ou uma pasta. Para interagir com agentes de dados, você precisa receber um papel do Looker que tenha 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 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 do usuário, consulte a tabela de permissões na página de documentação Configurar a Análise de Conversação no Looker.

Criar e editar agentes de dados

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 à 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 exclusivo 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 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 a Análise Avançada para todas as conversas com seu agente, selecione Ativar a Análise Avançada.

  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, 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 o comando de um 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
  • Consultas de ouro: pares de perguntas em linguagem natural e as consultas correspondentes da análise
  • Persona: um papel ou especialização, caráter ou tom que você atribui ao agente

Para dicas e práticas recomendadas para escrever instruções do agente, consulte a página de documentação Práticas recomendadas para configurar a Análise de Conversação no Looker.

Definir uma consulta de ouro do Looker

Para definir cada consulta de ouro do Looker para uma determinada análise, forneça valores para os dois campos a seguir:

  • natural_language_questions: a pergunta em linguagem natural que um usuário pode fazer
  • looker_query: a consulta de ouro do Looker que corresponde à pergunta em linguagem natural

Para o campo natural_language_questions, considere as perguntas que um usuário pode fazer sobre essa análise e escreva essas perguntas em linguagem natural. É possível incluir mais de uma pergunta no valor desse campo. Você pode receber o valor do campo looker_query dos metadados de consulta da análise.

As consultas de ouro são compatíveis com os seguintes campos:

  • model (string): o modelo do LookML usado para gerar a consulta. Esse é um campo obrigatório.
  • explore (string): a análise usada para gerar a consulta. Esse é um campo obrigatório.
  • fields[] (string): os campos a serem recuperados da análise, incluindo dimensões e métricas. Esse campo é opcional.
  • filters[] (string): os filtros a serem aplicados à análise. Esse campo é opcional.
  • sorts[] (string): a classificação a ser aplicada à análise. Esse campo é opcional.
  • limit (string): o limite de linhas de dados a ser aplicado à análise. Esse campo é opcional.

É possível recuperar os metadados de consulta da análise diretamente dela seguindo estas etapas:

  1. Na análise, selecione o menu Ações da análise , e, em seguida, Receber LookML.
  2. Selecione a guia Painel.
  3. Copie os detalhes da consulta do LookML. Por exemplo, a imagem a seguir mostra o LookML de uma análise chamada Itens de pedido:

Copie os metadados selecionados para uso na consulta de ouro do Looker:

  model: thelook
  explore: order_items
  fields: [order_items.order_id, orders.status]
  sorts: [orders.status, order_items.order_id]
  limit: 500

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.

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, em seguida, clique em Compartilhar.
  3. Depois de adicionar um indivíduo 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, em seguida, 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.

Publicar um agente de dados

Você pode publicar seu agente de dados no Gemini Enterprise, disponibilizando o contexto e a análise predefinidos do agente para um público mais amplo, incluindo usuários que não estão 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, o que ajuda os usuários a encontrar o melhor agente para as necessidades analíticas deles. Google Cloud

Antes de começar

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

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

  1. Editores de agentes de dados (recurso do Looker): publique o agente no Looker.
  2. Admin do Discovery Engine (papel do IAM): conceda acesso ao agente no Google Cloud console.
  3. Usuário do Gemini Enterprise (papel 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 admin do Looker precisa ativar a configuração Publicar no Gemini Enterprise na página Gemini no Looker no painel Admin.
  • Um admin do Looker precisa conceder a você um papel que contenha a publish_agent_externally permissão. Você também precisa poder editar um agente de dados.
  • A conta de serviço do Looker no Google Cloud projeto que hospeda o mecanismo do Gemini Enterprise precisa receber o papel do Identity and Access Management Admin 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 atribuição à conta de serviço do Looker, a página do mecanismo do Gemini Enterprise no Google Cloud console vai mostrar o erro "Falha ao alocar cota para a criação do agente". Um usuário com o papel do Identity and Access Management Admin do Discovery Engine precisa provisionar uma nova licença do Gemini Enterprise ou reatribuir uma licença atual para a conta de serviço do Looker.

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 publish_agent_externally permissão 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 Publicar configurações 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. A ativação dessa configuração publica o agente na instância do Gemini Enterprise que é mostrada na página Gemini no Looker no painel Admin.
  4. Depois de publicar o agente, você pode selecionar Compartilhar para conceder acesso a outros usuários do Looker ao agente de dados ou selecionar Iniciar conversa para abrir uma nova conversa com o agente de dados.

Conceder acesso ao agente no Gemini Enterprise

Para concluir as etapas descritas nesta seção, você precisa ter o papel do Identity and Access Management Admin do Discovery Engine para o Google Cloud projeto que contém o mecanismo do Gemini Enterprise.

Para conversar com um agente no Gemini Enterprise, um 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 Admin do Discovery Engine precisa atribuir ao usuário o papel do IAM Usuário do Gemini Enterprise para o Google Cloud projeto que contém o mecanismo do Gemini Enterprise.

Para conceder acesso a um usuário a um agente individual, o Admin do Discovery Engine precisa concluir as etapas a seguir no Google Cloud console:

  1. Acesse o Google Cloud projeto 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, em seguida, selecione 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 papéis de permissões de usuário ao agente, adicione cada usuário e atribua a eles o papel de 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 acessoUsuário do Gemini Enterprise para o Google Cloud projeto 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 a 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 do agente à sua identidade do Looker.

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.
  2. Abra o menu do agente escolhido clicando no ícone Mais opções e, em seguida, clique 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 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.