Przejdź do głównej treści

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Tavily to API wyszukiwania zaprojektowane dla aplikacji AI. OpenClaw udostępnia je na dwa sposoby:
  • jako dostawcę web_search dla ogólnego narzędzia wyszukiwania
  • jako jawne narzędzia Plugin: tavily_search i tavily_extract
Tavily zwraca uporządkowane wyniki zoptymalizowane pod użycie przez LLM, z konfigurowalną głębokością wyszukiwania, filtrowaniem tematów, filtrami domen, generowanymi przez AI podsumowaniami odpowiedzi oraz wyodrębnianiem treści z URL-i (w tym stron renderowanych przez JavaScript).
WłaściwośćWartość
Identyfikator Plugintavily
UwierzytelnianieTAVILY_API_KEY lub config apiKey
Bazowy URLhttps://api.tavily.com (domyślnie)
Dołączone narzędziatavily_search, tavily_extract

​
Pierwsze kroki

1

Get an API key

Utwórz konto Tavily na tavily.com, a następnie wygeneruj klucz API w panelu.
2

Configure the plugin and provider

{
  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",
      },
    },
  },
}
3

Verify search runs

Uruchom web_search z dowolnego agenta albo wywołaj bezpośrednio tavily_search.
Wybranie Tavily podczas onboardingu lub przez openclaw configure --section web automatycznie włącza dołączony Plugin Tavily.

​
Dokumentacja narzędzi

Użyj tego, gdy potrzebujesz kontrolek wyszukiwania specyficznych dla Tavily zamiast ogólnego web_search.
ParametrTypOgraniczenia / domyślneOpis
querystringwymaganeCiąg zapytania wyszukiwania. Nie przekraczaj 400 znaków.
search_depthenumbasic (domyślnie), advancedadvanced jest wolniejsze, ale trafniejsze.
topicenumgeneral (domyślnie), news, financeFiltruj według rodziny tematów.
max_resultsinteger1-20Liczba wyników.
include_answerbooleandomyślnie falseDołącz wygenerowane przez Tavily AI podsumowanie odpowiedzi.
time_rangeenumday, week, month, yearFiltruj wyniki według aktualności.
include_domainsstring array(brak)Uwzględniaj tylko wyniki z tych domen.
exclude_domainsstring array(brak)Wyklucz wyniki z tych domen.
Kompromis głębokości wyszukiwania:
GłębokośćSzybkośćTrafnośćNajlepsze do
basicSzybszeWysokaZapytania ogólnego przeznaczenia (domyślnie).
advancedWolniejszeNajwyższaPrecyzyjne badania i ustalanie faktów.

​
tavily_extract

Użyj tego, aby wyodrębnić czystą treść z jednego lub wielu URL-i. Obsługuje strony renderowane przez JavaScript i wspiera dzielenie na fragmenty ukierunkowane zapytaniem na potrzeby celowanego wyodrębniania.
ParametrTypOgraniczenia / domyślneOpis
urlsstring arraywymagane, 1-20URL-e, z których należy wyodrębnić treść.
querystring(opcjonalne)Ponownie uszereguj wyodrębnione fragmenty według trafności względem tego zapytania.
extract_depthenumbasic (domyślnie), advancedUżyj advanced dla stron mocno opartych na JS, SPA lub dynamicznych tabel.
chunks_per_sourceinteger1-5; wymaga queryFragmenty zwracane na URL. Zwraca błąd, jeśli ustawione bez query.
include_imagesbooleandomyślnie falseDołącz URL-e obrazów w wynikach.
Kompromis głębokości wyodrębniania:
GłębokośćKiedy używać
basicProste strony. Wypróbuj to najpierw.
advancedSPA renderowane przez JS, treść dynamiczna, tabele.
Dziel większe listy URL-i na wiele wywołań tavily_extract (maks. 20 na żądanie). Użyj query wraz z chunks_per_source, aby otrzymać tylko odpowiednią treść zamiast pełnych stron.

​
Wybór właściwego narzędzia

PotrzebaNarzędzie
Szybkie wyszukiwanie w sieci, bez opcji specjalnychweb_search
Wyszukiwanie z głębokością, tematem, odpowiedziami AItavily_search
Wyodrębnianie treści z konkretnych URL-itavily_extract
Ogólne narzędzie web_search z Tavily jako dostawcą obsługuje query i count (do 20 wyników). Aby użyć kontrolek specyficznych dla Tavily (search_depth, topic, include_answer, filtry domen, zakres czasu), użyj zamiast tego tavily_search.

​
Konfiguracja zaawansowana

Klient Tavily wyszukuje swój klucz API w tej kolejności:
  1. plugins.entries.tavily.config.webSearch.apiKey (rozwiązywane przez SecretRefs).
  2. TAVILY_API_KEY ze środowiska Gateway.
tavily_extract zgłasza błąd konfiguracji, jeśli żadne z nich nie jest dostępne.
Nadpisz plugins.entries.tavily.config.webSearch.baseUrl, jeśli udostępniasz Tavily przez proxy. Domyślna wartość to https://api.tavily.com.
tavily_extract odrzuca wywołania, które przekazują chunks_per_source bez query. Tavily szereguje fragmenty według trafności zapytania, więc parametr jest bez niego bez znaczenia.

​
Powiązane

Web Search overview

Wszyscy dostawcy i reguły automatycznego wykrywania.

Firecrawl

Wyszukiwanie oraz scraping z wyodrębnianiem treści.

Exa Search

Wyszukiwanie neuronowe z wyodrębnianiem treści.

Configuration

Pełny schemat konfiguracji wpisów Plugin i routingu narzędzi.