Perplexity araması

OpenClaw, Perplexity Search API'yi bir web_search sağlayıcısı olarak destekler. title, url ve snippet alanlarıyla yapılandırılmış sonuçlar döndürür.

OpenClaw, uyumluluk amacıyla eski Perplexity Sonar/OpenRouter kurulumlarını da destekler. OPENROUTER_API_KEY kullanırsanız, plugins.entries.perplexity.config.webSearch.apiKey içinde bir sk-or-... anahtarı kullanırsanız veya plugins.entries.perplexity.config.webSearch.baseUrl / model ayarlarsanız sağlayıcı, sohbet tamamlama yoluna geçer ve yapılandırılmış Search API sonuçları yerine alıntılar içeren, yapay zekâ tarafından sentezlenmiş yanıtlar döndürür.

Plugin'i yükleme

Resmî Plugin'i yükleyin, ardından Gateway'i yeniden başlatın:

openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restart

Perplexity API anahtarı alma

1. perplexity.ai/settings/api adresinde bir Perplexity hesabı oluşturun.
2. Kontrol panelinde bir API anahtarı oluşturun.
3. Anahtarı yapılandırmada saklayın veya Gateway ortamında PERPLEXITY_API_KEY ayarlayın.

OpenRouter uyumluluğu

Perplexity Sonar için zaten OpenRouter kullanıyorsanız provider: "perplexity" değerini koruyun ve Gateway ortamında OPENROUTER_API_KEY ayarlayın veya plugins.entries.perplexity.config.webSearch.apiKey içinde bir sk-or-... anahtarı saklayın.

İsteğe bağlı uyumluluk denetimleri:

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

Yapılandırma örnekleri

Yerel Perplexity Search API

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

OpenRouter / Sonar uyumluluğu

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

Anahtarın ayarlanacağı yer

Yapılandırma aracılığıyla: openclaw configure --section web komutunu çalıştırın. Bu komut, anahtarı plugins.entries.perplexity.config.webSearch.apiKey altında ~/.openclaw/openclaw.json içinde saklar. Bu alan SecretRef nesnelerini de kabul eder.

Ortam aracılığıyla: Gateway işlem ortamında PERPLEXITY_API_KEY veya OPENROUTER_API_KEY ayarlayın. Bir Gateway kurulumu için bunu ~/.openclaw/.env dosyasına (veya hizmet ortamınıza) ekleyin. Bkz. Ortam değişkenleri.

provider: "perplexity" yapılandırılmışsa ve Perplexity anahtarının SecretRef'i çözümlenemiyorsa ve ortam geri dönüşü yoksa başlatma/yeniden yükleme hızlıca başarısız olur.

Araç parametreleri

Bu parametreler yerel Perplexity Search API yolu için geçerlidir.

Eski Sonar/OpenRouter uyumluluk yolu için:

• query, count ve freshness kabul edilir.
• count burada yalnızca uyumluluk içindir; yanıt, N sonuçlu bir liste yerine yine alıntılar içeren tek bir sentezlenmiş yanıttır.
• Yalnızca Search API'ye özgü filtreler (country, language, date_after, date_before, domain_filter, max_tokens, max_tokens_per_page) açık hatalar döndürür.

Örnekler:

// Ülkeye ve dile özgü aramaawait web_search({  query: "yenilenebilir enerji",  country: "DE",  language: "de",}); // Yakın tarihli sonuçlar (geçen hafta)await web_search({  query: "yapay zekâ haberleri",  freshness: "week",}); // Tarih aralığı aramasıawait web_search({  query: "yapay zekâ gelişmeleri",  date_after: "2024-01-01",  date_before: "2024-06-30",}); // Etki alanı filtreleme (izin listesi)await web_search({  query: "iklim araştırması",  domain_filter: ["nature.com", "science.org", ".edu"],}); // Etki alanı filtreleme (engelleme listesi - başına - ekleyin)await web_search({  query: "ürün incelemeleri",  domain_filter: ["-reddit.com", "-pinterest.com"],}); // Daha fazla içerik çıkarmaawait web_search({  query: "ayrıntılı yapay zekâ araştırması",  max_tokens: 50000,  max_tokens_per_page: 4096,});

Etki alanı filtresi kuralları

• Filtre başına en fazla 20 etki alanı.
• Aynı istekte izin listesi ve engelleme listesi girdileri birlikte kullanılamaz.
• Engelleme listesi girdileri için - önekini kullanın (ör. ["-reddit.com"]).

Notlar

• Perplexity Search API, yapılandırılmış web araması sonuçları döndürür (title, url, snippet).
• OpenRouter veya açıkça belirtilmiş bir plugins.entries.perplexity.config.webSearch.baseUrl / model, uyumluluk amacıyla Perplexity'yi yeniden Sonar sohbet tamamlamalarına geçirir.
• Sonar/OpenRouter uyumluluğu, yapılandırılmış sonuç satırları yerine alıntılar içeren tek bir sentezlenmiş yanıt döndürür.
• Sonuçlar varsayılan olarak 15 dakika önbelleğe alınır (cacheTtlMinutes aracılığıyla yapılandırılabilir).

İlgili