Com os agentes de dados, você pode organizar a experiência das Análises de conversação para seus dados. Ao criar com um agente, você pode fornecer contexto e instruções para responder 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.
A experiência do agente de dados de análises de conversação é diferente entre as análises de conversação legadas e novas. Selecione a guia Legado ou Novo para saber mais sobre como as conversas funcionam em cada experiência.
Novo
Os agentes de dados da Análise de conversas ficam disponíveis no Data Studio depois de serem criados no BigQuery e compartilhados com os usuários do Data Studio.
Essa guia orienta você nas seguintes tarefas:
- Criar e compartilhar um agente de dados
- Editar um agente de dados
- Iniciar uma conversa com um agente
- Metadados do agente
Criar e compartilhar um agente de dados
Para criar um agente no BigQuery e conceder a outros usuários acesso para conversar com ele no BigQuery e no Data Studio, siga as etapas na página de documentação Criar agentes de dados. Depois que o agente de dados for publicado, se você tiver permissão para conversar com ele, ele vai aparecer automaticamente na lista de agentes na página Conversar com seus dados do Data Studio.
Editar um agente de dados
Os agentes de dados são editados no BigQuery. Você pode editar o agente no BigQuery diretamente ou selecionar Editar no BigQuery no painel Detalhes do agente para abrir o agente no Data Studio.
No BigQuery, você pode revogar o acesso ao agente ou excluí-lo.
Iniciar uma conversa com um agente
Para iniciar uma conversa com um agente de dados, siga estas etapas:
- Acesse a página Converse com seus dados.
- Selecione o agente de dados com quem você quer conversar. Se necessário, use a barra Pesquisar agentes para restringir sua pesquisa.
- Para iniciar a conversa, digite sua pergunta e pressione "Return" (Mac) ou "Enter" (PC).
Para voltar à página Chat com seus dados e conversar com outro agente de dados, selecione + Nova conversa na navegação principal.
Você pode voltar à conversa na seção Recentes.
Metadados do agente
O Data Studio mostra informações sobre o agente de dados no card dele e no painel Detalhes durante a conversa.
Card do agente
O card do agente aparece na página Conversar com seus dados. Ele mostra as seguintes informações sobre o agente de dados:
- Agente: o nome do agente, conforme escrito pelo criador dele
- Description: a descrição do agente, conforme escrita pelo criador dele.
- Atualizado: o carimbo de 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. Colar esse link em um navegador da Web abre uma nova conversa com o agente.
- Enviar feedback: abre um painel em que você pode enviar feedback sobre sua experiência com o agente.
Detalhes do agente
O painel Detalhes aparece quando você está conversando com um agente de dados. Ele mostra as seguintes informações sobre o agente de dados:
- Agente: o nome do agente, conforme escrito pelo criador dele
- Description: a descrição do agente, conforme escrita pelo criador dele.
- Um link para editar o agente no BigQuery
- Um link para copiar o URL do agente de dados. Colar esse link em um navegador abre uma nova conversa com o agente de dados.
- Fontes de conhecimento: as tabelas, visualizações ou UDF do BigQuery que você quer usar como fontes de conhecimento.
- Projeto: o projeto Google Cloud que contém o agente de dados
- Rótulos: os rótulos atribuídos aos recursos do BigQuery, se houver
- Última publicação: o carimbo de data/hora da última publicação do agente no BigQuery.
- Criado: o carimbo de data/hora de quando o agente foi criado no BigQuery.
Legado
Essa guia orienta você nas seguintes tarefas:
Criar e editar agentes de dados
Para criar um novo agente de dados, siga estas etapas:
- Em Análises de conversação, na página Converse com seus dados, selecione a guia Agentes.
- Selecione + Criar agente. Ou, no painel de navegação à esquerda, selecione
Gerenciar agentes e depois + Criar 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: 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. Por isso, explique claramente o objetivo do agente e como ele pode ser útil.
Dados: para se conectar a uma fonte de dados nova ou atual, siga estas etapas:
- No campo Dados, clique em Selecionar dados.
- Na janela Selecionar dados para o agente, clique no nome de uma fonte de dados.
- Clique em Selecionar para adicionar a fonte de dados escolhida ao agente de dados.
Você também pode selecionar Conectar aos dados na janela Selecionar dados para o agente para criar uma nova fonte de dados.
Depois de selecionar uma fonte de dados inicial, não é possível escolher outra. Para gerenciar os campos que aparecem na Análise do Looker, selecione Ver campos.
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.
Para salvar o novo agente de dados, clique em Salvar.
Depois de salvar o agente de dados, você pode compartilhar com outros usuários para que eles possam iniciar uma conversa.
Escrever instruções para o agente
Ao criar um agente de dados, é possível fornecer os seguintes tipos de contexto no campo Instruções:
- Sinônimos: termos alternativos para campos-chave
- 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
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 Changes 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:
- Em "Análise de conversas", clique em Gerenciar 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 e Instruções.
Não é possível mudar a fonte de dados associada a um agente no campo Dados, mas você pode gerenciar os campos selecionando Gerenciar campos.
Para salvar as alterações, clique em Atualizar.
Iniciar uma conversa com um agente
Você pode iniciar uma conversa com um agente de dados que você criou ou que outro usuário compartilhou com você. Para iniciar uma conversa com um agente, siga estas etapas:
- No painel de navegação à esquerda, clique em + Criar conversa.
- Na guia Agentes, selecione o agente com quem você quer conversar.
- Digite sua pergunta e pressione "Return" (Mac) ou "Enter" (PC) para iniciar a conversa.
Você pode voltar à conversa na seção Recentes.
Compartilhar agentes de dados
Somente o proprietário de um agente de dados pode compartilhar um agente. Os destinatários de um agente de dados pessoais compartilhados podem ver a descrição dele, mas não podem editar. Depois que um agente é criado, pode levar alguns minutos para que ele possa ser compartilhado.
Compartilhar um agente de dados
Para compartilhar um agente de dados, siga estas etapas:
- Em "Análise de conversas", clique em Gerenciar agentes.
- Passe o cursor sobre o agente de dados e selecione Compartilhar agente de dados ou selecione Compartilhar ao editar um agente de dados.
- Você pode convidar pessoas específicas ou Grupos do Google para compartilhar o agente. Para compartilhar com ainda mais usuários, também é possível ativar o compartilhamento de link.
- Depois de adicionar as pessoas ou os grupos à seção Pessoas com acesso, clique em Concluído.
O destinatário vai receber um e-mail com um link para o agente de dados e precisa salvar esse link para uso futuro. Quando um usuário seleciona Criar conversa, os agentes compartilhados com ele aparecem em Agentes. Depois que um agente é compartilhado inicialmente, os usuários não podem ver as instruções dele. 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 Compartilhar do agente. Se o usuário removido tiver uma conversa em andamento, ele ainda terá 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:
- Em "Análise de conversas", clique em Gerenciar agentes.
- Na página Gerenciar agentes, passe o cursor sobre o agente de dados que você quer excluir.
- Clique em Mais opções.
- Selecione Excluir.
- Na janela Mover para a lixeira, 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 de forma manual ou restaurar um agente de dados da lixeira antes que ele seja excluído permanentemente.
Excluir permanentemente um agente de dados
Para excluir permanentemente um agente de dados, siga estas etapas:
- Acesse as Análises de conversação.
- No painel de navegação à esquerda, expanda a seção Lixeira.
- Selecione o agente de dados que você quer excluir.
- 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 as Análises de conversação.
- No painel de navegação à esquerda, expanda a seção Lixeira.
- Selecione o agente de dados que você quer restaurar.
- Na janela Are you sure?, clique em Restore.