## 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":

1. **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.
2. **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.
3. **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 mapa montado a partir do corpus e dos dados reais
  da conta. Ele é uma árvore: a **conta**, quatro **domínios** (Entrada, Atendimento, Automação e
  Contexto), as **famílias** de cada domínio (caixas de entrada, canais, bots, times, macros,
  etiquetas, escopos e atributos personalizados) e, dentro delas, as **entidades**.
- A **barra** acima do mapa traz os indicadores da conta (entidades, relações, caixas com bot, sem
  vínculo), a busca e os controles. Clique em um indicador para **destacar no mapa** exatamente as
  entidades que explicam aquele número; **Limpar destaque** ou Esc volta ao normal. A **busca** lista
  os resultados por família e leva até a entidade escolhida.
- Os **chips** logo abaixo são a legenda: cada família e cada tipo de relação. Clicar em um chip
  **oculta ou mostra** aquela família ou aquele tipo; clicar duas vezes em uma família deixa só ela.
- Cada **domínio** mostra a cobertura real (por exemplo, "13 de 24 caixas com bot") e cada **família**
  mostra como se distribui (caixas por canal, atributos por escopo, quantas têm vínculo). Contas com
  muitas entidades abrem na **visão geral**; clique em uma família para abri-la ou use **Expandir
  tudo**. Famílias grandes mostram uma parte por vez, com **Mostrar as demais**.
- As linhas com seta são as **relações** que o Cérebro mapeou (por exemplo, "usa bot" ou "atribui ao
  time"). Entre famílias fechadas elas aparecem agrupadas, com o tipo e a quantidade; ao selecionar
  uma entidade, aparecem uma a uma. As linhas finas sem seta mostram apenas a que cada parte
  **pertence**.
- Clique em uma entidade para abrir o painel de detalhe com o **caminho até a conta**, o que o Cérebro
  sabe dela (canal, provedor, tipo, chave, escopo), as **relações por tipo** e, quando houver, as
  **fontes**. **Abrir no produto** leva à tela onde ela é configurada. Uma entidade **sem vínculo
  mapeado** continua no mapa e o painel explica o motivo: ou aquele tipo de vínculo ainda não foi
  mapeado nesta conta (use **Mapear agora**), ou já existe e nada aponta para ela.
- Em **Visualização** você escolhe a disposição (**Hierarquia** ou **Neural**), a densidade dos
  cartões (compacto, confortável ou detalhado), como as relações aparecem (feixes ou fios, rótulos,
  animação, tipos visíveis) e se o foco **isola** a vizinhança da seleção. As escolhas ficam
  guardadas neste navegador; **Restaurar padrão** desfaz tudo.
- A barra, a legenda, o minimapa e o zoom podem ficar **visíveis, compactos, minimizados ou ocultos**.
  O **modo limpo** (tecla H) deixa só o mapa, com **Mostrar controles** sempre à vista; a **tela
  cheia** usa toda a janela e Esc volta.

## 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.

## Veja também

- [O que é o Maestro IA e o Cérebro da Conta](/hc/ajuda/articles/maestro-brain-overview-pt-br)
- [Onboarding por voz e configuração assistida](/hc/ajuda/articles/maestro-brain-onboarding-por-voz-pt-br)
- [Departamentos, análise de risco e insights](/hc/ajuda/articles/maestro-brain-departamentos-risco-insights-pt-br)