> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apollospace.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Brain — conhecimento da org

> Documentos, capturas de web e memórias que ficam disponíveis pros agentes da sua organização.

Peça pra um colega novo escrever um e-mail pra cliente no primeiro dia
e você recebe algo genérico — ele ainda não sabe como sua empresa
fala, pra quem você vende, nem o que você já prometeu. Seus agentes
começam do mesmo jeito. O **Brain** é a memória compartilhada que
resolve isso: escreva uma vez como a empresa funciona, e todo agente
passa a se apoiar nisso — em vez de você reexplicar o mesmo contexto a
cada tarefa.

## Por que existe

Agentes de IA são tão bons quanto o **contexto** que recebem. Se a
Athena não sabe nada sobre como sua empresa fala com clientes, ela
soa genérica. Se o Marcus não tem acesso ao deck de pitch que o time
criou, ele inventa argumentos do nada.

O **Brain** é onde esse contexto vive — documentos curados, capturas
de páginas relevantes, voice\_md da org, memórias acumuladas de
conversas anteriores. O mesmo acervo alimenta a Athena, a operadora que
toca sua org, os especialistas que trabalham sob ela e — restrito só a
você — seu Digital Twin. Tudo isolado por organização e versionado.

## O que você guarda no Brain

<CardGroup cols={2}>
  <Card title="Documentos" icon="file-lines">
    PDFs, markdowns, links, transcrições. Tipicamente: deck de
    pitch, ICP definido, voz da marca, FAQ interno, manual do produto.
  </Card>

  <Card title="Knowledge captures" icon="bookmark">
    Snippets clipados de páginas web durante a operação. Cada
    capture salva URL fonte + trecho + nota do humano que capturou.
  </Card>

  <Card title="Voice_md" icon="comment">
    Markdown que descreve a **voz da org** — tom, vocabulário,
    assinatura, política de cumprimento por canal. Editado pelo time,
    versionado, audited.
  </Card>

  <Card title="Memórias de agente" icon="brain">
    Conhecimento que cada agente acumula com o tempo — fatos
    aprendidos, preferências, decisões passadas. Não é um documento
    que você edita; é resultado de operação.
  </Card>
</CardGroup>

## Como agentes consultam o Brain

Nenhum agente trabalha do zero. Cada agente que precisa de contexto
faz uma **busca semântica** no Brain — não é texto exato, é "este
snippet é relevante pro que estou fazendo agora?".

Exemplos:

* **Marcus** compõe um e-mail → puxa o `voice_md` + o deck de pitch
  * capturas recentes sobre o lead em questão
* **Athena** responde uma pergunta interna → busca docs que tratam
  daquele tópico, cita as fontes
* **Scout** pesquisa um lead → cruza o achado público com o ICP do
  Brain pra dizer se é fit

## Upload de documentos

<Steps>
  <Step title="Settings → Brain → Upload">
    Arraste PDFs / MDs / arquivos de texto. Ou cole URLs que o Apollo Space
    vai baixar e indexar.
  </Step>

  <Step title="Apollo Space extrai + chunkifica">
    Texto é extraído, dividido em pedaços de tamanho útil pra busca
    semântica.
  </Step>

  <Step title="Embeddings rodam em background">
    Cada chunk vira um vetor numérico que representa seu significado.
    Quando um agente busca "voz da marca", o sistema acha os chunks
    semanticamente próximos — não só os com a palavra exata.
  </Step>

  <Step title="Disponível pros agentes">
    A partir do momento que o embedding termina (segundos a poucos
    minutos), todos os agentes da org já podem consultar.
  </Step>
</Steps>

## Knowledge captures (clipping)

Durante a navegação no Apollo Space (ex.: enquanto o Scout pesquisa,
enquanto você lê um artigo aberto via `read_url`), você pode
**capturar** trechos com 1 click.

Cada capture guarda:

* URL fonte
* Trecho selecionado (texto)
* Nota livre opcional sua
* Quem capturou + quando

Captures viram parte do Brain — agentes encontram nas buscas
semânticas a partir daí.

## Permissões — público vs pessoal

Brain do Apollo Space tem dois escopos:

<CardGroup cols={2}>
  <Card title="Público da org" icon="globe">
    Visível pra todos os membros + todos os agentes. Use pra:
    voice\_md, deck institucional, ICP, FAQ corporativo, capturas
    relevantes pro time inteiro.
  </Card>

  <Card title="Pessoal (per-user)" icon="user-lock">
    Visível só pra você + pros agentes operando "em seu nome"
    (incluindo seu [Digital Twin](/pt/agents/digital-twins)). Use pra:
    notas pessoais, contexto que só faz sentido pra você.
  </Card>
</CardGroup>

A separação é **fenced no banco** — outro membro da org não vê seu
brain pessoal mesmo se procurar manualmente.

## Busca: como funciona na prática

Você pode buscar no Brain manualmente também — não é só agentes:

* **Busca direta**: campo de search → digita o que quer encontrar
* **Filtros**: por tipo (doc / capture / voice), por data, por autor
* **Resultados rankeados** por relevância semântica, com fonte
  destacada

Útil pra "onde foi mesmo que eu vi essa informação sobre o cliente X?"
3 semanas depois.

## Limites e retenção

* **Tamanho de documento**: arquivos individuais até 100 MB. Pra
  documentos maiores, divida ou fale com suporte.
* **Total por org**: limite generoso que escala com o plano —
  detalhes em **Settings → Faturamento**.
* **Retenção**: documentos ficam **enquanto a org existir**. Se você
  cancela a conta, o Brain é deletado após o período de graça (90
  dias por default).
* **Export**: você pode exportar todo o Brain a qualquer momento
  (Settings → Brain → Export). Formato: ZIP com arquivos originais +
  manifesto JSON.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Athena — quem mais usa" icon="user-tie" href="/pt/agents/athena">
    Athena consulta o Brain a cada operação.
  </Card>

  <Card title="Marcus — usa o voice_md" icon="paper-plane" href="/pt/agents/marcus">
    Marcus carrega o voice\_md em toda composição.
  </Card>

  <Card title="Trust — isolamento" icon="shield-check" href="/pt/trust/multi-tenant">
    Como o Brain é isolado entre orgs.
  </Card>
</CardGroup>