Tools
Tavily
Tavily to interfejs API wyszukiwania zaprojektowany dla aplikacji AI. OpenClaw udostępnia go na dwa sposoby:
- jako dostawcę
web_searchdla ogólnego narzędzia wyszukiwania - jako jawne narzędzia pluginu:
tavily_searchitavily_extract
Tavily zwraca ustrukturyzowane wyniki zoptymalizowane pod kątem wykorzystania przez modele LLM, z konfigurowalną głębokością wyszukiwania, filtrowaniem tematów i domen, generowanymi przez AI podsumowaniami odpowiedzi oraz wyodrębnianiem treści z adresów URL (w tym ze stron renderowanych przy użyciu JavaScriptu).
| Właściwość | Wartość |
|---|---|
| Identyfikator pluginu | tavily |
| Pakiet | @openclaw/tavily-plugin |
| Uwierzytelnianie | zmienna środowiskowa TAVILY_API_KEY lub ustawienie apiKey |
| Bazowy adres URL | https://api.tavily.com (domyślnie); zmienna środowiskowa TAVILY_BASE_URL lub ustawienie baseUrl, aby go zastąpić |
| Limity czasu | 30 s dla wyszukiwania, 60 s dla wyodrębniania (domyślnie) |
| Narzędzia | tavily_search, tavily_extract |
Pierwsze kroki
Zainstaluj plugin
openclaw plugins install @openclaw/tavily-pluginUzyskaj klucz API
Utwórz konto Tavily na stronie tavily.com, a następnie wygeneruj klucz API w panelu.
Skonfiguruj plugin i dostawcę
{ plugins: { entries: { tavily: { enabled: true, config: { webSearch: { apiKey: "tvly-...", // opcjonalne, jeśli ustawiono TAVILY_API_KEY baseUrl: "https://api.tavily.com", }, }, }, }, }, tools: { web: { search: { provider: "tavily", }, }, },}Sprawdź działanie wyszukiwania
Uruchom web_search z dowolnego agenta lub wywołaj bezpośrednio tavily_search.
Dokumentacja narzędzi
tavily_search
Użyj tego narzędzia, gdy potrzebujesz ustawień wyszukiwania specyficznych dla Tavily zamiast ogólnego narzędzia web_search.
| Parametr | Typ | Ograniczenia / wartość domyślna | Opis |
|---|---|---|---|
query |
ciąg znaków | wymagany | Ciąg zapytania wyszukiwania. |
search_depth |
wyliczenie | basic (domyślnie), advanced |
advanced działa wolniej, ale zapewnia większą trafność. |
topic |
wyliczenie | general (domyślnie), news, finance |
Filtrowanie według kategorii tematycznej. |
max_results |
liczba całkowita | 1–20, domyślnie 5 |
Liczba wyników. |
include_answer |
wartość logiczna | domyślnie false |
Dołącza wygenerowane przez AI Tavily podsumowanie odpowiedzi. |
time_range |
wyliczenie | day, week, month, year |
Filtrowanie wyników według aktualności. |
include_domains |
tablica ciągów znaków | (brak) | Uwzględnia tylko wyniki z tych domen. |
exclude_domains |
tablica ciągów znaków | (brak) | Wyklucza wyniki z tych domen. |
Kompromis dotyczący głębokości wyszukiwania:
| Głębokość | Szybkość | Trafność | Najlepsze zastosowanie |
|---|---|---|---|
basic |
Większa | Wysoka | Zapytania ogólnego przeznaczenia (domyślnie). |
advanced |
Mniejsza | Najwyższa | Precyzyjne badania i wyszukiwanie informacji. |
tavily_extract
Użyj tego narzędzia, aby wyodrębnić uporządkowaną treść z jednego lub wielu adresów URL. Obsługuje strony renderowane przy użyciu JavaScriptu i dzielenie treści na fragmenty ukierunkowane na zapytanie, co umożliwia precyzyjne wyodrębnianie.
| Parametr | Typ | Ograniczenia / wartość domyślna | Opis |
|---|---|---|---|
urls |
tablica ciągów znaków | wymagany, 1–20 | Adresy URL, z których ma zostać wyodrębniona treść. |
query |
ciąg znaków | (opcjonalny) | Ponownie porządkuje wyodrębnione fragmenty według trafności względem tego zapytania. |
extract_depth |
wyliczenie | basic (domyślnie), advanced |
Użyj advanced w przypadku stron intensywnie korzystających z JS, aplikacji SPA lub dynamicznych tabel. |
chunks_per_source |
liczba całkowita | 1–5; wymaga query |
Liczba fragmentów zwracanych dla każdego adresu URL. Ustawienie bez query powoduje błąd. |
include_images |
wartość logiczna | domyślnie false |
Dołącza adresy URL obrazów do wyników. |
Kompromis dotyczący głębokości wyodrębniania:
| Głębokość | Kiedy używać |
|---|---|
basic |
Proste strony. Wypróbuj tę opcję najpierw. |
advanced |
Aplikacje SPA renderowane przy użyciu JS, treści dynamiczne, tabele. |
Wybór odpowiedniego narzędzia
| Potrzeba | Narzędzie |
|---|---|
| Szybkie wyszukiwanie w internecie bez opcji specjalnych | web_search |
| Wyszukiwanie z określeniem głębokości, tematu i odpowiedziami AI | tavily_search |
| Wyodrębnianie treści z określonych adresów URL | tavily_extract |
Konfiguracja zaawansowana
Kolejność rozpoznawania klucza API
Klient Tavily wyszukuje klucz API w następującej kolejności:
plugins.entries.tavily.config.webSearch.apiKey(rozpoznawany za pośrednictwem SecretRefs).TAVILY_API_KEYze środowiska Gateway.
Zarówno tavily_search, jak i tavily_extract zgłaszają błąd konfiguracji, jeśli żadna z tych wartości nie jest dostępna.
Niestandardowy bazowy adres URL
Jeśli korzystasz z Tavily za pośrednictwem serwera proxy, zastąp wartość plugins.entries.tavily.config.webSearch.baseUrl lub ustaw TAVILY_BASE_URL. Konfiguracja ma pierwszeństwo przed zmienną środowiskową. Wartość domyślna to https://api.tavily.com.
`chunks_per_source` wymaga `query`
tavily_extract odrzuca wywołania przekazujące chunks_per_source bez parametru query. Tavily szereguje fragmenty według trafności względem zapytania, dlatego bez niego ten parametr nie ma znaczenia.
