Agentes de dados no Data Studio

Os agentes de dados permitem-lhe organizar a experiência das Estatísticas de conversas para os seus dados. Quando cria um agente, pode disponibilizar-lhe contexto e instruções para 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.

A experiência do agente de dados das Estatísticas de conversas difere entre as Estatísticas de conversas antigas e as novas. Selecione o separador Antigo ou Novo para saber como as conversas funcionam em cada experiência.

Novo

Os agentes de dados das Estatísticas de conversas ficam disponíveis no Data Studio depois de serem criados no BigQuery e partilhados com os utilizadores do Data Studio.

Este separador orienta-o nas seguintes tarefas:

Criar e partilhar um agente de dados

Para criar um agente no BigQuery e conceder acesso a outros utilizadores para conversarem com ele no BigQuery e no Data Studio, siga os passos na página de documentação Criar agentes de dados. Assim que o agente de dados for publicado, aparece automaticamente na lista de agentes na página Conversar com os seus dados no Data Studio.

Também pode copiar um link do agente no BigQuery a partir do cartão do agente ou do painel Detalhes. No cartão do agente, selecione Abrir ações; de seguida, selecione Copiar link e, por fim, Data Studio. No painel Detalhes, selecione Copiar link do agente e, de seguida, Data Studio.

Editar um agente de dados

Os agentes de dados são editados no BigQuery. Pode editar o agente diretamente no BigQuery ou selecionar Editar no BigQuery no painel Detalhes do agente para abrir o agente a partir do Data Studio.

No BigQuery, pode revogar o acesso ao agente ou eliminá-lo.

Iniciar uma conversa com um agente

Para iniciar uma conversa com um agente de dados, siga estes passos:

  1. Navegue para a página Conversar com os seus dados.
  2. Selecione o agente de dados com o qual quer conversar. Se necessário, pode usar a barra Pesquisar agentes para limitar a pesquisa.
  3. Para iniciar a conversa, introduza a sua pergunta e prima Return (Mac) ou Enter (PC).

Para voltar à página Conversar com os seus dados e conversar com um agente de dados diferente, selecione + Nova conversa na navegação principal.

Pode voltar à conversa na secção Recentes.

Metadados do agente

O Data Studio apresenta informações sobre o agente de dados no cartão do agente e no painel Detalhes quando está a conversar com o agente.

Cartão do agente

O cartão do agente é apresentado na página Conversar com os seus dados. Apresenta as seguintes informações sobre o agente de dados:

  • Agente: o nome do agente, conforme escrito pelo criador do agente
  • Descrição: a descrição do agente, conforme escrita pelo criador do agente
  • Atualizado: a data/hora da última publicação do agente no BigQuery
  • Abrir ações: um menu com as seguintes opções:
    • Detalhes: abre o painel Detalhes
    • Editar no BigQuery: abre a configuração do agente no BigQuery
    • Copiar link: copia o link para o agente. Se colar este link num navegador Web, abre uma nova conversa com o agente.
    • Enviar feedback: abre um painel onde pode enviar feedback sobre a sua experiência com o agente

Detalhes do agente

O painel Detalhes é apresentado quando está a conversar com um agente de dados. Apresenta as seguintes informações sobre o agente de dados:

  • Agente: o nome do agente, conforme escrito pelo criador do agente
  • Descrição: a descrição do agente, conforme escrita pelo criador do agente
  • Um link para editar o agente no BigQuery
  • Um link para copiar o URL do agente de dados. Se colar este link num navegador, abre uma nova conversa com o agente de dados.
  • Fontes de conhecimento: as tabelas, as visualizações ou as funções definidas pelo utilizador (FDUs) do BigQuery que quer usar como fontes de conhecimento
  • Projeto: o Google Cloud projeto que contém o agente de dados
  • Etiquetas: as etiquetas atribuídas aos recursos do BigQuery, se existirem
  • Última publicação: a data/hora da última publicação do agente no BigQuery
  • Criado: a data/hora da criação do agente no BigQuery

Antigo

Este separador orienta-o nas seguintes tarefas:

Criar e editar agentes de dados

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

  1. Nas Estatísticas de conversas, na página Conversar com os seus dados, selecione o separador Agentes.
  2. Selecione + Criar agente. Em alternativa, no painel de navegação esquerdo, selecione Gerir agentes e, de seguida, + Criar agente.
  3. Na página Novo agente, faculte as seguintes informações sobre o agente de dados.

    • Nome do agente: introduza um nome para o agente. O nome deve ser único e descritivo.
    • Descrição: descreva brevemente o que este agente pode fazer e os dados que usa. 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 explica claramente a finalidade do agente e como pode ser útil.
    • Dados: siga estes passos para estabelecer ligação a uma origem de dados nova ou existente:

      1. No campo Dados, clique em Selecionar dados.
      2. Na janela Selecionar dados para o agente, clique no nome de uma origem de dados.
      3. Clique em Selecionar para adicionar a origem de dados selecionada ao agente de dados.

      Em alternativa, pode selecionar Estabelecer ligação a dados na janela Selecionar dados para o agente para criar uma nova origem de dados.

      Depois de selecionar uma origem de dados inicial, não pode selecionar uma nova origem de dados. Para gerir os campos apresentados no Looker Explore, selecione Ver campos.

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

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

