Tools
Tavily
Tavily, yapay zekâ uygulamaları için tasarlanmış bir arama API'sidir. OpenClaw bunu iki şekilde sunar:
- genel arama aracı için
web_searchsağlayıcısı olarak - açık plugin araçları olarak:
tavily_searchvetavily_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-pluginBir 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.
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. |
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 |
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.
