Przejdź do głównej treści

​
Tavily

OpenClaw może używać Tavily na dwa sposoby:
  • jako dostawcy web_search
  • jako jawnych narzędzi pluginu: tavily_search i tavily_extract
Tavily to API wyszukiwania zaprojektowane dla aplikacji AI, zwracające uporządkowane wyniki zoptymalizowane do wykorzystania przez LLM. Obsługuje konfigurowalną głębokość wyszukiwania, filtrowanie według tematów, filtry domen, generowane przez AI podsumowania odpowiedzi oraz ekstrakcję treści z adresów URL (w tym stron renderowanych przez JavaScript).

​
Uzyskaj klucz API

  1. Utwórz konto Tavily na tavily.com.
  2. Wygeneruj klucz API w panelu.
  3. Zapisz go w konfiguracji lub ustaw TAVILY_API_KEY w środowisku gateway.

​
Skonfiguruj wyszukiwanie Tavily

{
  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",
      },
    },
  },
}
Uwagi:
  • Wybranie Tavily podczas onboardingu lub przez openclaw configure --section web automatycznie włącza bundled plugin Tavily.
  • Przechowuj konfigurację Tavily w plugins.entries.tavily.config.webSearch.*.
  • web_search z Tavily obsługuje query i count (do 20 wyników).
  • W przypadku ustawień specyficznych dla Tavily, takich jak search_depth, topic, include_answer lub filtry domen, użyj tavily_search.

​
Narzędzia pluginu Tavily

Użyj tego, gdy chcesz mieć kontrolki wyszukiwania specyficzne dla Tavily zamiast generycznego web_search.
ParametrOpis
queryCiąg zapytania wyszukiwania (zachowaj poniżej 400 znaków)
search_depthbasic (domyślne, zrównoważone) lub advanced (najwyższa trafność, wolniejsze)
topicgeneral (domyślne), news (aktualizacje w czasie rzeczywistym) lub finance
max_resultsLiczba wyników, 1-20 (domyślnie: 5)
include_answerDołącz podsumowanie odpowiedzi wygenerowane przez AI (domyślnie: false)
time_rangeFiltruj według świeżości: day, week, month lub year
include_domainsTablica domen, do których mają być ograniczone wyniki
exclude_domainsTablica domen, które mają zostać wykluczone z wyników
Głębokość wyszukiwania:
GłębokośćSzybkośćTrafnośćNajlepsze zastosowanie
basicSzybszeWysokaZapytania ogólnego przeznaczenia (domyślnie)
advancedWolniejszeNajwyższaPrecyzja, konkretne fakty, research

​
tavily_extract

Użyj tego do wyodrębnienia czystej treści z jednego lub większej liczby adresów URL. Obsługuje strony renderowane przez JavaScript i wspiera dzielenie na fragmenty ukierunkowane na zapytanie dla celowanej ekstrakcji.
ParametrOpis
urlsTablica adresów URL do wyodrębnienia (1-20 na żądanie)
queryPrzestaw kolejność wyodrębnionych fragmentów według trafności względem tego zapytania
extract_depthbasic (domyślne, szybkie) lub advanced (dla stron mocno opartych na JS)
chunks_per_sourceFragmenty na URL, 1-5 (wymaga query)
include_imagesDołącz adresy URL obrazów do wyników (domyślnie: false)
Głębokość ekstrakcji:
GłębokośćKiedy używać
basicProste strony — najpierw spróbuj tego
advancedSPA renderowane przez JS, treści dynamiczne, tabele
Wskazówki:
  • Maksymalnie 20 adresów URL na żądanie. Większe listy dziel na wiele wywołań.
  • Użyj query + chunks_per_source, aby otrzymać tylko istotną treść zamiast pełnych stron.
  • Najpierw spróbuj basic; wróć do advanced, jeśli treść jest brakująca lub niepełna.

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

PotrzebaNarzędzie
Szybkie wyszukiwanie w sieci, bez specjalnych opcjiweb_search
Wyszukiwanie z głębokością, tematem i odpowiedziami AItavily_search
Ekstrakcja treści z konkretnych adresów URLtavily_extract

​
Powiązane