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

# Chats

> A superfície de conversa com agentes — multi-thread, mentions, attachments, trace inline.

## Pra que serve

**Chats** é onde você conversa com os agentes da sua org. Cada
conversa é um **thread** independente — contexto não vaza entre
threads, e você pode ter dezenas em paralelo (um pra cada lead, um
pra cada projeto, um pra brainstorm livre).

Diferente de mensagens em board ou comentários em doc, a tela de
Chats é otimizada pra **diálogo iterativo**: histórico longo,
mensagens longas, ações que o agente executou ficam embutidas
visualmente.

## Anatomia da tela

<CardGroup cols={2}>
  <Card title="Lista de threads (sidebar)" icon="list">
    Threads ordenadas por última atividade. Pin pros que importam,
    archive pros que terminaram.
  </Card>

  <Card title="Header do thread" icon="user-tag">
    Nome do thread, agente ativo (com modelo), botão pra trocar
    persona, ações (export, archive, delete).
  </Card>

  <Card title="Histórico" icon="messages">
    Conversa renderizada com markdown (code blocks, listas,
    tabelas, embeds). Scroll infinito pra cima.
  </Card>

  <Card title="Composer" icon="keyboard">
    Onde você escreve. Suporta `@mentions` (envolve outro agente),
    `#leads` (linka lead), drop de arquivos, atalhos.
  </Card>
</CardGroup>

## Multi-persona

Cada thread tem **uma persona ativa** — geralmente o agente Chief
of Staff da org (ex.: "JARVIS"), ou um especialista (Scout,
Marcus, Athena).

Você troca a persona com:

* Botão **Persona** no header do thread → escolhe da lista
* Mention `@scout` na mensagem → Scout entra **só pra essa
  mensagem** (CoS continua dono do thread)
* `/persona scout` no início da mensagem → muda **persona padrão**
  do thread dali em diante

Cada agente carrega seu próprio **prompt + memória + ferramentas**
quando entra. CoS lê o histórico inteiro; especialistas leem o
trecho que motivou a chamada.

## Anatomia de uma mensagem do agente

Quando o agente responde, a mensagem pode conter mais que texto:

<AccordionGroup>
  <Accordion title="Resposta textual" icon="text">
    Markdown renderizado — código, listas, tabelas, links com
    preview. É o conteúdo principal.
  </Accordion>

  <Accordion title="Trace (passos)" icon="route">
    Quando o agente usou ferramentas (busca, leitura de docs,
    consulta de lead), aparece um bloco recolhido **Mostrar
    passos**. Expandir mostra cada ferramenta chamada, parâmetros,
    resultado. Sem mistério sobre como chegou na resposta.
  </Accordion>

  <Accordion title="Stars gastos" icon="star">
    Cada resposta mostra o **custo em Stars** dela (modelo + tokens

    * ferramentas usadas). Pendurado discretamente no rodapé da
      mensagem. Veja [Stars](/concepts/stars).
  </Accordion>

  <Accordion title="Citações" icon="quote-right">
    Quando agente baseou resposta em documentos da org, lead ou
    pesquisa externa, cada afirmação ganha **citação clicável**
    que abre a fonte. Veja [Brain](/features/brain).
  </Accordion>

  <Accordion title="Ações sugeridas" icon="bolt">
    Botões opcionais ao fim da resposta — ex.: "Criar task", "Mover
    lead pra próxima stage", "Mandar e-mail". Click executa direto
    sem você ter que repetir.
  </Accordion>
</AccordionGroup>

## Composer — o que dá pra fazer

