Ana içeriğe atla

​
Tavily

OpenClaw, Tavily’yi iki şekilde kullanabilir:
  • web_search sağlayıcısı olarak
  • açık eklenti araçları olarak: tavily_search ve tavily_extract
Tavily, AI uygulamaları için tasarlanmış bir arama API’sidir ve LLM tüketimi için optimize edilmiş yapılandırılmış sonuçlar döndürür. Yapılandırılabilir arama derinliği, konu filtreleme, alan adı filtreleri, AI tarafından oluşturulmuş yanıt özetleri ve URL’lerden içerik çıkarma (JavaScript ile oluşturulan sayfalar dahil) desteği sunar.

​
API anahtarı alın

  1. tavily.com adresinde bir Tavily hesabı oluşturun.
  2. Panodan bir API anahtarı oluşturun.
  3. Bunu yapılandırmada saklayın veya ağ geçidi ortamında TAVILY_API_KEY ayarlayın.

​
Tavily aramasını yapılandırın

{
  plugins: {
    entries: {
      tavily: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "tvly-...", // TAVILY_API_KEY ayarlanmışsa isteğe bağlı
            baseUrl: "https://api.tavily.com",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "tavily",
      },
    },
  },
}
Notlar:
  • Onboarding sırasında veya openclaw configure --section web içinde Tavily seçildiğinde paketlenmiş Tavily eklentisi otomatik olarak etkinleştirilir.
  • Tavily yapılandırmasını plugins.entries.tavily.config.webSearch.* altında saklayın.
  • Tavily ile web_search, query ve count destekler (en fazla 20 sonuç).
  • search_depth, topic, include_answer veya alan adı filtreleri gibi Tavily’ye özgü denetimler için tavily_search kullanın.

​
Tavily eklenti araçları

Genel web_search yerine Tavily’ye özgü arama denetimleri istediğinizde bunu kullanın.
ParametreAçıklama
queryArama sorgusu dizesi (400 karakterin altında tutun)
search_depthbasic (varsayılan, dengeli) veya advanced (en yüksek alaka, daha yavaş)
topicgeneral (varsayılan), news (gerçek zamanlı güncellemeler) veya finance
max_resultsSonuç sayısı, 1-20 (varsayılan: 5)
include_answerAI tarafından oluşturulmuş bir yanıt özetini ekle (varsayılan: false)
time_rangeGüncelliğe göre filtrele: day, week, month veya year
include_domainsSonuçları sınırlandırmak için alan adları dizisi
exclude_domainsSonuçlardan hariç tutulacak alan adları dizisi
Arama derinliği:
DerinlikHızAlaka düzeyiEn uygun olduğu kullanım
basicDaha hızlıYüksekGenel amaçlı sorgular (varsayılan)
advancedDaha yavaşEn yüksekHassasiyet, belirli olgular, araştırma

​
tavily_extract

Bunu bir veya daha fazla URL’den temiz içerik çıkarmak için kullanın. Hedefe yönelik çıkarma için JavaScript ile oluşturulan sayfaları işler ve sorgu odaklı parçalara ayırmayı destekler.
ParametreAçıklama
urlsİçerik çıkarılacak URL’ler dizisi (istek başına 1-20)
queryÇıkarılan parçaları bu sorguya göre alaka düzeyine göre yeniden sırala
extract_depthbasic (varsayılan, hızlı) veya advanced (JS ağırlıklı sayfalar için)
chunks_per_sourceURL başına parça sayısı, 1-5 (query gerektirir)
include_imagesSonuçlara görsel URL’lerini ekle (varsayılan: false)
Çıkarma derinliği:
DerinlikNe zaman kullanılır
basicBasit sayfalar - önce bunu deneyin
advancedJS ile oluşturulan SPA’lar, dinamik içerik, tablolar
İpuçları:
  • İstek başına en fazla 20 URL. Daha büyük listeleri birden çok çağrıya bölün.
  • Tam sayfalar yerine yalnızca ilgili içeriği almak için query + chunks_per_source kullanın.
  • Önce basic deneyin; içerik eksikse veya tamamlanmamışsa advanced seçeneğine geri dönün.

​
Doğru aracı seçme

İhtiyaçAraç
Hızlı web araması, özel seçenek yokweb_search
Derinlik, konu, AI yanıtları ile aramatavily_search
Belirli URL’lerden içerik çıkarmatavily_extract

​
İlgili