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

# Agentes

> O que é um agente no Apollo Space: persona, ferramentas, memória, traces e orçamento.

## Anatomia de um agente

Um agente no Apollo Space é a soma de quatro coisas:

<CardGroup cols={2}>
  <Card title="Persona" icon="masks-theater">
    Tom, voz e comportamento. Define como o agente responde, em que
    idioma e com que formalidade — e o que ele sabe sobre a empresa
    dele.
  </Card>

  <Card title="Ferramentas" icon="screwdriver-wrench">
    O que o agente consegue fazer — pesquisar na web, enviar
    WhatsApp, criar lead, ler Notion. Cada ferramenta é uma função
    tipada com permissões próprias.
  </Card>

  <Card title="Memória" icon="brain">
    Conhecimento que persiste entre conversas. Pode ser **factual**
    (datas, preferências), **procedural** (jeitos que funcionaram)
    ou **semântica** (insights destilados de muitas conversas).
  </Card>

  <Card title="Orçamento" icon="star">
    Caps de gasto configuráveis pela org — garantia de que um loop
    inesperado não consome o saldo inteiro. Veja
    [Caps](/billing/caps).
  </Card>
</CardGroup>

## O que acontece numa conversa

Quando você manda uma mensagem pro agente, o Apollo Space executa esta
sequência por baixo dos panos:

```mermaid theme={null}
flowchart TD
    A[Mensagem do usuário] --> B[Abre trace]
    B --> C{Cabe no orçamento?}
    C -->|Bloqueado| Z[Resposta: cap atingido]
    C -->|OK| D[Agente decide ferramentas]
    D --> E{Precisa de tools?}
    E -->|Sim| F[Executa tools com permissões da org]
    E -->|Não| G[Compõe texto direto]
    F --> H[Registra consumo + debita Stars]
    G --> H
    H --> I[Responde no chat + fecha trace]
```

<Steps>
  <Step title="Abre o trace">
    Um **trace** começa — o registro completo do que o agente fez
    nessa conversa. Toda ação, custo e retorno fica gravado para
    replay e auditoria.
  </Step>

  <Step title="Confere o orçamento">
    Antes de qualquer ação cobrável, o Apollo Space confere se a chamada
    cabe nos limites — saldo da carteira + caps por org, agente e
    usuário. Veja [Caps](/billing/caps).
  </Step>

  <Step title="Agente escolhe as ferramentas">
    O agente decide quais tools chamar (ou nenhuma, se a resposta é
    só texto). Apollo Space executa cada uma com as permissões do agente +
    o isolamento da sua org.
  </Step>

  <Step title="Registra o consumo">
    Cada ação cobrável vira linha no histórico de uso da org. Os
    Stars são debitados da carteira na mesma operação — sem
    contabilidade paralela.
  </Step>

  <Step title="Fecha o trace">
    A resposta volta pro chat. O trace fica disponível via
    **Ver trace** — você inspeciona depois quando quiser.
  </Step>
</Steps>

## Tipos de agente

O Apollo Space vem com **agentes prontos** + permite criar **agentes
customizados**.

### Personas canônicas

O Apollo Space entrega **três personas principais** que cobrem o ciclo
comercial ponta-a-ponta:

