Tools

Wyszukiwanie Exa

OpenClaw obsługuje Exa AI jako dostawcę web_search. Exa oferuje neuronowe, słowokluczowe i hybrydowe tryby wyszukiwania z wbudowaną ekstrakcją treści (wyróżnienia, tekst, podsumowania).

Uzyskaj klucz API

  • Utwórz konto

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

  • Zapisz klucz

    Ustaw EXA_API_KEY w środowisku Gateway albo skonfiguruj za pomocą:

    openclaw configure --section web
    
  • Konfiguracja

    {
      plugins: {
        entries: {
          exa: {
            config: {
              webSearch: {
                apiKey: "exa-...", // optional if EXA_API_KEY is set
                baseUrl: "https://api.exa.ai", // optional; OpenClaw appends /search
              },
            },
          },
        },
      },
      tools: {
        web: {
          search: {
            provider: "exa",
          },
        },
      },
    }
    

    Alternatywa środowiskowa: ustaw EXA_API_KEY w środowisku Gateway. W przypadku instalacji gateway umieść go w ~/.openclaw/.env.

    Nadpisanie bazowego adresu URL

    Ustaw plugins.entries.exa.config.webSearch.baseUrl, gdy żądania wyszukiwania Exa mają przechodzić przez zgodny serwer proxy lub alternatywny punkt końcowy Exa. OpenClaw normalizuje same hosty, dodając na początku https://, i dodaje /search, chyba że ścieżka już się tam kończy. Rozwiązany punkt końcowy jest uwzględniany w kluczu pamięci podręcznej wyszukiwania, więc wyniki z różnych punktów końcowych Exa nie są współdzielone.

    Parametry narzędzia

    querystringrequired

    Zapytanie wyszukiwania.

    countnumber

    Wyniki do zwrócenia (1–100).

    type'auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'

    Tryb wyszukiwania.

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

    Filtr czasu.

    date_afterstring

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

    date_beforestring

    Wyniki przed tą datą (YYYY-MM-DD).

    contentsobject

    Opcje ekstrakcji treści (zobacz niżej).

    Ekstrakcja treści

    Exa może zwracać wyodrębnioną treść obok wyników wyszukiwania. Przekaż obiekt contents, aby ją włączyć:

    await web_search({
      query: "transformer architecture explained",
      type: "neural",
      contents: {
        text: true, // full page text
        highlights: { numSentences: 3 }, // key sentences
        summary: true, // AI summary
      },
    });
    
    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

    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 głębokie wyszukiwanie
    deep-reasoning Głębokie wyszukiwanie z rozumowaniem
    instant Najszybsze wyniki

    Uwagi

    • Jeśli nie podano opcji contents, Exa domyślnie używa { highlights: true }, więc wyniki zawierają fragmenty kluczowych zdań
    • Wyniki zachowują pola highlightScores i summary z odpowiedzi Exa API, gdy są dostępne
    • Opisy wyników są rozwiązywane najpierw z wyróżnień, następnie z podsumowania, a potem z pełnego tekstu — zależnie od tego, co jest dostępne
    • freshness oraz date_after/date_before nie mogą być łączone — użyj jednego trybu filtrowania czasu
    • Na jedno zapytanie można zwrócić do 100 wyników (z zastrzeżeniem limitów typu wyszukiwania Exa)
    • Wyniki są domyślnie buforowane przez 15 minut (konfigurowalne przez cacheTtlMinutes)
    • Exa to oficjalna integracja API ze strukturalnymi odpowiedziami JSON

    Powiązane