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 الأساسي

عيّن plugins.entries.exa.config.webSearch.baseUrl لتوجيه طلبات بحث Exa عبر وكيل متوافق أو نقطة نهاية بديلة. يطبّع 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: "transformer architecture explained",  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 الخام من استجابة Exa API عند توفرهما.

أوضاع البحث

الوضع	الوصف
`auto`	تختار Exa أفضل وضع (الافتراضي)
`neural`	بحث دلالي قائم على المعنى
`fast`	بحث سريع بالكلمات المفتاحية
`deep`	بحث عميق وشامل
`deep-reasoning`	بحث عميق مع الاستدلال
`instant`	أسرع النتائج

ملاحظات

يقبل count قيمة تصل إلى 100، وفقًا لحدود نوع البحث في Exa.
تُخزّن النتائج مؤقتًا لمدة 15 دقيقة افتراضيًا. اضبط الإعداد المشترك tools.web.search.cacheTtlMinutes (بالدقائق) وtools.web.search.timeoutSeconds (القيمة الافتراضية 30 ثانية) لتغيير مدة التخزين المؤقت ومهلة الطلب لجميع مزوّدي web_search، بما في ذلك Exa.

ذو صلة

نظرة عامة على بحث الويب -- جميع المزوّدين والاكتشاف التلقائي
Brave Search -- نتائج منظّمة مع عوامل تصفية للبلد واللغة
Perplexity Search -- نتائج منظّمة مع تصفية حسب النطاق

Was this useful?