Ferramentas Tavily
Quando usar cada ferramenta
| Necessidade | Ferramenta | Quando usar |
|---|
| Pesquisa web rápida | web_search | Consultas básicas, sem opções especiais necessárias |
| Pesquisa com opções avançadas | tavily_search | Precisa de profundidade, tópico, filtros de domínio, intervalo de tempo ou respostas de IA |
| Extrair conteúdo de URLs | tavily_extract | Tem URLs específicas, precisa do conteúdo delas |
web_search
O Tavily aciona esta ferramenta automaticamente quando selecionado como provedor de pesquisa. Use para consultas diretas onde não precisa de opções específicas do Tavily.
| Parâmetro | Descrição |
|---|
query | String de consulta de pesquisa |
count | Número de resultados (1–20) |
tavily_search
Use quando precisar de controle refinado sobre o comportamento da pesquisa.
| Parâmetro | Descrição |
|---|
query | String de consulta de pesquisa (mantenha abaixo de 400 caracteres) |
search_depth | basic (padrão, equilibrado) ou advanced (maior relevância, mais lento) |
topic | general (padrão), news (atualizações em tempo real) ou finance |
max_results | Número de resultados, 1–20 (padrão: 5) |
include_answer | Incluir um resumo de resposta gerado por IA (padrão: false) |
time_range | Filtrar por atualidade: day, week, month ou year |
include_domains | Array de domínios para restringir os resultados |
exclude_domains | Array de domínios para excluir dos resultados |
Profundidade de pesquisa
| Profundidade | Velocidade | Relevância | Melhor para |
|---|
basic | Mais rápida | Alta | Consultas de propósito geral (padrão) |
advanced | Mais lenta | Máxima | Precisão, fatos específicos, pesquisa detalhada |
Dicas
- Mantenha consultas abaixo de 400 caracteres — pense em consulta de pesquisa, não em prompt.
- Divida consultas complexas em subconsultas para melhores resultados.
- Use
include_domains para focar em fontes confiáveis.
- Use
time_range para informações recentes (notícias, eventos atuais).
- Use
include_answer quando precisar de uma resposta sintetizada rapidamente.
tavily_extract
Use quando tiver URLs específicas e precisar do conteúdo delas. Lida com páginas renderizadas com JavaScript e retorna markdown limpo. Suporta chunking focado em consulta para extração direcionada.
| Parâmetro | Descrição |
|---|
urls | Array de URLs para extrair (1–20 por requisição) |
query | Reordenar chunks extraídos por relevância a esta consulta |
extract_depth | basic (padrão, rápido) ou advanced (para páginas com JS pesado, tabelas) |
chunks_per_source | Chunks por URL, 1–5 (requer query) |
include_images | Incluir URLs de imagens nos resultados (padrão: false) |
Profundidade de extração
| Profundidade | Quando usar |
|---|
basic | Páginas simples — tente primeiro |
advanced | SPAs renderizadas com JS, conteúdo dinâmico, tabelas, conteúdo incorporado |
Dicas
- Máximo de 20 URLs por requisição — lote listas maiores em várias chamadas.
- Use
query + chunks_per_source para obter apenas conteúdo relevante em vez de páginas inteiras.
- Tente
basic primeiro, recorra a advanced se o conteúdo estiver ausente ou incompleto.
- Se os resultados de
tavily_search já contiverem os trechos necessários, pule a etapa de extração.
Escolhendo o fluxo de trabalho correto
Siga este padrão de escalonamento — comece simples, escale apenas quando necessário:
web_search — Consulta rápida, sem opções especiais necessárias.tavily_search — Precisa de controle de profundidade, filtragem por tópico, filtros de domínio, intervalo de tempo ou respostas de IA.tavily_extract — Tem URLs específicas, precisa do conteúdo completo ou de chunks direcionados.
Combine pesquisa + extração quando precisar primeiro encontrar páginas e depois obter seu conteúdo completo.