| Ação                  | Como                                               |
| --------------------- | -------------------------------------------------- |
| **Mention de agente** | `@nome-agente` — envolve outro agente              |
| **Linkar lead**       | `#busca` → autocomplete; insere chip clicável      |
| **Linkar doc/board**  | `&busca` → autocomplete                            |
| **Anexar arquivo**    | Drag-drop, paste, ou click no clip                 |
| **Code block**        | ` ``` ` ou três backticks (markdown)               |
| **Voz**               | Click no microfone → fala → transcrição automática |
| **Enviar**            | `Enter` envia, `Shift+Enter` quebra linha          |

## Threads — organização

<Steps>
  <Step title="Novo thread">
    `⌘J` abre o agente CoS num thread novo. Ou click em **Chats** na
    sidebar → **+ Novo**.

    **Resultado esperado:** thread vazio com persona default da org.
  </Step>

  <Step title="Nomeie (opcional)">
    Por default, o título do thread vem do primeiro tópico da
    conversa (extraído automaticamente). Você pode editar a qualquer
    momento no header.
  </Step>

  <Step title="Pin os importantes">
    Pin pra fixar no topo da lista. Útil pros 2-3 threads ativos do
    seu dia.
  </Step>

  <Step title="Archive quando acabar">
    Click direito no thread → **Arquivar**. Some da lista ativa, mas
    aparece em **Arquivados** + continua indexado em busca.
  </Step>
</Steps>

## Slash commands

No composer, comece a mensagem com `/`:

| Comando           | O que faz                                                           |
| ----------------- | ------------------------------------------------------------------- |
| `/persona <nome>` | Muda persona padrão do thread                                       |
| `/clear`          | Limpa contexto (não apaga histórico — só pede pro agente recomeçar) |
| `/summarize`      | Pede resumo do thread inteiro                                       |
| `/export`         | Gera markdown exportável do thread                                  |
| `/help`           | Lista todos os comandos disponíveis                                 |

## Compartilhar threads

Threads são **privados por default** — só você vê. Você pode:

* **Compartilhar com membro específico** — outros veem o histórico
  * podem responder; agente trata todas as vozes como participantes
* **Compartilhar via link público (somente leitura)** — gera URL
  com expiração; quem abre não precisa de login

Útil pra mostrar pra colega um diálogo bom com agente, ou pra
arquivar conversa relevante pra retro.

## Histórico — busca + análise

A tela **Chats → Buscar** procura em todo histórico de threads:

* Substring no corpo das mensagens
* Filtro por persona / data / participantes
* Filtro por **threads que mencionam lead X / doc Y**

Útil quando você lembra "alguém perguntou pro Scout sobre concorrente
X mês passado" e precisa achar.

## Limites + caps

| Limite                   | Valor                                                                                               |
| ------------------------ | --------------------------------------------------------------------------------------------------- |
| **Threads ativos**       | Sem limite (UI scrolla, indexa)                                                                     |
| **Mensagens por thread** | Sem limite — mas thread muito longo (>500 mensagens) tem context window do modelo como teto efetivo |
| **Tamanho da mensagem**  | \~32k caracteres (mais que isso, parta em várias)                                                   |
| **Anexos**               | 25 MB por arquivo, sem teto agregado                                                                |

**Caps de gasto** do agente se aplicam — se a org bateu cap diário,
o agente recusa novas requisições com "Cap atingido. Avise o admin."
Veja [Caps](/billing/caps).

## Audit

Threads são registrados:

| Evento                | Inclui                                            |
| --------------------- | ------------------------------------------------- |
| `chat_thread_created` | Quem criou + persona inicial                      |
| `chat_message_sent`   | Quem mandou (user/agente) + persona + custo Stars |
| `chat_tool_called`    | Que ferramenta + parâmetros (não payload secreto) |
| `chat_shared`         | Pra quem + tipo (membro / link público)           |

Owner + Admin inspecionam em **Settings → Auditoria**.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Conheça os agentes" icon="robot" href="/agents/scout">
    Scout, Marcus, Athena, Twin — quem são, pra que servem.
  </Card>

  <Card title="Brain" icon="brain" href="/features/brain">
    De onde vem o conhecimento que o agente usa pra responder.
  </Card>

  <Card title="Stars" icon="star" href="/concepts/stars">
    Quanto cada conversa custa + como controlar o gasto.
  </Card>
</CardGroup>