Tools

Perplexity खोज

OpenClaw, Perplexity Search API को web_search प्रदाता के रूप में समर्थन देता है। यह title, url, और snippet फ़ील्ड वाले संरचित परिणाम लौटाता है।

संगतता के लिए, OpenClaw पुराने Perplexity Sonar/OpenRouter सेटअप का भी समर्थन करता है। यदि आप OPENROUTER_API_KEY, plugins.entries.perplexity.config.webSearch.apiKey में कोई sk-or-... कुंजी उपयोग करते हैं, या plugins.entries.perplexity.config.webSearch.baseUrl / model सेट करते हैं, तो प्रदाता चैट-कम्प्लीशन्स पथ पर स्विच हो जाता है और संरचित Search API परिणामों के बजाय उद्धरणों सहित AI-संश्लेषित उत्तर लौटाता है।

Plugin इंस्टॉल करें

आधिकारिक Plugin इंस्टॉल करें, फिर Gateway पुनः आरंभ करें:

bash
openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restart

Perplexity API कुंजी प्राप्त करना

  1. perplexity.ai/settings/api पर Perplexity खाता बनाएँ।
  2. डैशबोर्ड में API कुंजी जनरेट करें।
  3. कुंजी को कॉन्फ़िगरेशन में संग्रहीत करें या Gateway परिवेश में PERPLEXITY_API_KEY सेट करें।

OpenRouter संगतता

यदि आप Perplexity Sonar के लिए पहले से OpenRouter का उपयोग कर रहे थे, तो provider: "perplexity" बनाए रखें और Gateway परिवेश में OPENROUTER_API_KEY सेट करें, या plugins.entries.perplexity.config.webSearch.apiKey में कोई sk-or-... कुंजी संग्रहीत करें।

वैकल्पिक संगतता नियंत्रण:

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

कॉन्फ़िगरेशन उदाहरण

मूल Perplexity Search API

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

OpenRouter / Sonar संगतता

json5
{  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 चलाएँ। यह कुंजी को plugins.entries.perplexity.config.webSearch.apiKey के अंतर्गत ~/.openclaw/openclaw.json में संग्रहीत करता है। यह फ़ील्ड SecretRef ऑब्जेक्ट भी स्वीकार करता है।

परिवेश के माध्यम से: Gateway प्रक्रिया परिवेश में PERPLEXITY_API_KEY या OPENROUTER_API_KEY सेट करें। Gateway इंस्टॉलेशन के लिए, इसे ~/.openclaw/.env (या अपने सेवा परिवेश) में रखें। परिवेश चर देखें।

यदि provider: "perplexity" कॉन्फ़िगर किया गया है और Perplexity कुंजी का SecretRef बिना किसी परिवेश फ़ॉलबैक के अनिर्णीत है, तो स्टार्टअप/रीलोड तुरंत विफल हो जाता है।

टूल पैरामीटर

ये पैरामीटर मूल Perplexity Search API पथ पर लागू होते हैं।

querystringrequired

खोज क्वेरी।

countnumberdefault: 5

लौटाए जाने वाले परिणामों की संख्या (1-10)।

countrystring

2-अक्षर वाला ISO देश कोड (उदा. US, DE)।

languagestring

ISO 639-1 भाषा कोड (उदा. en, de, fr)।

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

समय फ़िल्टर - day का अर्थ 24 घंटे है।

date_afterstring

केवल इस तारीख (YYYY-MM-DD) के बाद प्रकाशित परिणाम।

date_beforestring

केवल इस तारीख (YYYY-MM-DD) से पहले प्रकाशित परिणाम।

domain_filterstring[]

डोमेन अनुमति-सूची/अस्वीकृति-सूची ऐरे (अधिकतम 20)।

max_tokensnumberdefault: 25000

कुल सामग्री बजट (अधिकतम 1000000)।

max_tokens_per_pagenumberdefault: 2048

प्रति-पृष्ठ टोकन सीमा।

पुराने Sonar/OpenRouter संगतता पथ के लिए:

  • query, count, और freshness स्वीकार किए जाते हैं।
  • count वहाँ केवल संगतता के लिए है; प्रतिक्रिया फिर भी N-परिणाम सूची के बजाय उद्धरणों वाला एक संश्लेषित उत्तर होती है।
  • केवल Search API वाले फ़िल्टर (country, language, date_after, date_before, domain_filter, max_tokens, max_tokens_per_page) स्पष्ट त्रुटियाँ लौटाते हैं।

उदाहरण:

javascript
// देश और भाषा-विशिष्ट खोजawait web_search({  query: "नवीकरणीय ऊर्जा",  country: "DE",  language: "de",}); // हाल के परिणाम (पिछला सप्ताह)await web_search({  query: "AI समाचार",  freshness: "week",}); // तारीख सीमा खोजawait web_search({  query: "AI विकास",  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: "विस्तृत AI अनुसंधान",  max_tokens: 50000,  max_tokens_per_page: 4096,});

डोमेन फ़िल्टर नियम

  • प्रति फ़िल्टर अधिकतम 20 डोमेन।
  • एक ही अनुरोध में अनुमति-सूची और अस्वीकृति-सूची प्रविष्टियाँ मिश्रित नहीं की जा सकतीं।
  • अस्वीकृति-सूची प्रविष्टियों के लिए - उपसर्ग का उपयोग करें (उदा., ["-reddit.com"])।

टिप्पणियाँ

  • Perplexity Search API संरचित वेब खोज परिणाम (title, url, snippet) लौटाता है।
  • OpenRouter, या स्पष्ट plugins.entries.perplexity.config.webSearch.baseUrl / model, संगतता के लिए Perplexity को वापस Sonar चैट कम्प्लीशन्स पर स्विच करता है।
  • Sonar/OpenRouter संगतता संरचित परिणाम पंक्तियों के बजाय उद्धरणों वाला एक संश्लेषित उत्तर लौटाती है।
  • डिफ़ॉल्ट रूप से परिणाम 15 मिनट के लिए कैश किए जाते हैं (cacheTtlMinutes के माध्यम से कॉन्फ़िगर करने योग्य)।

संबंधित

Was this useful?
On this page

On this page