<Tabs>
  <Tab title="Scout — Pesquisador">
    <CardGroup cols={2}>
      <Card title="O que faz" icon="binoculars">
        Busca pública na web via Tavily, análise de empresas,
        consolidação de informações com fontes citadas. Ideal para
        a fase de pesquisa e enriquecimento de leads.
      </Card>

      <Card title="Ferramentas principais" icon="screwdriver-wrench">
        Pesquisa web (Tavily), leitura de páginas, extração de
        contatos via Apify, análise de perfis públicos.
      </Card>
    </CardGroup>

    <Info>
      Toda pesquisa do Scout inclui links das fontes consultadas —
      você pode verificar a origem de cada informação.
    </Info>

    [Ver Scout em detalhe →](/agents/scout)
  </Tab>

  <Tab title="Marcus — Outbound">
    <CardGroup cols={2}>
      <Card title="O que faz" icon="paper-plane">
        Escreve e dispara sequências de e-mail + WhatsApp,
        aterrissando no inbox real do destinatário. Aprovação humana
        opcional antes de cada envio.
      </Card>

      <Card title="Ferramentas principais" icon="screwdriver-wrench">
        Envio de e-mail (Resend), WhatsApp via Twilio BYO-key,
        gerenciamento de sequências, registro de atividade no CRM.
      </Card>
    </CardGroup>

    <Warning>
      Para disparar e-mails ou WhatsApp, o Marcus precisa de pelo menos
      um canal conectado. Veja [Configurar WhatsApp](/guides/set-up-whatsapp).
    </Warning>

    [Ver Marcus em detalhe →](/agents/marcus)
  </Tab>

  <Tab title="Athena — Chief of Staff">
    <CardGroup cols={2}>
      <Card title="O que faz" icon="user-tie">
        Operadora multi-ferramenta — costura tasks entre CRM,
        integrações externas e ações do dia-a-dia. Pode operar como
        assistente org-level ou como Digital Twin de um líder.
      </Card>

      <Card title="Ferramentas principais" icon="screwdriver-wrench">
        Acesso total ao CRM (leads, pipelines, atividades), centenas
        de integrações via Composio, criação de tarefas, resumos de
        contexto.
      </Card>
    </CardGroup>

    <Info>
      A Athena tem **duas modalidades**: org-level (Chief of Staff genérico)
      e Digital Twin (configurada para representar um líder específico). São
      a mesma persona — o que muda é a configuração de voz e contexto.
    </Info>

    [Ver Athena em detalhe →](/agents/athena) · [Digital Twins →](/agents/digital-twins)
  </Tab>
</Tabs>

### Athena tem duas modalidades

A mesma persona Athena pode operar em dois modos distintos — você não
precisa "escolher entre Athena e Digital Twin":

<CardGroup cols={2}>
  <Card title="Athena org-level" icon="building">
    A instância default da Athena, ligada à organização como Chief of
    Staff genérico. Conhece o contexto da empresa, mas não fala "como"
    nenhum líder específico.
  </Card>

  <Card title="Digital Twin (Athena per-user)" icon="user-astronaut" href="/agents/digital-twins">
    A MESMA Athena configurada para representar uma pessoa específica
    (ex.: o CEO da empresa) — voz, decisões e contexto daquele líder.
    Aparece em conversas que ele não tem tempo de mediar.
  </Card>
</CardGroup>

<Info>
  Em termos técnicos: ambas as modalidades usam a mesma família de
  persona. A diferença é a configuração de voz, contexto e gatilhos
  por usuário — o Twin é um **uso da Athena**, não um agente paralelo.
</Info>

### Outras personas disponíveis

Além das três canônicas acima, o Apollo Space oferece um **catálogo de
personas especialistas** opt-in por org. Inclui Chief of Staff
específicos por função (financeiro, tecnologia, marketing) e
agentes focados em tarefas mais estreitas — escrita, design,
relacionamento pós-venda, análise competitiva, entre outros.

Essas personas são **opt-in** — você habilita só as que fazem sentido
pro seu time. Não há custo de "manter agente vivo" — o custo é sempre
por chamada efetivamente paga. A lista completa fica visível em
**Settings → Agentes → Catálogo** dentro do app.

### Customizados

Cada org pode criar agentes próprios com:

* **Persona own**: prompt de sistema próprio + tom/voz definidos
* **Tools próprias**: você habilita só as tools que esse agente precisa
* **Caps próprios**: pode ter cap diário diferente do default da org
* **Memória própria**: agentes não compartilham memória — cada um
  acumula seu próprio histórico

Veja [Criar agente customizado](/guides/invite-team) (em breve) para o
passo-a-passo.

## Audit trail

Toda ação de agente gera dois tipos de log:

| Log                  | Para que serve                                                                                     |
| -------------------- | -------------------------------------------------------------------------------------------------- |
| **Trace**            | Replay completo da conversa — cada decisão, cada tool call. Visível na UI via "Ver trace" no chat. |
| **Histórico de uso** | Uma linha por ação cobrável, com custo. Alimenta o painel de Faturamento + os caps.                |

Audit é **append-only** — nada é deletado quando uma conversa termina.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Scout" icon="binoculars" href="/agents/scout">
    Detalhes do agente de pesquisa.
  </Card>

  <Card title="Stars + caps" icon="star" href="/billing/stars">
    Como dimensionar orçamento por agente.
  </Card>

  <Card title="Integrações" icon="puzzle-piece" href="/integrations/composio">
    Que ferramentas externas seus agentes podem usar.
  </Card>

  <Card title="CRM" icon="users" href="/features/crm">
    Como agentes interagem com leads + pipelines.
  </Card>
</CardGroup>