Tools
Tavily
Tavily, AI 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, alan adı filtreleri, AI tarafından oluşturulan yanıt özetleri ve URL'lerden içerik çıkarma (JavaScript ile işlenen sayfalar dahil) ile 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 veya config apiKey |
| Temel URL | https://api.tavily.com (varsayılan) |
| Araçlar | tavily_search, tavily_extract |
Başlarken
Plugin'i yükleyin
openclaw plugins install @openclaw/tavily-pluginAPI anahtarı alın
tavily.com adresinde bir Tavily hesabı oluşturun, ardından panoda 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'tan web_search tetikleyin veya doğrudan tavily_search çağırın.
Araç başvurusu
tavily_search
Genel web_search yerine Tavily'ye özgü arama kontrolleri istediğinizde bunu kullanın.
| Parametre | Tür | Kısıtlamalar / varsayılan | Açıklama |
|---|---|---|---|
query |
string | gerekli | Arama sorgusu dizesi. 400 karakterin altında tutun. |
search_depth |
enum | basic (varsayılan), advanced |
advanced daha yavaştır ancak daha yüksek alaka düzeyi sağlar. |
topic |
enum | general (varsayılan), news, finance |
Konu ailesine göre filtreleyin. |
max_results |
integer | 1-20 | Sonuç sayısı. |
include_answer |
boolean | varsayılan false |
Tavily AI tarafından oluşturulan yanıt özetini ekleyin. |
time_range |
enum | day, week, month, year |
Sonuçları güncelliğe göre filtreleyin. |
include_domains |
string array | (yok) | Yalnızca bu alan adlarından gelen sonuçları dahil edin. |
exclude_domains |
string array | (yok) | Bu alan adlarından gelen sonuçları hariç tutun. |
Arama derinliği karşılaştırması:
| Derinlik | Hız | Alaka düzeyi | En iyi 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
Bunu bir veya daha fazla URL'den temiz içerik çıkarmak için kullanın. JavaScript ile işlenen 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 |
string array | gerekli, 1-20 | İçerik çıkarılacak URL'ler. |
query |
string | (isteğe bağlı) | Çıkarılan parçaları bu sorguyla alakalarına göre yeniden sıralayın. |
extract_depth |
enum | basic (varsayılan), advanced |
JS ağırlıklı sayfalar, SPA'lar veya dinamik tablolar için advanced kullanın. |
chunks_per_source |
integer | 1-5; query gerektirir |
URL başına döndürülen parçalar. query olmadan ayarlanırsa hata verir. |
include_images |
boolean | varsayılan false |
Sonuçlara görsel URL'lerini dahil edin. |
Çıkarma derinliği karşılaştırması:
| Derinlik | Ne zaman kullanılmalı |
|---|---|
basic |
Basit sayfalar. Önce bunu deneyin. |
advanced |
JS ile işlenen SPA'lar, dinamik içerik, tablolar. |
Doğru aracı seçme
| İhtiyaç | Araç |
|---|---|
| Hızlı web araması, özel seçenek yok | web_search |
| Derinlik, konu, AI 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 üzerinden çözümlenir).- Gateway ortamından
TAVILY_API_KEY.
Hiçbiri yoksa tavily_extract bir kurulum hatası oluşturur.
Özel temel URL
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.
`chunks_per_source`, `query` gerektirir
tavily_extract, query olmadan chunks_per_source ileten çağrıları reddeder. Tavily parçaları sorgu alakasına göre sıralar, bu nedenle parametre sorgu olmadan anlamsızdır.
