Tools
Tavily
Tavily هي واجهة API للبحث مصممة لتطبيقات الذكاء الاصطناعي. يتيحها OpenClaw بطريقتين:
- بصفتها موفّر
web_searchلأداة البحث العامة - بصفتها أدوات Plugin صريحة:
tavily_searchوtavily_extract
تُرجع Tavily نتائج منظّمة ومحسّنة لاستخدام النماذج اللغوية الكبيرة، مع عمق بحث قابل للضبط، وتصفية حسب الموضوع، ومرشحات للنطاقات، وملخصات إجابات مولّدة بالذكاء الاصطناعي، واستخراج المحتوى من عناوين URL (بما في ذلك الصفحات المعروضة باستخدام JavaScript).
| الخاصية | القيمة |
|---|---|
| معرّف Plugin | tavily |
| الحزمة | @openclaw/tavily-plugin |
| المصادقة | متغير البيئة TAVILY_API_KEY أو إعداد apiKey |
| عنوان URL الأساسي | https://api.tavily.com (الافتراضي)؛ متغير البيئة TAVILY_BASE_URL أو إعداد baseUrl لتجاوزه |
| المُهل الزمنية | 30 ثانية للبحث، و60 ثانية للاستخراج (افتراضيًا) |
| الأدوات | tavily_search، tavily_extract |
بدء الاستخدام
تثبيت Plugin
openclaw plugins install @openclaw/tavily-pluginالحصول على مفتاح API
أنشئ حساب Tavily على tavily.com، ثم أنشئ مفتاح API في لوحة المعلومات.
تهيئة Plugin والموفّر
{ plugins: { entries: { tavily: { enabled: true, config: { webSearch: { apiKey: "tvly-...", // اختياري إذا كان TAVILY_API_KEY مضبوطًا baseUrl: "https://api.tavily.com", }, }, }, }, }, tools: { web: { search: { provider: "tavily", }, }, },}التحقق من تشغيل البحث
شغّل web_search من أي وكيل، أو استدعِ tavily_search مباشرةً.
مرجع الأدوات
tavily_search
استخدم هذه الأداة عندما تريد عناصر تحكم خاصة ببحث Tavily بدلًا من web_search العام.
| المعامل | النوع | القيود / القيمة الافتراضية | الوصف |
|---|---|---|---|
query |
سلسلة نصية | مطلوب | سلسلة استعلام البحث. |
search_depth |
تعداد | basic (افتراضي)، advanced |
الخيار advanced أبطأ لكنه أعلى صلة. |
topic |
تعداد | general (افتراضي)، news، finance |
التصفية حسب فئة الموضوع. |
max_results |
عدد صحيح | 1-20، الافتراضي 5 |
عدد النتائج. |
include_answer |
قيمة منطقية | الافتراضي false |
تضمين ملخص إجابة مولّد بالذكاء الاصطناعي من Tavily. |
time_range |
تعداد | day، week، month، year |
تصفية النتائج حسب حداثتها. |
include_domains |
مصفوفة سلاسل | (لا شيء) | تضمين النتائج من هذه النطاقات فقط. |
exclude_domains |
مصفوفة سلاسل | (لا شيء) | استبعاد النتائج من هذه النطاقات. |
المفاضلة بين مستويات عمق البحث:
| العمق | السرعة | الصلة | الأنسب لـ |
|---|---|---|---|
basic |
أسرع | عالية | الاستعلامات العامة متعددة الأغراض (افتراضيًا). |
advanced |
أبطأ | الأعلى | البحث الدقيق والتحقق من الحقائق. |
tavily_extract
استخدم هذه الأداة لاستخراج محتوى منقّح من عنوان URL واحد أو أكثر. تتعامل مع الصفحات المعروضة باستخدام JavaScript، وتدعم تقسيم المحتوى الموجّه بالاستعلام للاستخراج المستهدف.
| المعامل | النوع | القيود / القيمة الافتراضية | الوصف |
|---|---|---|---|
urls |
مصفوفة سلاسل | مطلوب، 1-20 | عناوين URL المطلوب استخراج المحتوى منها. |
query |
سلسلة نصية | (اختياري) | إعادة ترتيب المقاطع المستخرجة وفق صلتها بهذا الاستعلام. |
extract_depth |
تعداد | basic (افتراضي)، advanced |
استخدم advanced للصفحات كثيفة JS أو تطبيقات SPA أو الجداول الديناميكية. |
chunks_per_source |
عدد صحيح | 1-5؛ يتطلب query |
عدد المقاطع المُعادة لكل عنوان URL. يحدث خطأ إذا ضُبط من دون query. |
include_images |
قيمة منطقية | الافتراضي false |
تضمين عناوين URL للصور في النتائج. |
المفاضلة بين مستويات عمق الاستخراج:
| العمق | وقت الاستخدام |
|---|---|
basic |
الصفحات البسيطة. جرّب هذا الخيار أولًا. |
advanced |
تطبيقات SPA المعروضة عبر JS والمحتوى والجداول الديناميكية. |
اختيار الأداة المناسبة
| الحاجة | الأداة |
|---|---|
| بحث سريع في الويب دون خيارات خاصة | web_search |
| بحث مع العمق والموضوع وإجابات الذكاء الاصطناعي | tavily_search |
| استخراج المحتوى من عناوين URL محددة | tavily_extract |
التهيئة المتقدمة
ترتيب البحث عن مفتاح API
يبحث عميل Tavily عن مفتاح API بالترتيب التالي:
plugins.entries.tavily.config.webSearch.apiKey(بعد حله عبر SecretRefs).TAVILY_API_KEYمن بيئة Gateway.
تُصدر كل من tavily_search وtavily_extract خطأ إعداد إذا لم يكن أي منهما موجودًا.
عنوان URL أساسي مخصص
تجاوز plugins.entries.tavily.config.webSearch.baseUrl، أو اضبط TAVILY_BASE_URL، إذا كنت تمرّر Tavily عبر وكيل وسيط. تكون للتهيئة أولوية على متغير البيئة. القيمة الافتراضية هي https://api.tavily.com.
يتطلب `chunks_per_source` المعامل `query`
يرفض tavily_extract الاستدعاءات التي تمرّر chunks_per_source من دون query. ترتّب Tavily المقاطع حسب صلتها بالاستعلام، ولذلك لا معنى لهذا المعامل من دونه.
