Tavily — busca web

Você pergunta ao pesquisador do time: “o que o concorrente acabou de anunciar?” Um minuto depois você tem a resposta — com os links de fonte por trás de cada linha, não um chute confiante a partir de treino desatualizado. Esse pesquisador é o Scout, alcançando a web ao vivo em nome da org, e o Tavily é o motor com que ele busca. O que isso tira do seu colo: ninguém precisa abrir dez abas, ler por cima e colar links de volta num doc. A busca, a leitura e a citação acontecem por você.

​

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”)

​

Conexão (BYO key)

A integração é Bring Your Own Key:

​

Tier de busca

O Tavily expõe dois tiers de busca: O Scout usa o tier basic por default (boa relação custo/qualidade pro caso de uso típico). Times com necessidade específica podem configurar advanced via suporte.

​

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 pro busca web nativa da plataforma — 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:

1. A busca atual cai pro fallback nativo por um período curto
2. O cap-fire fica registrado no histórico de eventos da org
3. Após o cooldown, o Tavily volta a ser usado normalmente

Isto é independente dos rate limits da própria Tavily — é uma proteção em camada extra que o Apollo Space dá em cima da sua chave.

​

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 como example.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

A fatura Tavily vai pra você diretamente — Apollo Space não intermedia pagamento.

​

Próximos passos