Wyszukiwanie Perplexity

​

Instalowanie pluginu

openclaw plugins install @openclaw/perplexity-plugin
openclaw gateway restart

​

Uzyskiwanie klucza API Perplexity

1. Utwórz konto Perplexity na stronie perplexity.ai/settings/api.
2. Wygeneruj klucz API w panelu.
3. Zapisz klucz w konfiguracji lub ustaw PERPLEXITY_API_KEY w środowisku Gateway.

​

Zgodność z OpenRouter

• plugins.entries.perplexity.config.webSearch.baseUrl
• plugins.entries.perplexity.config.webSearch.model

​

Przykłady konfiguracji

​

Natywny interfejs Perplexity Search API

{
  plugins: {
    entries: {
      perplexity: {
        config: {
          webSearch: {
            apiKey: "pplx-...",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "perplexity",
      },
    },
  },
}

​

Zgodność z OpenRouter / Sonar

{
  plugins: {
    entries: {
      perplexity: {
        config: {
          webSearch: {
            apiKey: "<openrouter-api-key>",
            baseUrl: "https://openrouter.ai/api/v1",
            model: "perplexity/sonar-pro",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "perplexity",
      },
    },
  },
}

​

Gdzie ustawić klucz

​

Parametry narzędzia

• Akceptowane są query, count i freshness.
• count służy tam wyłącznie do zapewnienia zgodności; odpowiedź nadal jest jedną zsyntetyzowaną odpowiedzią z cytowaniami, a nie listą N wyników.
• Filtry dostępne wyłącznie w Search API (country, language, date_after, date_before, domain_filter, max_tokens, max_tokens_per_page) zwracają jednoznaczne błędy.

// Wyszukiwanie z określonym krajem i językiem
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Najnowsze wyniki (z ostatniego tygodnia)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Wyszukiwanie w zakresie dat
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

// Filtrowanie domen (lista dozwolonych)
await web_search({
  query: "climate research",
  domain_filter: ["nature.com", "science.org", ".edu"],
});

// Filtrowanie domen (lista zabronionych — prefiks -)
await web_search({
  query: "product reviews",
  domain_filter: ["-reddit.com", "-pinterest.com"],
});

// Pobieranie większej ilości treści
await web_search({
  query: "detailed AI research",
  max_tokens: 50000,
  max_tokens_per_page: 4096,
});

​

Reguły filtrowania domen

• Maksymalnie 20 domen na filtr.
• W jednym żądaniu nie można łączyć wpisów listy dozwolonych i listy zabronionych.
• W przypadku wpisów listy zabronionych użyj prefiksu - (np. ["-reddit.com"]).

​

Uwagi

• Perplexity Search API zwraca uporządkowane wyniki wyszukiwania internetowego (title, url, snippet).
• OpenRouter lub jawne ustawienie plugins.entries.perplexity.config.webSearch.baseUrl / model przełącza Perplexity z powrotem na uzupełnienia czatu Sonar w celu zapewnienia zgodności.
• Tryb zgodności z Sonar/OpenRouter zwraca jedną zsyntetyzowaną odpowiedź z cytowaniami, a nie uporządkowane wiersze wyników.
• Wyniki są domyślnie przechowywane w pamięci podręcznej przez 15 minut (wartość można skonfigurować za pomocą cacheTtlMinutes).

​

Powiązane