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 - doğrudan Plugin araçları olarak:
tavily_searchvetavily_extract
Tavily; yapılandırılabilir arama derinliği, konu filtreleme, alan adı 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'lerin kullanımı 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ı | arama için 30 sn., çıkarma için 60 sn. (varsayılan) |
| Araçlar | tavily_search, tavily_extract |
Başlarken
Plugin'i yükleyin
openclaw plugins install @openclaw/tavily-pluginBir API anahtarı edinin
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-...", // optional if TAVILY_API_KEY is set baseUrl: "https://api.tavily.com", }, }, }, }, }, tools: { web: { search: { provider: "tavily", }, }, },}Aramanın çalıştığını doğrulayın
Herhangi bir agent üzerinden bir 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 | zorunlu | Arama sorgusu dizesi. |
search_depth |
enum | basic (varsayılan), advanced |
advanced daha yavaştır ancak daha yüksek alaka sağlar. |
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 |
mantıksal | varsayılan false |
Tavily'nin yapay zekâ tarafından oluşturulan yanıt özetini dâhil eder. |
time_range |
enum | day, week, month, year |
Sonuçları güncelliğe göre filtreler. |
include_domains |
dize dizisi | (yok) | Yalnızca bu alan adlarından gelen sonuçları dâhil eder. |
exclude_domains |
dize dizisi | (yok) | Bu alan adlarından gelen sonuçları hariç tutar. |
Arama derinliği karşılaştırması:
| Derinlik | Hız | Alaka | 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 | zorunlu, 1-20 | İçeriğin çıkarılacağı 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 |
mantıksal | varsayılan false |
Sonuçlara görsel URL'lerini dâhil eder. |
Çıkarma derinliği karşılaştırması:
| Derinlik | Kullanım zamanı |
|---|---|
basic |
Basit sayfalar. Önce bunu deneyin. |
advanced |
JS 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 bir kurulum hatası oluşturur.
Özel temel URL
Tavily'yi bir proxy üzerinden kullanıyorsanız plugins.entries.tavily.config.webSearch.baseUrl değerini geçersiz kılın veya TAVILY_BASE_URL 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 iletilen çağrıları reddeder. Tavily parçaları sorguyla alakalarına göre sıraladığından, bu parametre sorgu olmadan anlamsızdır.
