Tavily

Tavily, yapay zekâ 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, etki alanı filtreleri, yapay zekâ tarafından oluşturulan yanıt özetleri ve URL’lerden içerik çıkarma (JavaScript ile oluşturulan sayfalar dâhil) özellikleriyle LLM tüketimi için optimize edilmiş yapılandırılmış sonuçlar döndürür.

Özellik	Değer
Plugin kimliği	`tavily`
Paket	`@openclaw/tavily-plugin`
Kimlik doğrulama	`TAVILY_API_KEY` ortam değişkeni veya `apiKey` yapılandırması
Temel URL	`https://api.tavily.com` (varsayılan); geçersiz kılmak için `TAVILY_BASE_URL` ortam değişkeni veya `baseUrl` yapılandırması
Zaman aşımları	30s arama, 60s çıkarma (varsayılan)
Araçlar	`tavily_search`, `tavily_extract`

Başlarken

Plugin'i yükleyin

openclaw plugins install @openclaw/tavily-plugin

Bir API anahtarı alın

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

Plugin'i ve sağlayıcıyı 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",
      },
    },
  },
}

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

Herhangi bir agent’tan web_search tetikleyin veya doğrudan tavily_search çağrısı yapın.

İlk katılım sırasında veya openclaw configure --section web içinde Tavily seçildiğinde, gerektiği takdirde resmî Tavily plugin’i yüklenir ve etkinleştirilir.

Araç başvurusu

`tavily_search`

Genel web_search yerine Tavily’ye özgü arama denetimlerini kullanmak istediğinizde bunu kullanın.

Parametre	Tür	Kısıtlamalar / varsayılan	Açıklama
`query`	dize	gerekli	Arama sorgusu dizesi.
`search_depth`	enum	`basic` (varsayılan), `advanced`	`advanced` daha yavaştır ancak alaka düzeyi daha yüksektir.
`topic`	enum	`general` (varsayılan), `news`, `finance`	Konu ailesine göre filtreler.
`max_results`	tam sayı	1-20, varsayılan `5`	Sonuç sayısı.
`include_answer`	boole	varsayılan `false`	Tavily’nin yapay zekâ tarafından oluşturulan yanıt özetini ekler.
`time_range`	enum	`day`, `week`, `month`, `year`	Sonuçları güncelliğe göre filtreler.
`include_domains`	dize dizisi	(yok)	Yalnızca bu etki alanlarındaki sonuçları ekler.
`exclude_domains`	dize dizisi	(yok)	Bu etki alanlarındaki sonuçları hariç tutar.

Arama derinliği dengesi:

Derinlik	Hız	Alaka düzeyi	En uygun kullanım
`basic`	Daha hızlı	Yüksek	Genel amaçlı sorgular (varsayılan).
`advanced`	Daha yavaş	En yüksek	Hassas araştırma ve bilgi doğrulama.

`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 çıkarma için sorgu odaklı parçalara ayırmayı destekler.

Parametre	Tür	Kısıtlamalar / varsayılan	Açıklama
`urls`	dize dizisi	gerekli, 1-20	İçerik çıkarılacak URL’ler.
`query`	dize	(isteğe bağlı)	Çıkarılan parçaları bu sorguyla alakalarına göre yeniden sıralar.
`extract_depth`	enum	`basic` (varsayılan), `advanced`	Yoğun JS kullanan sayfalar, SPA’lar veya dinamik tablolar için `advanced` kullanın.
`chunks_per_source`	tam sayı	1-5; `query` gerektirir	URL başına döndürülen parça sayısı. `query` olmadan ayarlanırsa hata verir.
`include_images`	boole	varsayılan `false`	Sonuçlara görsel URL’lerini ekler.

Çıkarma derinliği dengesi:

Derinlik	Kullanım zamanı
`basic`	Basit sayfalar. Önce bunu deneyin.
`advanced`	JavaScript ile oluşturulan SPA’lar, dinamik içerik ve 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ç
Özel seçenekler olmadan hızlı web araması	`web_search`
Derinlik, konu ve yapay zekâ yanıtlarıyla arama	`tavily_search`
Belirli URL’lerden içerik çıkarma	`tavily_extract`

Sağlayıcı olarak Tavily kullanan genel web_search aracı, query ve count özelliklerini destekler (en fazla 20 sonuç). Tavily’ye özgü denetimler (search_depth, topic, include_answer, etki alanı filtreleri, zaman aralığı) için bunun yerine tavily_search kullanın.

Gelişmiş yapılandırma

API anahtarı çözümleme sırası

Tavily istemcisi API anahtarını şu sırayla arar:

plugins.entries.tavily.config.webSearch.apiKey (SecretRefs aracılığıyla çözümlenir).
Gateway ortamındaki TAVILY_API_KEY.

Hiçbiri mevcut değilse hem tavily_search hem de tavily_extract kurulum hatası verir.

Özel temel URL

Tavily’yi bir proxy üzerinden sunuyorsanız plugins.entries.tavily.config.webSearch.baseUrl değerini geçersiz kılın veya TAVILY_BASE_URL değerini ayarlayın. Yapılandırma, ortam değişkenine göre önceliklidir. Varsayılan değer https://api.tavily.com şeklindedir.

`chunks_per_source`, `query` gerektirir

tavily_extract, query olmadan chunks_per_source ileten çağrıları reddeder. Tavily parçaları sorguyla alakalarına göre sıraladığından, bu parametre sorgu olmadan anlamsızdır.

İlgili içerikler

Web Aramasına genel bakış

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

Firecrawl

İçerik çıkarma özellikli arama ve kazıma.

Exa Search

İçerik çıkarma özellikli sinirsel arama.

Yapılandırma

Plugin girdileri ve araç yönlendirmesi için tam yapılandırma şeması.

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Başlarken

Araç başvurusu

`tavily_search`

`tavily_extract`

Doğru aracı seçme

Gelişmiş yapılandırma

İlgili içerikler

Web Aramasına genel bakış

Firecrawl

Exa Search

Yapılandırma

​Başlarken

​Araç başvurusu

​tavily_search

​tavily_extract

​Doğru aracı seçme

​Gelişmiş yapılandırma

​İlgili içerikler

Web Aramasına genel bakış

Firecrawl

Exa Search

Yapılandırma

Başlarken

Araç başvurusu

`tavily_search`

`tavily_extract`

Doğru aracı seçme

Gelişmiş yapılandırma

İlgili içerikler