> ## Documentation Index > Fetch the complete documentation index at: https://ajuda.head.dataguvi.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Usar o Datatalk IA > Faça perguntas sobre os dados da sua empresa em linguagem natural e receba respostas com números, tabelas e gráficos. O Datatalk IA responde perguntas sobre os dados da sua empresa. Você pergunta como perguntaria a um colega, por exemplo “Qual foi o faturamento por filial em maio de 2026?”, e ele consulta os dados e responde com texto, tabelas e gráficos. ## Antes de começar * O administrador precisa liberar para você o módulo **Datatalk IA** e pelo menos um [agente](https://ajuda.head.dataguvi.com.br/pt-BR/glossary.md#agente). * Confira a empresa selecionada no seletor do menu lateral. As conversas e os dados são de cada empresa. ## Como o Datatalk funciona * **Agentes.** Cada agente conhece um conjunto de dados da empresa, como as tabelas de um banco de dados ou um modelo do Power BI. O administrador configura os agentes e escolhe quem pode usar cada um. * **Você não escolhe o agente.** A cada pergunta, o Datatalk decide quais agentes consultar, e pode consultar mais de um ao mesmo tempo. Ele só usa os agentes liberados para você. * **Memória da conversa.** Dentro de uma conversa, o Datatalk lembra das últimas 15 perguntas e respostas. Por isso dá para continuar com “E em junho?” depois de perguntar sobre maio. * **Idioma.** Ele responde no idioma em que você perguntou. ## Fazer uma pergunta **1. Abra o Datatalk** No menu lateral, clique em **Inteligência › Datatalk IA**. **2. Escreva a pergunta** Digite no campo **Pergunte algo sobre seus dados...** e pressione `Enter` para enviar. Para quebrar a linha sem enviar, use `Shift` + `Enter`. Na tela inicial, você também pode clicar em uma das sugestões: ela preenche o campo para você ajustar antes de enviar. **3. Acompanhe o andamento** Enquanto trabalha, o Datatalk mostra o que está fazendo, como **Avaliando a pergunta**, **Consultando** um agente e **Sintetizando resposta**. Uma pergunta pode levar alguns minutos. Para interromper, clique em **Parar geração**. **4. Leia a resposta** Quando termina, aparece **Processado em**, com o tempo que levou. Clique ali para ver os passos que o Datatalk seguiu, como quais agentes consultou. ## Como perguntar para ter respostas melhores A regra de ouro: diga **o quê**, **de quando** e **como quer ver**. | Em vez de | Pergunte | | - | - | | Como estão as vendas? | Qual foi o total de vendas em maio de 2026, comparado com abril? | | Me mostra os clientes | Quais os 10 clientes com maior faturamento em 2026? | | E o estoque? | Qual o estoque atual de cada produto da categoria Bebidas? | | Faz um gráfico | Mostre em um gráfico de linhas o faturamento mensal de 2026. | * **Use os nomes que a sua empresa usa**, os mesmos dos relatórios e dashboards. * **Uma pergunta por mensagem.** Perguntas longas, com vários pedidos juntos, demoram mais e erram mais. * **Comece uma conversa nova ao mudar de assunto.** Clique em **Nova conversa**. O que foi dito antes pode confundir a resposta de um assunto diferente. * **Em conversas longas, repita o contexto.** O Datatalk só lembra das últimas 15 perguntas. Se a conversa for longa, repita o período e o filtro na pergunta. * **Desconfie e confira.** Se um número parecer estranho, pergunte “Quais filtros e qual período você usou?”. ## Entender a resposta * **Tabelas e gráficos.** O Datatalk monta um gráfico quando há pelo menos 3 valores para comparar, como em tendências, rankings e participações. Nos outros casos, ele usa uma tabela. Se quiser um gráfico, peça na pergunta. * **Nos gráficos**, alterne entre **Gráfico** e **Tabela**, use **Baixar imagem** para salvar em PNG e **Expandir** para ver em tela cheia. * **Quando não há dados**, o Datatalk diz que não encontrou a informação e o que falta na pergunta. Isso também acontece quando os dados estão em um agente que não foi liberado para você. Abaixo de cada resposta ficam as ações: | Ação | O que faz | | - | - | | **Copiar** | Copia o texto da resposta. | | **Perguntar novamente** | Envia a mesma pergunta de novo, como uma mensagem nova no fim da conversa. A resposta anterior continua lá. | | **Mais › Exportar como Markdown** | Baixa a resposta em um arquivo de texto. | | **Boa resposta** | Registra que a resposta foi útil. | | **Reportar problema ou sugerir melhoria** | Abre um campo para você contar o que está errado. | Para mudar uma pergunta que você já fez, passe o mouse sobre ela e use **Editar e reenviar**. A pergunta editada é enviada como uma mensagem nova no fim da conversa. ## Avaliar uma resposta As avaliações ajudam a melhorar o Datatalk. * **Boa resposta**: clique quando a resposta resolver. Para desfazer, clique de novo. * **Reportar problema ou sugerir melhoria**: descreva o que está errado em **Como podemos melhorar esta resposta?** e clique em **Enviar**. O comentário é obrigatório e tem até 500 caracteres. > [!TIP] > > Um bom comentário diz o que você esperava. Por exemplo: “O faturamento de maio deu R\$ 1,2 milhão, mas o dashboard de Vendas mostra R\$ 1,5 milhão.” ## Conversas * As conversas ficam no painel à esquerda. O título é criado a partir da primeira pergunta. * Cada pessoa vê só as próprias conversas, e cada empresa tem as suas. Ao trocar de empresa no menu lateral, a lista muda. * Para excluir, passe o mouse sobre a conversa, clique em **Mais opções** e em **Excluir conversa**. A exclusão não pode ser desfeita. > [!NOTE] > > O Administrador da Empresa e o Administrador do Conglomerado podem ler as conversas em **Segurança e Governança › Auditoria e Uso**, para acompanhar o uso e a qualidade das respostas. Conversas excluídas deixam de aparecer lá. ## Problemas comuns > [accordion] “Datatalk ainda não está disponível” > > A empresa ainda não tem um agente ativo. O administrador precisa configurar um em **Administração › Agentes**. > [accordion] “Você não tem acesso ao Datatalk. Fale com o administrador da sua empresa.” > > Falta a permissão no módulo **Datatalk IA**. Peça ao administrador. > [accordion] O Datatalk diz que não tem a informação > > * Reescreva a pergunta com o indicador, o período e o filtro. > * Use os nomes que aparecem nos dashboards da empresa. > * Se ainda assim não funcionar, os dados podem estar em um agente que não foi liberado para você. Peça ao administrador. > [accordion] “A consulta demorou mais do que o tempo limite e foi interrompida.” > > A pergunta passou de 20 minutos e a resposta não foi salva. Divida em perguntas menores ou use um período mais curto. > [accordion] A conexão caiu enquanto o Datatalk respondia > > Espere: a tela tenta recuperar a resposta sozinha por cerca de 2 minutos. Se ela não aparecer, abra a conversa de novo mais tarde, porque a resposta pode ter sido salva. > [accordion] “O serviço de IA está indisponível no momento.” > > O serviço que gera as respostas está fora do ar. Tente de novo em alguns minutos. > [accordion] “Desculpe, houve um erro ao processar sua pergunta. Tente novamente.” > > Clique em **Perguntar novamente**. Se o erro se repetir, reformule a pergunta ou comece uma **Nova conversa**. > [accordion] “Sua sessão expirou. Recarregue a página e entre novamente.” > > A sessão dura 12 horas a partir do login. Recarregue a página e entre de novo. Veja [Acessar a plataforma](https://ajuda.head.dataguvi.com.br/pt-BR/getting-started/sign-in.md). > [accordion] “Esta conversa não está mais disponível. Inicie uma nova.” > > A conversa foi excluída, por exemplo em outra aba. Clique em **Nova conversa**. > [accordion] “Nenhuma empresa selecionada” > > Escolha uma empresa no seletor do menu lateral. > [accordion] “Não foi possível confirmar sua identidade” > > Confira a sua conexão e clique em **Tentar novamente**. Se continuar, saia e entre de novo na plataforma. > [accordion] O número não bate com o dashboard > > Pergunte ao Datatalk quais filtros e qual período ele usou e compare com os do dashboard. Se a diferença continuar, use **Reportar problema ou sugerir melhoria** e conte os dois valores. > [accordion] O administrador liberou um agente, mas continua igual > > A liberação de agentes leva até 5 minutos para valer. Espere e recarregue a página. ## Para administradores * **Quem usa o quê.** Libere o módulo **Datatalk IA** em **Segurança e Governança › Controle de Acesso**. Depois, em **Administração › Agentes**, escolha quem pode usar cada agente. Veja [Gerenciar usuários, grupos e permissões](https://ajuda.head.dataguvi.com.br/pt-BR/access/manage-users-groups-permissions.md). * **Administradores usam todos os agentes ativos** da empresa, sem precisar de liberação. > [!WARNING] > > O Datatalk não aplica as regras de [RLS](https://ajuda.head.dataguvi.com.br/pt-BR/glossary.md#rls-regras-de-acesso-aos-dados) dos dashboards. Quem pode usar um agente consegue perguntar sobre todos os dados que esse agente consulta. Libere cada agente só para quem pode ver todos os dados dele. ## Quem pode ajudar * **O administrador da sua empresa** libera o Datatalk e os agentes. * **Respostas erradas ou incompletas**: use **Reportar problema ou sugerir melhoria** na própria resposta. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.