Ricerca Perplexity

​

Installare il Plugin

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

​

Ottenere una chiave API Perplexity

1. Crea un account Perplexity su perplexity.ai/settings/api.
2. Genera una chiave API nella dashboard.
3. Salva la chiave nella configurazione oppure imposta PERPLEXITY_API_KEY nell’ambiente del Gateway.

​

Compatibilità con OpenRouter

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

​

Esempi di configurazione

​

API Perplexity Search nativa

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

​

Compatibilità con 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",
      },
    },
  },
}

​

Dove impostare la chiave

​

Parametri dello strumento

• Sono accettati query, count e freshness.
• In questo percorso, count è disponibile solo per compatibilità; la risposta rimane un’unica risposta sintetizzata con citazioni, anziché un elenco di N risultati.
• I filtri esclusivi dell’API Search (country, language, date_after, date_before, domain_filter, max_tokens, max_tokens_per_page) restituiscono errori espliciti.

// Ricerca specifica per paese e lingua
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Risultati recenti (ultima settimana)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Ricerca per intervallo di date
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

// Filtro per dominio (elenco consentiti)
await web_search({
  query: "climate research",
  domain_filter: ["nature.com", "science.org", ".edu"],
});

// Filtro per dominio (elenco esclusi: prefisso -)
await web_search({
  query: "product reviews",
  domain_filter: ["-reddit.com", "-pinterest.com"],
});

// Estrazione di più contenuti
await web_search({
  query: "detailed AI research",
  max_tokens: 50000,
  max_tokens_per_page: 4096,
});

​

Regole del filtro per dominio

• Massimo 20 domini per filtro.
• Non è possibile combinare voci consentite ed escluse nella stessa richiesta.
• Utilizza il prefisso - per le voci escluse (ad esempio ["-reddit.com"]).

​

Note

• L’API Perplexity Search restituisce risultati di ricerca web strutturati (title, url, snippet).
• OpenRouter, oppure un valore esplicito per plugins.entries.perplexity.config.webSearch.baseUrl / model, fa tornare Perplexity alle chat completions di Sonar per compatibilità.
• La compatibilità Sonar/OpenRouter restituisce un’unica risposta sintetizzata con citazioni, non righe di risultati strutturati.
• Per impostazione predefinita, i risultati vengono memorizzati nella cache per 15 minuti (configurabile tramite cacheTtlMinutes).

​

Contenuti correlati