Com os agentes de dados, você pode organizar a experiência de Análise Conversacional para seus dados. Ao criar com um agente, você pode fornecer contexto e instruções para que ele responda às perguntas de forma mais eficaz em casos de uso específicos. Os agentes permitem que os analistas mapeiem termos de negócios para campos específicos, especifiquem os melhores campos para filtragem e definam cálculos personalizados.
A experiência do agente de dados da Análise Conversacional é diferente entre a versão legada e a nova. Selecione a guia Legado ou Novo para saber mais sobre como as conversas funcionam em cada experiência.
Novo
Os agentes de dados da Conversational Analytics ficam disponíveis no Data Studio depois de serem criados no BigQuery e compartilhados com os usuários do Data Studio.
Esta guia orienta você nas seguintes tarefas:
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, ele vai aparecer automaticamente na lista de agentes na página Conversar com seus dados no Data Studio.
Também é possível copiar um link do agente no BigQuery no card do agente ou no painel Detalhes. No card do agente, selecione Abrir ações. Em seguida, selecione Copiar link e Data Studio. No painel Detalhes, selecione Copiar link do agente e, em seguida, Data Studio.
Editar um agente de dados
Os agentes de dados são editados no BigQuery. É possível editar o agente no BigQuery diretamente ou selecionar Editar no BigQuery no painel Detalhes do agente para abri-lo no Data Studio.
No BigQuery, é possível revogar o acesso ao agente ou excluí-lo.
Conversar com um agente
Os agentes de dados aparecem na página Conversar com seus dados. Para acessar a página Conversar com seus dados, selecione Análise Conversacional na navegação do Data Studio.
Para iniciar uma conversa com um agente de dados, siga estas etapas:
- Acesse a página Conversar com seus dados.
- Selecione o agente de dados com quem você quer conversar. Se necessário, use a barra Pesquisar agentes para restringir a pesquisa. Um agente pode ficar indisponível se você não tiver as permissões para acessar e conversar com ele. Também é possível restringir os agentes selecionando o projeto do Google Cloud no menu suspenso ao lado da barra de pesquisa. Quando você seleciona um projeto, apenas os agentes criados nele no BigQuery são exibidos.
- Para iniciar a conversa, digite sua pergunta e pressione Return (Mac) ou Enter (PC).
Para voltar à página Conversar com seus dados e conversar com um agente de dados diferente, selecione + Nova conversa na navegação principal.
Você pode voltar para a conversa na seção Recentes.
Saiba mais sobre um agente de dados
Os cards de agentes de dados e o painel Detalhes mostram informações importantes sobre os agentes de dados.
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.
- Descrição: a descrição do agente, conforme escrita pelo criador dele.
- Atualizado: o carimbo de data/hora de quando o agente foi publicado pela última vez 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. Ao colar esse link em um navegador da Web, uma nova conversa com o agente é aberta.
- 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.
- Descrição: 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. Cole esse link em um navegador para abrir uma nova conversa com o agente de dados.
- Fontes de conhecimento: as tabelas do BigQuery, visualizações ou funções definidas pelo usuário (UDF) que você quer usar como fontes de conhecimento.
- Projeto: o projeto do 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 de quando o agente foi publicado pela última vez no BigQuery.
- Criado: o carimbo de data/hora de quando o agente foi criado no BigQuery.
Legado
Esta guia orienta você nas seguintes tarefas:
- Criar e editar agentes de dados
- Iniciar uma conversa com um agente
- Compartilhar agentes de dados pessoais compartilhados
Criar e editar agentes de dados
Para criar um novo agente de dados, siga estas etapas:
- Na Análise Conversacional, na página Conversar com seus dados, selecione a guia Agentes.
- Selecione + Criar agente. Ou, no painel de navegação à esquerda, selecione
Gerenciar agentes e, em seguida, + 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: siga estas etapas para se conectar a uma fonte de dados nova ou atual:
- 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.
Como alternativa, selecione 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 a Análise Conversacional a entender como interagir com seus dados e fornecer respostas precisas e relevantes. Para ver 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 compartilhá-lo com outros usuários para que eles possam iniciar uma conversa com ele.
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 alguns exemplos de instruções 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 "fiéis" os clientes com
Order Items Count > 5 - Se alguém falar sobre "Localização", isso significa a cidade do usuário.
- Se a pergunta mencionar "Seniors", são usuários com
User Age > 65 - Se uma pergunta for sobre receita, use o total de vendas.
- Quando alguém disser "por produto", a menos que diga especificamente "nome", agrupe por
product category - Pedidos "bem-sucedidos" significa que o status dos itens do pedido é "Concluído"
- Sempre que houver uma pergunta sobre uma 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 visualização. Se o status de salvamento for Changes 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:
- Em Conversational Analytics, clique em Gerenciar agentes.
- Na página Gerenciar agentes, selecione o agente de dados que você quer editar.
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 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 iniciar uma conversa.
- Digite sua pergunta e pressione Return (Mac) ou Enter (PC) para iniciar a conversa.
Você pode voltar para a conversa na seção Recentes.
Compartilhar agentes de dados
Somente o proprietário de um agente de dados pode compartilhá-lo. Os destinatários de um agente de dados pessoais compartilhados podem ver a descrição do agente, mas não podem editá-lo. 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 Conversational Analytics, clique em Gerenciar agentes.
- Mantenha 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 deve 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, 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 Conversational Analytics, clique em Gerenciar agentes.
- Na página Gerenciar agentes, mantenha 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. É possível 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 a Análise Conversacional.
- No painel de navegação à esquerda, abra 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 a Análise Conversacional.
- No painel de navegação à esquerda, abra a seção Lixeira.
- Selecione o agente de dados que você quer restaurar.
- Na janela Você tem certeza?, clique em Restaurar.