جست‌وجوی Perplexity

OpenClaw از API جست‌وجوی Perplexity به‌عنوان ارائه‌دهنده web_search پشتیبانی می‌کند. این API نتایج ساختاریافته را با فیلدهای title، url و snippet برمی‌گرداند.

برای سازگاری، OpenClaw از پیکربندی‌های قدیمی Perplexity Sonar/OpenRouter نیز پشتیبانی می‌کند. اگر از OPENROUTER_API_KEY، کلید sk-or-... در plugins.entries.perplexity.config.webSearch.apiKey استفاده کنید یا plugins.entries.perplexity.config.webSearch.baseUrl / model را تنظیم کنید، ارائه‌دهنده به مسیر تکمیل‌های چت تغییر می‌کند و به‌جای نتایج ساختاریافته API جست‌وجو، پاسخ‌های ترکیب‌شده توسط هوش مصنوعی را همراه با ارجاعات برمی‌گرداند.

نصب Plugin

Plugin رسمی را نصب کنید، سپس Gateway را راه‌اندازی مجدد کنید:

openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restart

دریافت کلید API پرپلکسیتی

1. یک حساب Perplexity در perplexity.ai/settings/api ایجاد کنید.
2. یک کلید API در داشبورد ایجاد کنید.
3. کلید را در پیکربندی ذخیره کنید یا PERPLEXITY_API_KEY را در محیط Gateway تنظیم کنید.

سازگاری با OpenRouter

اگر از قبل برای Perplexity Sonar از OpenRouter استفاده می‌کردید، provider: "perplexity" را نگه دارید و OPENROUTER_API_KEY را در محیط Gateway تنظیم کنید، یا کلید sk-or-... را در plugins.entries.perplexity.config.webSearch.apiKey ذخیره کنید.

کنترل‌های اختیاری سازگاری:

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

نمونه‌های پیکربندی

API جست‌وجوی بومی Perplexity

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

سازگاری با 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",      },    },  },}

محل تنظیم کلید

از طریق پیکربندی: دستور openclaw configure --section web را اجرا کنید. این دستور کلید را در ~/.openclaw/openclaw.json زیر plugins.entries.perplexity.config.webSearch.apiKey ذخیره می‌کند. این فیلد اشیای SecretRef را نیز می‌پذیرد.

از طریق محیط: PERPLEXITY_API_KEY یا OPENROUTER_API_KEY را در محیط فرایند Gateway تنظیم کنید. برای نصب Gateway، آن را در ~/.openclaw/.env (یا محیط سرویس خود) قرار دهید. به متغیرهای محیطی مراجعه کنید.

اگر provider: "perplexity" پیکربندی شده باشد و SecretRef کلید Perplexity بدون جایگزین محیطی حل‌نشده باقی بماند، راه‌اندازی یا بارگذاری مجدد فوراً با شکست مواجه می‌شود.

پارامترهای ابزار

این پارامترها برای مسیر API جست‌وجوی بومی Perplexity کاربرد دارند.

برای مسیر سازگاری قدیمی Sonar/OpenRouter:

• query، count و freshness پذیرفته می‌شوند.
• count در آن مسیر فقط برای سازگاری است؛ پاسخ همچنان یک پاسخ ترکیب‌شده همراه با ارجاعات است، نه فهرستی با N نتیجه.
• فیلترهای مختص API جست‌وجو (country، language، date_after، date_before، domain_filter، max_tokens، max_tokens_per_page) خطاهای صریح برمی‌گردانند.

نمونه‌ها:

// جست‌وجوی ویژه کشور و زبانawait web_search({  query: "انرژی تجدیدپذیر",  country: "DE",  language: "de",}); // نتایج اخیر (هفته گذشته)await web_search({  query: "اخبار هوش مصنوعی",  freshness: "week",}); // جست‌وجو در بازه زمانیawait web_search({  query: "تحولات هوش مصنوعی",  date_after: "2024-01-01",  date_before: "2024-06-30",}); // فیلتر دامنه (فهرست مجاز)await web_search({  query: "پژوهش اقلیمی",  domain_filter: ["nature.com", "science.org", ".edu"],}); // فیلتر دامنه (فهرست مسدود ـ با - پیشوندگذاری کنید)await web_search({  query: "بررسی محصولات",  domain_filter: ["-reddit.com", "-pinterest.com"],}); // استخراج محتوای بیشترawait web_search({  query: "پژوهش تفصیلی هوش مصنوعی",  max_tokens: 50000,  max_tokens_per_page: 4096,});

قواعد فیلتر دامنه

• حداکثر 20 دامنه در هر فیلتر.
• نمی‌توان ورودی‌های فهرست مجاز و فهرست مسدود را در یک درخواست ترکیب کرد.
• برای ورودی‌های فهرست مسدود از پیشوند - استفاده کنید (برای مثال ["-reddit.com"]).

نکات

• API جست‌وجوی Perplexity نتایج ساختاریافته جست‌وجوی وب را برمی‌گرداند (title، url، snippet).
• OpenRouter یا plugins.entries.perplexity.config.webSearch.baseUrl / model صریح، برای سازگاری Perplexity را دوباره به تکمیل‌های چت Sonar تغییر می‌دهد.
• سازگاری Sonar/OpenRouter یک پاسخ ترکیب‌شده همراه با ارجاعات برمی‌گرداند، نه ردیف‌های نتایج ساختاریافته.
• نتایج به‌طور پیش‌فرض برای 15 دقیقه در حافظه نهان نگه‌داری می‌شوند (از طریق cacheTtlMinutes قابل پیکربندی است).

مرتبط