Tools

Wyszukiwanie Exa

Exa AI jest dostawcą web_search oferującym neuronowe, słowne i hybrydowe tryby wyszukiwania oraz wbudowane wyodrębnianie treści (najważniejsze fragmenty, tekst, podsumowania).

Instalacja Pluginu

bash

openclaw plugins install @openclaw/exa-pluginopenclaw gateway restart

Uzyskanie klucza API

Utwórz konto

Zarejestruj się w serwisie exa.ai i wygeneruj klucz API w swoim panelu.

Zapisz klucz

Ustaw EXA_API_KEY w środowisku Gateway lub skonfiguruj go za pomocą polecenia:

bash

openclaw configure --section web

Konfiguracja

json5

{  plugins: {    entries: {      exa: {        config: {          webSearch: {            apiKey: "exa-...", // opcjonalne, jeśli ustawiono EXA_API_KEY            baseUrl: "https://api.exa.ai", // opcjonalne; OpenClaw dołącza /search          },        },      },    },  },  tools: {    web: {      search: {        provider: "exa",      },    },  },}

Alternatywa za pomocą zmiennej środowiskowej: ustaw EXA_API_KEY w środowisku Gateway. W przypadku instalacji Gateway umieść ją w pliku ~/.openclaw/.env. Zobacz Zmienne środowiskowe.

Zastępowanie bazowego adresu URL

Ustaw plugins.entries.exa.config.webSearch.baseUrl, aby kierować żądania wyszukiwania Exa przez zgodny serwer proxy lub alternatywny punkt końcowy. OpenClaw normalizuje same nazwy hostów, dodając przed nimi https://, oraz dołącza /search, chyba że ścieżka już się nim kończy. Rozpoznany punkt końcowy jest częścią klucza pamięci podręcznej wyszukiwania, dlatego wyniki z różnych punktów końcowych nigdy nie są współdzielone.

Parametry narzędzia

querystringrequired

Zapytanie wyszukiwania.

countnumberdefault: 5

Liczba zwracanych wyników (1–100, z uwzględnieniem ograniczeń typu wyszukiwania Exa).

Tryb wyszukiwania.

freshness'day' | 'week' | 'month' | 'year'

Filtr czasu. Nie można go łączyć z date_after/date_before.

date_afterstring

Wyniki po tej dacie (YYYY-MM-DD).

date_beforestring

Wyniki sprzed tej daty (YYYY-MM-DD).

contentsobject

Opcje wyodrębniania treści (patrz poniżej).

Wyodrębnianie treści

Przekaż obiekt contents, aby określić wyodrębnianą treść w wynikach:

javascript

await web_search({  query: "transformer architecture explained",  type: "neural",  contents: {    text: true, // pełny tekst strony    highlights: { numSentences: 3 }, // kluczowe zdania    summary: true, // podsumowanie wygenerowane przez AI  },});

Opcja zawartości	Typ	Opis
`text`	`boolean \| { maxCharacters }`	Wyodrębnij pełny tekst strony
`highlights`	`boolean \| { maxCharacters, query, numSentences, highlightsPerUrl }`	Wyodrębnij kluczowe zdania
`summary`	`boolean \| { query }`	Podsumowanie wygenerowane przez AI

Jeśli parametr contents zostanie pominięty, Exa domyślnie użyje wartości { highlights: true }, dzięki czemu wyniki będą zawierać fragmenty z kluczowymi zdaniami. Opisy wyników są pobierane najpierw z najważniejszych fragmentów, następnie z podsumowania, a na końcu z pełnego tekstu — zależnie od tego, która wartość jest dostępna jako pierwsza. Wyniki zachowują również nieprzetworzone pola highlightScores i summary z odpowiedzi API Exa, jeśli są dostępne.

Tryby wyszukiwania

Tryb	Opis
`auto`	Exa wybiera najlepszy tryb (domyślnie)
`neural`	Wyszukiwanie semantyczne, oparte na znaczeniu
`fast`	Szybkie wyszukiwanie słów kluczowych
`deep`	Dokładne, pogłębione wyszukiwanie
`deep-reasoning`	Pogłębione wyszukiwanie z rozumowaniem
`instant`	Najszybsze wyniki

Uwagi

Parametr count przyjmuje wartości do 100, z uwzględnieniem ograniczeń typu wyszukiwania Exa.
Wyniki są domyślnie przechowywane w pamięci podręcznej przez 15 minut. Skonfiguruj współdzielone ustawienia tools.web.search.cacheTtlMinutes (w minutach) i tools.web.search.timeoutSeconds (domyślnie 30 s), aby zmienić czas przechowywania w pamięci podręcznej oraz limit czasu żądań dla wszystkich dostawców web_search, w tym Exa.

Powiązane materiały

Omówienie wyszukiwania internetowego — wszyscy dostawcy i automatyczne wykrywanie
Brave Search — uporządkowane wyniki z filtrami kraju i języka
Perplexity Search — uporządkowane wyniki z filtrowaniem domen

Was this useful?