Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Tavily, AI uygulamaları için tasarlanmış bir arama API’sidir. OpenClaw bunu iki şekilde sunar:
  • genel arama aracı için web_search sağlayıcısı olarak
  • açık Plugin araçları olarak: tavily_search ve tavily_extract
Tavily, yapılandırılabilir arama derinliği, konu filtreleme, alan adı filtreleri, AI tarafından oluşturulan yanıt özetleri ve URL’lerden içerik çıkarma (JavaScript ile oluşturulan sayfalar dahil) ile LLM tüketimi için optimize edilmiş yapılandırılmış sonuçlar döndürür.
ÖzellikDeğer
Plugin kimliğitavily
Kimlik doğrulamaTAVILY_API_KEY veya config apiKey
Temel URLhttps://api.tavily.com (varsayılan)
Paketli araçlartavily_search, tavily_extract

​
Başlarken

1

Bir API anahtarı alın

tavily.com adresinde bir Tavily hesabı oluşturun, ardından panoda bir API anahtarı oluşturun.
2

Plugin ve sağlayıcıyı yapılandırın

{
  plugins: {
    entries: {
      tavily: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "tvly-...", // optional if TAVILY_API_KEY is set
            baseUrl: "https://api.tavily.com",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "tavily",
      },
    },
  },
}
3

Aramanın çalıştığını doğrulayın

Herhangi bir agent’tan bir web_search tetikleyin veya doğrudan tavily_search çağırın.
Onboarding sırasında Tavily’yi seçmek veya openclaw configure --section web komutunu kullanmak, paketli Tavily Plugin’ini otomatik olarak etkinleştirir.

​
Araç referansı

Genel web_search yerine Tavily’ye özgü arama kontrolleri istediğinizde bunu kullanın.
ParametreTürKısıtlamalar / varsayılanAçıklama
querystringgerekliArama sorgusu dizesi. 400 karakterin altında tutun.
search_depthenumbasic (varsayılan), advancedadvanced daha yavaştır ancak daha yüksek alaka düzeyi sağlar.
topicenumgeneral (varsayılan), news, financeKonu ailesine göre filtreleyin.
max_resultsinteger1-20Sonuç sayısı.
include_answerbooleanvarsayılan falseTavily AI tarafından oluşturulan bir yanıt özeti ekleyin.
time_rangeenumday, week, month, yearSonuçları güncelliğe göre filtreleyin.
include_domainsstring dizisi(yok)Yalnızca bu alan adlarından gelen sonuçları dahil edin.
exclude_domainsstring dizisi(yok)Bu alan adlarından gelen sonuçları hariç tutun.
Arama derinliği ödünleşimi:
DerinlikHızAlaka düzeyiEn uygun kullanım
basicDaha hızlıYüksekGenel amaçlı sorgular (varsayılan).
advancedDaha yavaşEn yüksekHassas araştırma ve doğruluk kontrolü.

​
tavily_extract

Bir veya daha fazla URL’den temiz içerik çıkarmak için bunu kullanın. JavaScript ile oluşturulan sayfaları işler ve hedefli çıkarım için sorgu odaklı parçalamayı destekler.
ParametreTürKısıtlamalar / varsayılanAçıklama
urlsstring dizisigerekli, 1-20İçerik çıkarılacak URL’ler.
querystring(isteğe bağlı)Çıkarılan parçaları bu sorguya göre alaka düzeyiyle yeniden sıralayın.
extract_depthenumbasic (varsayılan), advancedJS ağırlıklı sayfalar, SPA’lar veya dinamik tablolar için advanced kullanın.
chunks_per_sourceinteger1-5; query gerektirirURL başına döndürülen parçalar. query olmadan ayarlanırsa hata verir.
include_imagesbooleanvarsayılan falseSonuçlara görsel URL’lerini dahil edin.
Çıkarma derinliği ödünleşimi:
DerinlikNe zaman kullanılmalı
basicBasit sayfalar. Önce bunu deneyin.
advancedJS ile oluşturulan SPA’lar, dinamik içerik, tablolar.
Daha büyük URL listelerini birden fazla tavily_extract çağrısına bölün (istek başına en fazla 20). Tam sayfalar yerine yalnızca ilgili içeriği almak için query ile chunks_per_source kullanın.

​
Doğru aracı seçme

İhtiyaçAraç
Hızlı web araması, özel seçenek yokweb_search
Derinlik, konu ve AI yanıtlarıyla aramatavily_search
Belirli URL’lerden içerik çıkarmatavily_extract
Sağlayıcı olarak Tavily kullanılan genel web_search aracı, query ve count (en fazla 20 sonuç) destekler. Tavily’ye özgü kontroller (search_depth, topic, include_answer, alan adı filtreleri, zaman aralığı) için bunun yerine tavily_search kullanın.

​
Gelişmiş yapılandırma

Tavily istemcisi API anahtarını şu sırayla arar:
  1. plugins.entries.tavily.config.webSearch.apiKey (SecretRefs üzerinden çözümlenir).
  2. Gateway ortamından TAVILY_API_KEY.
Hiçbiri yoksa tavily_extract bir kurulum hatası verir.
Tavily’yi bir proxy üzerinden sunuyorsanız plugins.entries.tavily.config.webSearch.baseUrl değerini geçersiz kılın. Varsayılan https://api.tavily.com değeridir.
tavily_extract, query olmadan chunks_per_source iletilen çağrıları reddeder. Tavily parçaları sorgu alaka düzeyine göre sıralar, bu nedenle bu parametre sorgu olmadan anlamsızdır.

​
İlgili

Web Araması genel bakışı

Tüm sağlayıcılar ve otomatik algılama kuralları.

Firecrawl

İçerik çıkarma ile arama ve scraping.

Exa Search

İçerik çıkarma ile nöral arama.

Yapılandırma

Plugin girdileri ve araç yönlendirme için tam config şeması.