Tools

جست‌وجوی Exa

Exa AI یک ارائه‌دهندهٔ web_search با حالت‌های جست‌وجوی عصبی، کلیدواژه‌ای و ترکیبی، به‌همراه استخراج داخلی محتوا (نکات برجسته، متن و خلاصه‌ها) است.

نصب Plugin

bash

openclaw plugins install @openclaw/exa-pluginopenclaw gateway restart

دریافت کلید API

ایجاد حساب

در exa.ai ثبت‌نام کنید و از داشبورد خود یک کلید API ایجاد کنید.

ذخیره کلید

EXA_API_KEY را در محیط Gateway تنظیم کنید، یا از طریق دستور زیر پیکربندی کنید:

bash

openclaw configure --section web

پیکربندی

json5

{  plugins: {    entries: {      exa: {        config: {          webSearch: {            apiKey: "exa-...", // در صورت تنظیم EXA_API_KEY اختیاری است            baseUrl: "https://api.exa.ai", // اختیاری؛ OpenClaw مقدار /search را می‌افزاید          },        },      },    },  },  tools: {    web: {      search: {        provider: "exa",      },    },  },}

جایگزین محیطی: EXA_API_KEY را در محیط Gateway تنظیم کنید. برای نصب Gateway، آن را در ~/.openclaw/.env قرار دهید. به متغیرهای محیطی مراجعه کنید.

بازنویسی URL پایه

برای هدایت درخواست‌های جست‌وجوی Exa از طریق یک پراکسی سازگار یا نقطهٔ پایانی جایگزین، plugins.entries.exa.config.webSearch.baseUrl را تنظیم کنید. OpenClaw میزبان‌های بدون طرح را با افزودن https:// در ابتدا عادی‌سازی می‌کند و /search را می‌افزاید، مگر اینکه مسیر از قبل به آن ختم شود. نقطهٔ پایانی حل‌شده بخشی از کلید کش جست‌وجو است؛ بنابراین نتایج نقاط پایانی مختلف هرگز با یکدیگر به‌اشتراک گذاشته نمی‌شوند.

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

querystringrequired

پرس‌وجوی جست‌وجو.

countnumberdefault: 5

تعداد نتایج بازگشتی (1-100، مشروط به محدودیت‌های نوع جست‌وجوی Exa).

حالت جست‌وجو.

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

فیلتر زمانی. نمی‌توان آن را با date_after/date_before ترکیب کرد.

date_afterstring

نتایج پس از این تاریخ (YYYY-MM-DD).

date_beforestring

نتایج پیش از این تاریخ (YYYY-MM-DD).

contentsobject

گزینه‌های استخراج محتوا (در ادامه ببینید).

استخراج محتوا

برای کنترل محتوای استخراج‌شده در نتایج، یک شیء contents ارسال کنید:

javascript

await web_search({  query: "توضیح معماری ترنسفورمر",  type: "neural",  contents: {    text: true, // متن کامل صفحه    highlights: { numSentences: 3 }, // جمله‌های کلیدی    summary: true, // خلاصه تولیدشده با هوش مصنوعی  },});

گزینه محتوا	نوع	توضیحات
`text`	`boolean \| { maxCharacters }`	استخراج متن کامل صفحه
`highlights`	`boolean \| { maxCharacters, query, numSentences, highlightsPerUrl }`	استخراج جمله‌های کلیدی
`summary`	`boolean \| { query }`	خلاصه تولیدشده با هوش مصنوعی

اگر contents حذف شود، مقدار پیش‌فرض Exa برابر { highlights: true } است تا نتایج شامل گزیده‌هایی از جمله‌های کلیدی باشند. توضیحات نتایج ابتدا از نکات برجسته، سپس خلاصه و بعد متن کامل تأمین می‌شوند؛ هرکدام که زودتر در دسترس باشد. نتایج همچنین در صورت موجود بودن، فیلدهای خام highlightScores و summary را از پاسخ API ‏Exa حفظ می‌کنند.

حالت‌های جست‌وجو

حالت	توضیحات
`auto`	Exa بهترین حالت را انتخاب می‌کند (پیش‌فرض)
`neural`	جست‌وجوی معنایی/مبتنی بر مفهوم
`fast`	جست‌وجوی سریع کلیدواژه‌ای
`deep`	جست‌وجوی عمیق و جامع
`deep-reasoning`	جست‌وجوی عمیق همراه با استدلال
`instant`	سریع‌ترین نتایج

نکات

count تا سقف 100 را، مشروط به محدودیت‌های نوع جست‌وجوی Exa، می‌پذیرد.
نتایج به‌طور پیش‌فرض برای 15 دقیقه کش می‌شوند. برای تغییر کش و زمان پایان درخواست برای همهٔ ارائه‌دهندگان web_search، از جمله Exa، مقادیر مشترک tools.web.search.cacheTtlMinutes (دقیقه) و tools.web.search.timeoutSeconds (پیش‌فرض 30 ثانیه) را پیکربندی کنید.

مرتبط

نمای کلی جست‌وجوی وب -- همهٔ ارائه‌دهندگان و تشخیص خودکار
Brave Search -- نتایج ساختاریافته با فیلترهای کشور/زبان
Perplexity Search -- نتایج ساختاریافته با فیلتر دامنه

Was this useful?