Depois de guardar o agente de dados, pode partilhar o agente com outros utilizadores para que possam iniciar uma conversa com o agente.

Escrever instruções do agente

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

  • Sinónimos: termos alternativos para campos principais
  • 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

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 que os clientes "fiéis" são aqueles com Order Items Count > 5
  • Se alguém mencionar "Localização", significa Cidade do utilizador
  • Se a pergunta mencionar "Séniores", trata-se de utilizadores com User Age > 65
  • Se uma pergunta for sobre a receita, use as Vendas totais
  • 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 da encomenda é "Concluído"
  • Sempre que houver uma pergunta sobre uma cronologia ou ao longo do tempo, use sempre Order Item Created Date como o campo para agrupar

Testar um agente

Quando está a criar ou editar um agente, a página de detalhes do agente inclui o painel Pré-visualizar o 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 guardar for Changes not saved (Alterações não guardadas), as atualizações às definições não se refletem na pré-visualização.

Editar um agente de dados existente

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

  1. Nas Estatísticas de conversas, clique em Gerir 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 e Instruções.

    Embora não possa alterar a origem de dados associada a um agente no campo Dados, pode gerir os campos selecionando Gerir campos.

  4. Para guardar as alterações, clique em Atualizar.

Iniciar uma conversa com um agente

Pode iniciar uma conversa com um agente de dados que criou ou que outro utilizador partilhou consigo. Para iniciar uma conversa com um agente, siga estes passos:

  1. No painel de navegação esquerdo, clique em + Criar conversa.
  2. No separador Agentes, selecione o agente com o qual quer iniciar uma conversa.
  3. Escreva a sua pergunta e prima Return (Mac) ou Enter (PC) para iniciar a conversa.

Pode voltar à conversa na secção Recentes.

Partilhar agentes de dados

Apenas o proprietário de um agente de dados pode partilhar um agente. Os destinatários de um agente de dados partilhado podem ver a descrição do agente, mas não podem editá-lo. Depois de criar um agente, pode demorar alguns minutos até que possa ser partilhado.

Partilhar um agente de dados

Para partilhar um agente de dados, siga estes passos:

  1. Nas Estatísticas de conversas, clique em Gerir agentes.
  2. Passe o cursor do rato sobre o agente de dados e selecione Partilhar agente de dados ou selecione Partilhar enquanto edita um agente de dados existente.
  3. Pode convidar pessoas ou grupos Google específicos para partilhar o agente. Também pode partilhar de forma mais ampla ativando a partilha de links para um relatório.
  4. Depois de adicionar as pessoas ou os grupos à secção Pessoas com acesso, clique em Concluído.

O destinatário recebe um email com um link para o agente de dados e deve guardar esse link para utilização futura. Quando um utilizador seleciona Criar conversa, os agentes que foram partilhados com ele são apresentados em Agentes. Depois de um agente ser partilhado inicialmente, os utilizadores não podem ver as instruções desse agente. Inclua todas as informações relevantes na descrição do agente.

Revogar o acesso a um agente de dados

Para revogar o acesso a um agente, remova a pessoa ou o grupo da lista de Pessoas com acesso no menu Partilhar do agente. Se o utilizador removido tiver uma conversa em curso, continua 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.

Eliminar um agente de dados

Para eliminar um agente de dados, siga estes passos:

  1. Nas Estatísticas de conversas, clique em Gerir agentes.
  2. Na página Gerir agentes, passe o cursor do rato sobre o agente de dados que quer eliminar.
  3. Clique em Mais opções.
  4. Selecione Eliminar.
  5. Na janela Mover para o lixo, clique em Mover para o lixo para eliminar o agente de dados.

Os agentes que são movidos para o lixo são eliminados permanentemente após 30 dias. Pode eliminar permanentemente um agente de dados manualmente ou pode restaurar um agente de dados do lixo antes de ser eliminado permanentemente.

Eliminar permanentemente um agente de dados

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

  1. Navegue para as Estatísticas de conversas.
  2. No painel de navegação esquerdo, expanda a secção Lixo.
  3. Selecione o agente de dados que quer eliminar.
  4. Na janela Tem a certeza?, clique em Eliminar definitivamente.

Restaurar um agente de dados do lixo

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

  1. Navegue para as Estatísticas de conversas.
  2. No painel de navegação esquerdo, expanda a secção Lixo.
  3. Selecione o agente de dados que quer restaurar.
  4. Na janela Tem a certeza?, clique em Restaurar.