Base de conhecimento e mapa do negócio (ontologia) do Cérebro

Abrir em

Ver como Markdown

Abrir no ChatGPT Abrir no Claude

Conversa Labs

Última atualização em Aug 18, 2026

Visão geral

O Cérebro da Conta tem duas peças que trabalham juntas:

A base de conhecimento (corpus) são as fontes que alimentam o Cérebro: documentos que você envia, páginas que você cola por URL e o objetivo/meta que você escreve sobre o seu negócio. Cada fonte é processada e quebrada em trechos indexados (os "chunks"), que o Maestro consulta para responder com referência à origem.
A estrutura ou mapa do negócio (ontologia) é o resultado consultável disso: um grafo de entidades (caixas de entrada, equipes, agentes de IA, etiquetas, atributos, macros, canais) e das relações entre elas, montado a partir do corpus somado aos dados reais da sua conta. É o "segundo cérebro" — o gêmeo digital — que o Maestro usa para entender a sua operação.

Em resumo: você alimenta a base de conhecimento e o Cérebro monta o mapa do negócio a partir dela. Quanto mais rico o corpus, melhores ficam as respostas, os riscos e os insights.

Pré-requisitos

Conta com o Maestro e o Cérebro da Conta habilitados (recurso account_brain). Se você não encontra a área, fale com um administrador.
Leitura é para qualquer membro da conta: ver as fontes e o mapa do negócio não exige permissão especial.
Adicionar ou remover fontes é exclusivo de administradores — o servidor revalida a permissão e a interface esconde os controles de envio/exclusão para quem não é administrador.

Passo a passo

Alimentar a base de conhecimento

Na aba Base de conhecimento (corpus), você tem três formas de "alimentar o Cérebro":

Enviar um documento: arraste o arquivo para a área de upload (ou clique para escolher) e confirme. O arquivo é guardado como anexo e o Cérebro o busca e extrai o conteúdo, transformando-o em trechos indexados.
Colar uma URL: cole o endereço de uma página e confirme. O Cérebro busca a página e extrai o conteúdo, do mesmo jeito que um documento.
Escrever o objetivo/meta da conta: descreva, em texto, o objetivo do seu negócio (há também um botão de ditado por voz para preencher falando). O objetivo é uma fonte fixa: ao salvar de novo, ele substitui o anterior em vez de duplicar.

Gerenciar fontes

A lista mostra cada fonte com a contagem de trechos indexados (chunks), e um resumo com o total de fontes e de trechos no topo — a prova de que o Cérebro foi alimentado.
Para remover uma fonte, use o ícone de exclusão (somente administradores) e confirme no diálogo. Remover uma fonte apaga todos os trechos dela do índice.

Ver o mapa do negócio (estrutura/ontologia)

Abra a aba de Estrutura (ontologia) para ver o grafo de entidades e relações montado a partir do corpus e dos dados reais da conta.
Clique em uma entidade para abrir o painel de detalhe com o tipo, as relações conectadas e, quando houver, as fontes (origem) daquele item.

Configurações & opções

Provedor de embeddings (administradores): no topo da base de conhecimento você escolhe qual provedor indexa e busca o conhecimento da conta (padrão da instalação, OpenAI ou Cohere). Ao trocar, a plataforma re-indexa todas as fontes automaticamente — aguarde o processamento terminar antes de avaliar a qualidade das respostas.
Três modos de entrada: documento, URL ou objetivo em texto — escolha o que fizer sentido para cada conteúdo.
Objetivo como fonte fixa: re-salvar o objetivo reindexa (substitui), nunca acumula duplicatas.
Contagem de trechos por fonte: indica quanto conteúdo foi efetivamente extraído e indexado.
Comportamento à prova de falha (cache-first): o mapa do negócio é guardado em cache, então a tela renderiza mesmo se o motor estiver momentaneamente fora do ar — em vez de mostrar erro.
Estado vazio que ensina: quando ainda não há conhecimento, a tela convida a alimentar a base em vez de exibir uma tela morta.

Casos de uso

Centralizar manuais, políticas, catálogos e FAQs para que o Maestro responda de forma consistente.
Registrar o objetivo do negócio para orientar as propostas e ações do copiloto.
Visualizar como caixas de entrada, equipes, agentes e atributos se conectam — útil para revisar a organização da conta.
Construir uma base sólida que melhora a análise de risco e os insights gerados por departamento.

Dicas, limites e boas práticas

Quanto mais rico e limpo o corpus, melhor: documentos atualizados e bem escritos geram riscos, insights e análises mais precisos.
Um objetivo claro melhora as propostas do copiloto e dos departamentos.
Evite enviar conteúdo desatualizado — informação velha gera sugestões velhas.
O mapa do negócio se popula com o tempo: alimente fontes e aguarde o processamento.
A indexação usa embeddings com fallback automático de provedor (ex.: OpenAI → Cohere). Conecte a chave Cohere em Integrações para a base continuar indexando mesmo se o provedor primário ficar sem créditos.

Solução de problemas

Fonte com 0 trechos: a extração não encontrou conteúdo — o formato pode não ser suportado, o arquivo pode estar vazio/protegido ou a URL pode estar inacessível. Tente outro formato ou reenvie.
Mapa do negócio (ontologia) vazio: o mapa NÃO vem das fontes que você envia — ele é montado a partir da estrutura real da conta (caixas de entrada, equipes, bots, etiquetas, atributos, macros). Ele é gerado quando a conta é criada e, depois disso, uma vez por dia. Numa conta criada logo após a atualização diária, o mapa fica vazio até a próxima. Use Mapear agora, na própria tela vazia, para montá-lo na hora — leva alguns segundos.
"Não foi possível mapear esta conta": o Maestro não conseguiu ler a estrutura da sua conta. Quase sempre é o token de acesso da conta usado pelo Maestro; peça a um administrador da instalação para revisá-lo e tente mapear de novo.
Ação bloqueada: enviar ou remover fontes é só para administradores. Se os controles não aparecem (ou a ação é recusada), confirme seu perfil com um administrador.
"Não foi possível indexar a fonte" / embeddings indisponíveis: nenhum provedor de embeddings está com chave e créditos válidos. Verifique os créditos do provedor primário (ex.: OpenAI) ou conecte uma chave Cohere em Integrações e tente novamente.
Modelo de embedding incompatível ao salvar um Robô: cada instalação armazena vetores com uma largura fixa. Escolha um modelo com a mesma dimensão indicada pela tela — numa instalação de 1536, use text-embedding-3-small em vez de text-embedding-3-large (3072). Depois de trocar um modelo já usado, reindexe a base para que os vetores antigos e novos não sejam misturados.