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

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