الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Tavily هي واجهة API للبحث مصممة لتطبيقات الذكاء الاصطناعي. يتيحها OpenClaw بطريقتين:
  • بصفتها مزود web_search لأداة البحث العامة
  • بصفتها أدوات Plugin صريحة: tavily_search وtavily_extract
ترجع Tavily نتائج مهيكلة محسنة لاستهلاك نماذج LLM مع عمق بحث قابل للضبط، وتصفية حسب الموضوع، ومرشحات نطاقات، وملخصات إجابات مولدة بالذكاء الاصطناعي، واستخراج محتوى من عناوين URL (بما في ذلك الصفحات المعروضة عبر JavaScript).
الخاصيةالقيمة
معرف Plugintavily
المصادقةTAVILY_API_KEY أو config apiKey
عنوان URL الأساسيhttps://api.tavily.com (الافتراضي)
الأدوات المضمنةtavily_search, tavily_extract

​
البدء

1

احصل على مفتاح API

أنشئ حساب Tavily على tavily.com، ثم أنشئ مفتاح API في لوحة التحكم.
2

اضبط Plugin والمزود

{
  plugins: {
    entries: {
      tavily: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "tvly-...", // optional if TAVILY_API_KEY is set
            baseUrl: "https://api.tavily.com",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "tavily",
      },
    },
  },
}
3

تحقق من تشغيل البحث

شغل web_search من أي وكيل، أو استدع tavily_search مباشرة.
اختيار Tavily أثناء الإعداد الأولي أو عبر openclaw configure --section web يمكّن Tavily Plugin المضمن تلقائيا.

​
مرجع الأدوات

استخدم هذا عندما تريد عناصر تحكم بحث خاصة بـ Tavily بدلا من web_search العامة.
المعاملالنوعالقيود / الافتراضيالوصف
querystringمطلوبسلسلة استعلام البحث. أبقها أقل من 400 حرف.
search_depthenumbasic (الافتراضي), advancedadvanced أبطأ لكنها أعلى صلة.
topicenumgeneral (الافتراضي), news, financeالتصفية حسب عائلة الموضوع.
max_resultsinteger1-20عدد النتائج.
include_answerbooleanالافتراضي falseتضمين ملخص إجابة مولد بالذكاء الاصطناعي من Tavily.
time_rangeenumday, week, month, yearتصفية النتائج حسب الحداثة.
include_domainsstring array(لا شيء)تضمين النتائج من هذه النطاقات فقط.
exclude_domainsstring array(لا شيء)استبعاد النتائج من هذه النطاقات.
مفاضلة عمق البحث:
العمقالسرعةالصلةالأنسب لـ
basicأسرععاليةالاستعلامات العامة (الافتراضي).
advancedأبطأالأعلىالبحث الدقيق وتقصي الحقائق.

​
tavily_extract

استخدم هذا لاستخراج محتوى نظيف من عنوان URL واحد أو أكثر. يتعامل مع الصفحات المعروضة عبر JavaScript ويدعم التقسيم المركز على الاستعلام للاستخراج الموجه.
المعاملالنوعالقيود / الافتراضيالوصف
urlsstring arrayمطلوب، 1-20عناوين URL لاستخراج المحتوى منها.
querystring(اختياري)إعادة ترتيب الأجزاء المستخرجة حسب صلتها بهذا الاستعلام.
extract_depthenumbasic (الافتراضي), advancedاستخدم advanced للصفحات الكثيفة بـ JS أو تطبيقات SPA أو الجداول الديناميكية.
chunks_per_sourceinteger1-5; يتطلب queryالأجزاء المرجعة لكل عنوان URL. يحدث خطأ إذا ضبط دون query.
include_imagesbooleanالافتراضي falseتضمين عناوين URL للصور في النتائج.
مفاضلة عمق الاستخراج:
العمقمتى تستخدمه
basicالصفحات البسيطة. جرب هذا أولا.
advancedتطبيقات SPA المعروضة عبر JS، والمحتوى الديناميكي، والجداول.
قسّم قوائم عناوين URL الأكبر إلى عدة استدعاءات tavily_extract (الحد الأقصى 20 لكل طلب). استخدم query مع chunks_per_source للحصول على المحتوى ذي الصلة فقط بدلا من الصفحات الكاملة.

​
اختيار الأداة المناسبة

الحاجةالأداة
بحث ويب سريع، بلا خيارات خاصةweb_search
بحث مع العمق والموضوع وإجابات الذكاء الاصطناعيtavily_search
استخراج محتوى من عناوين URL محددةtavily_extract
تدعم أداة web_search العامة مع Tavily كمزود query وcount (حتى 20 نتيجة). لعناصر التحكم الخاصة بـ Tavily (search_depth، وtopic، وinclude_answer، ومرشحات النطاقات، والنطاق الزمني)، استخدم tavily_search بدلا من ذلك.

​
الإعداد المتقدم

يبحث عميل Tavily عن مفتاح API الخاص به بهذا الترتيب:
  1. plugins.entries.tavily.config.webSearch.apiKey (يتم حله عبر SecretRefs).
  2. TAVILY_API_KEY من بيئة Gateway.
يرفع tavily_extract خطأ إعداد إذا لم يكن أي منهما موجودا.
تجاوز plugins.entries.tavily.config.webSearch.baseUrl إذا كنت تمرر Tavily عبر وكيل. الافتراضي هو https://api.tavily.com.
يرفض tavily_extract الاستدعاءات التي تمرر chunks_per_source دون query. ترتب Tavily الأجزاء حسب صلتها بالاستعلام، لذلك لا يكون للمعامل معنى بدونه.

​
ذو صلة

نظرة عامة على Web Search

جميع المزودين وقواعد الاكتشاف التلقائي.

Firecrawl

بحث مع كشط واستخراج محتوى.

Exa Search

بحث عصبي مع استخراج محتوى.

الإعداد

مخطط الإعداد الكامل لإدخالات Plugin وتوجيه الأدوات.