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

# Scout — o pesquisador

> A persona que busca informações públicas, analisa empresas e consolida snippets com citação.

## Para que serve

O **Scout** é o agente de **pesquisa pública**. Quando você precisa
saber algo que vive **fora da sua org** — uma empresa, um mercado, um
produto, uma pessoa pública, um artigo recente — você fala com o Scout.

Não é o agente certo pra:

* Mexer no seu CRM (esse é o [Marcus](/agents/marcus) ou
  [Athena](/agents/athena))
* Decidir/agir em nome da empresa (esse é a Athena)
* Conversar com cliente (Marcus, ou o Twin do líder)

## Como funciona

<Steps>
  <Step title="Você descreve o que quer saber">
    Exemplos:

    * *"Pesquise Magazine Luiza — modelo de negócio + tamanho do time"*
    * *"Quais são os 3 principais concorrentes da Linx?"*
    * *"O CEO da Stone fez declarações públicas sobre crypto em 2026?"*
  </Step>

  <Step title="Scout busca na web">
    A primeira escolha é o motor [Tavily](/integrations/tavily) (busca
    grounded em web pública). Se o Tavily não retorna nada útil — ou se
    sua org não tem chave configurada — o Scout cai pra o Anthropic
    web\_search nativo como fallback automático.
  </Step>

  <Step title="Scout monta a resposta">
    O retorno vem com **snippets citados**: cada afirmação está ligada
    à URL que foi a fonte. Sem citação = Scout não está afirmando
    aquilo (fica como hipótese explícita).
  </Step>

  <Step title="Você pode pedir aprofundamento">
    *"Vai mais fundo no item 2"* ou *"Lê o artigo 1 inteiro"* — o
    Scout dispara um `read_url` no link específico e volta com o
    conteúdo desempacotado.
  </Step>
</Steps>

## Ferramentas do Scout

| Ferramenta                   | Para que                                                       |
| ---------------------------- | -------------------------------------------------------------- |
| **Busca web**                | Pesquisa pública na web (motor primário + fallback automático) |
| **Leitor de URL**            | Lê o conteúdo de uma URL específica em profundidade            |
| **Scraping estruturado**     | Extrai dados de páginas complexas quando a busca não basta     |
| **Mineração de pain-points** | Extrai padrões repetidos em reviews públicos de Google Maps    |
| **Avaliação de site**        | Verifica se uma URL bate com um ICP / persona da sua org       |

Toda chamada gera trace + entrada no histórico de uso da org —
auditável via "Ver trace" no chat ou no painel de Faturamento. O
custo de cada ferramenta é debitado em [Stars](/billing/stars)
conforme a tabela de preços atual no painel.

## Limites de taxa

Para proteger a chave da sua org de exhaust acidental:

* **Cap por org** — um teto de buscas-por-segundo é aplicado por
  organização. Quando estoura, o Scout faz fallback automático pra
  um motor alternativo por um período curto, depois retoma.
* **Audit do cap-fire** — toda vez que o cap dispara fica registrado
  no histórico de eventos da org pra você acompanhar.

## Exemplos de prompts efetivos

### Pesquisa de empresa

```
Pesquise a empresa Petrobras:
1. Modelo de negócio
2. Top 3 produtos por receita
3. Iniciativas recentes em ESG (último ano)

Responda em bullets curtos. Cite a URL pra cada item.
```

### Análise competitiva

```
Quem são os 3 principais concorrentes do Pipefy hoje?
Pra cada um, traga: ICP atendido, preço médio, principal
diferencial técnico.
```

### Verificação de fato

```
Esse artigo afirma que a Stone teve queda de 40% no Q1/2026.
URL: <link>
Confirma ou refuta com fontes alternativas.
```

### Mineração de reviews (pain-points)

```
Mine pain-points dos reviews públicos no Google Maps das 10
maiores academias de São Paulo. Foco em padrões repetidos.
```

## Quando o Scout falha (e o que fazer)

| Sintoma                         | Causa provável                             | O que fazer                                                       |
| ------------------------------- | ------------------------------------------ | ----------------------------------------------------------------- |
| Resposta vaga / sem citações    | Motor de busca sem chave configurada       | Configure a chave do vendor no painel de integrações              |
| "Não encontrei nada" recorrente | Query muito ampla ou idioma errado         | Reformula em pt-BR específico OU em inglês                        |
| Cap fire por minutos            | Loop de buscas no chat                     | Pausa + revisa o prompt — o Scout não loopa sozinho normalmente   |
| Cita example.com nas fontes     | Modo de teste (dry-run) ligado no ambiente | Confira com o admin da org — em produção o default já é desligado |

## Próximos passos

<CardGroup cols={2}>
  <Card title="Motor de busca" icon="magnifying-glass" href="/integrations/tavily">
    Como conectar sua chave do motor de busca pública.
  </Card>

  <Card title="Marcus — outbound" icon="paper-plane" href="/agents/marcus">
    Quando o Scout termina a pesquisa, o Marcus pega e escreve a
    abordagem comercial.
  </Card>

  <Card title="Athena — operadora" icon="user-tie" href="/agents/athena">
    Pra pesquisa + ação no mesmo turno, a Athena costuma orquestrar
    melhor que o Scout direto.
  </Card>

  <Card title="Custos" icon="star" href="/billing/stars">
    Cada chamada do Scout debita Stars do wallet da org.
  </Card>
</CardGroup>