Perguntas Frequentes (FAQ)
Respostas rápidas para as dúvidas mais comuns sobre a plataforma DATTA — o que ela é, o que precisa para rodar, quem controla o quê e o que fazer quando algo não aparece na tela. Cada resposta aponta para o guia completo do assunto, para quando você quiser ir além do resumo.
O que é o DATTA?
O DATTA é uma plataforma de dados e IA que roda na sua própria infraestrutura e combina Data Mesh, BI (DATTA BI), busca inteligente com chat, triagem automatizada de processos, motor BPM e um copilot multi-agente — tudo em um único produto, sem dependência obrigatória de nuvem.
Preciso de internet para usar a plataforma?
Não para o núcleo. Todos os componentes essenciais — Neo4j, OpenSearch, Kafka, Trino, o cache da plataforma e os serviços do DATTA — rodam dentro do seu ambiente. A única capacidade que usa API externa por padrão é o modelo de linguagem (Gemini). Em ambientes isolados, o administrador pode ativar o modo local com vLLM e modelos abertos — as funções de IA continuam disponíveis.
Em que idioma está a interface?
A interface da plataforma é em português do Brasil. Este portal de documentação está disponível em português e inglês — a troca de idioma fica no topo da barra lateral e a detecção inicial usa o idioma do seu navegador.
O que é um Contexto?
Contexto é o domínio de conhecimento em que você trabalha (por exemplo: CPC, CDC, processos tributários). Cada contexto tem sua própria base de grafo, índices de busca e regras de triagem — o conhecimento de um domínio não "vaza" para outro. O administrador cria contextos pela interface, em — veja Gerenciar Contextos.
Por que não encontro um dataset no catálogo?
Todo dataset precisa estar registrado no Knowledge Catalog, e conexões criadas pela plataforma disparam a catalogação automática (ACOC). Se um dataset não aparece, verifique nesta ordem:
- A conexão foi mesmo criada em ?
- O scan já terminou? Confira o andamento no painel de Execuções em Segundo Plano.
- Você tem permissão de visualização no workspace onde o dataset foi publicado?
Quem controla o que eu posso ver e fazer?
O controle de acesso da plataforma. Roles agregam permissões nomeadas (por exemplo DASHBOARD_WRITE, CONNECTION_CREATE, PLATFORM_VIEW) e toda ação é validada no servidor — esconder um botão nunca é a única barreira. Se algo aparece desabilitado ou retorna "acesso negado", fale com o administrador sobre a sua role — veja RBAC.
A triagem em lote não inicia. O que verificar?
A triagem usa o contexto ATIVO da sessão. Confirme, nesta ordem: (1) o contexto correto está selecionado; (2) existem regras de triagem publicadas para esse contexto; (3) há processos ingeridos na base do contexto. O passo a passo está em Triagem em Lote.
Quais formatos de arquivo posso enviar para ingestão?
PDF (incluindo digitalizados, com OCR), DOCX, HTML, TXT e formatos tabulares para dados estruturados. A lista completa, os limites de tamanho e o comportamento para arquivos muito grandes estão em Formatos Suportados.
O chat "inventou" uma resposta. Como reporto?
Toda resposta do chat exibe as fontes recuperadas. Se a resposta não cita fontes ou cita fontes erradas, use o botão de feedback da própria mensagem — isso alimenta a curadoria de conhecimento. Resposta sem fonte não deve ser usada como base de decisão.
Como acompanho tarefas demoradas (ingestão, scans, materializações)?
Pelo painel de Execuções em Segundo Plano, aberto pelo ícone de atividade no topo da tela. Ele mostra fila, progresso e resultado de cada tarefa, com selos de status como Executando e Na fila — veja Execuções em Segundo Plano.
Posso conectar ferramentas externas (DBeaver, BI, scripts) aos dados?
Sim. Neo4j (bolt), Trino (JDBC/HTTPS) e OpenSearch (HTTPS) são expostos com TLS, e os usuários de cada motor são gerenciados pelos consoles de administração. As URIs de conexão e exemplos prontos de cliente ficam nos subconsoles de cada motor — , e .
Dashboards sumiram do meu seletor. É bug?
Na maioria dos casos é workspace: dashboards pertencem a um workspace e o seletor mostra apenas o workspace ativo. Troque o workspace no topo do shell. Se o problema persistir depois de sair e entrar novamente, abra chamado com o administrador.
A plataforma guarda histórico das minhas conversas?
Sim, o histórico de conversas do chat é persistido e pesquisável — inclusive semanticamente. Ele pertence ao seu usuário e respeita as permissões de contexto vigentes no momento da consulta.
Onde encontro a documentação de operação (runbooks, infraestrutura)?
Na seção Plataforma & Operações deste portal, visível apenas para usuários autenticados com permissão de plataforma (PLATFORM_VIEW). Se você opera o ambiente e não vê a seção, solicite a permissão ao administrador.