> ## 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](/pt/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](/pt/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>

## A hierarquia de agentes

Os agentes não são uma lista plana — eles formam um **organograma**, como
o de uma empresa de verdade. Cada nível delega para o de baixo e responde
para o de cima:

```mermaid theme={null}
flowchart TD
    DT["Digital Twin<br/>(pessoal — cruza as suas orgs)"] --> CoS["Chief of Staff<br/>(o agente da organização)"]
    CoS --> M["Gerentes por função<br/>(comercial, financeiro, operações...)"]
    M --> S["Especialistas<br/>(pesquisa, outbound, escrita, análise...)"]
```

* **[Digital Twin](/pt/agents/digital-twins)** — o seu agente **pessoal**,
  que cruza todas as organizações de que você participa e fala com a
  **sua** voz. É a manchete do Apollo.
* **[Chief of Staff](/pt/agents/athena)** (Athena) — o agente **da
  organização**: coordena o trabalho da empresa com voz neutra.
* **Gerentes e especialistas** — personas por função e por tarefa, que o
  Chief of Staff aciona conforme o trabalho.

<Info>
  O Digital Twin e o Chief of Staff são agentes **distintos**, com papéis
  diferentes — um representa a pessoa, o outro opera a empresa. Eles
  colaboram, mas não são "o mesmo agente em dois modos".
</Info>

## Tipos de agente

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

### Personas canônicas

O Apollo Space entrega personas que cobrem o trabalho do dia-a-dia — da
pesquisa ao fechamento, da operação ao backoffice. As três mais usadas:

<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 →](/pt/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](/pt/guides/set-up-whatsapp).
    </Warning>

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

  <Tab title="Athena — Chief of Staff">
    <CardGroup cols={2}>
      <Card title="O que faz" icon="user-tie">
        Operadora multi-ferramenta da organização — costura tasks entre
        CRM, integrações externas e ações do dia-a-dia, com a voz neutra
        da empresa.
      </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 é o **Chief of Staff da organização** — voz neutra, opera a
      empresa. Para o agente **pessoal** que fala com a voz de um líder,
      veja o [Digital Twin](/pt/agents/digital-twins) (agente distinto).
    </Info>

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

### Chief of Staff × Digital Twin

São **dois agentes distintos**, com papéis diferentes — não "dois modos
do mesmo agente":

<CardGroup cols={2}>
  <Card title="Chief of Staff (Athena)" icon="building" href="/pt/agents/athena">
    O agente **da organização**. Conhece o contexto da empresa e coordena
    o trabalho dela, mas fala com voz neutra — não "como" nenhum líder
    específico.
  </Card>

  <Card title="Digital Twin" icon="user-astronaut" href="/pt/agents/digital-twins">
    O agente **da pessoa** — pessoal, cruza todas as orgs dela e fala com
    a **voz** do líder. Aparece em conversas que ele não tem tempo de
    mediar.
  </Card>
</CardGroup>

<Info>
  Eles **colaboram**: o Twin de um líder delega à Athena quando o
  trabalho é da empresa; a Athena aciona o Twin quando uma comunicação
  precisa sair com a voz daquela pessoa. Papéis distintos, um time só.
</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](/pt/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="/pt/agents/scout">
    Detalhes do agente de pesquisa.
  </Card>

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

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

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