O que é
Tavily é um motor de busca construído para agentes de IA. Diferente de uma API genérica de busca, o Tavily retorna snippets já estruturados pra grounding: cada resultado vem com URL fonte, score de relevância e snippet de contexto. O Scout usa o Tavily como motor primário em toda busca pública.Por que Tavily (e não algo “mais simples”)
| Alternativa | Por que NÃO é o default |
|---|---|
| Google search direto | Sem API pública estável + termos de uso restritivos |
| Web scraping genérico | Frágil, custoso, alto risco de bloqueio |
| Bing Search API | Funciona, mas Tavily entrega resultados melhor curados pra LLM |
| Anthropic web_search (nativo) | É usado como fallback quando Tavily não está disponível |
Conexão (BYO key)
A integração é Bring Your Own Key:Crie conta no Tavily
tavily.com → free tier cobre testes iniciais.
Planos pagos pra volume maior.
A key é guardada criptografada e isolada por organização — outro
cliente Apollo Space não vê sua key. Veja Segurança.
Tier de busca
O Tavily expõe dois tiers de busca:| Tier | O que entrega | Quando faz sentido |
|---|---|---|
| Basic | Resposta rápida, snippets curtos | Pesquisa exploratória, queries simples |
| Advanced | Conteúdo mais profundo + chunks maiores + processamento adicional | Análise crítica, fact-checking |
Fallback automático
Se a busca pelo Tavily falha (chave não configurada, rate limit externo da Tavily, erro de rede), o Scout cai automaticamente proweb_search nativo do Anthropic — você não vê interrupção, só uma
nota no trace indicando o fallback foi usado.
Cap por org
Pra proteger sua chave Tavily de exhaust acidental (loop de buscas em debugging, agente mal configurado), o Apollo Space aplica um cap interno de buscas-por-segundo por organização. Quando o cap dispara:- A busca atual cai pro fallback (Anthropic) por um período curto
- O cap-fire fica registrado no histórico de eventos da org
- Após o cooldown, o Tavily volta a ser usado normalmente
Modo dry-run pra desenvolvimento
Em ambientes de teste/dev, o Apollo Space opera por default em dry-run: o Scout retorna 3 snippets canned (com URLs claramente marcadas comoexample.com) sem realmente chamar a Tavily.
Isso protege sua chave de queima em ambientes que não são produção.
Em produção o dry-run vem desligado por default.
Custos
| Onde cai | Quem paga |
|---|---|
| Busca Tavily (por chamada à API) | Sua conta Tavily direto |
| Orquestração do Scout (LLM + processamento Apollo Space) | Seu saldo de Stars |
Próximos passos
Scout — quem usa Tavily
A persona que dispara as buscas.
Stars
Como o uso do Scout (orquestração) entra no faturamento.
Apify (enrichment)
Pra busca em Google Maps + enrichment de site, o Apollo Space usa
Apify, não Tavily.