English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Tools

Tavily

يمكن لـ OpenClaw استخدام Tavily بطريقتين:

  • كمزوّد web_search
  • وكأدوات Plugin صريحة: tavily_search وtavily_extract

Tavily هي Search API مصممة لتطبيقات الذكاء الاصطناعي، وتُرجع نتائج منظمة ومحسّنة لاستهلاك LLM. وهي تدعم عمق بحث قابلًا للتهيئة، وترشيحًا حسب الموضوع، ومرشحات للنطاقات، وملخصات إجابات مولدة بالذكاء الاصطناعي، واستخراج المحتوى من عناوين URL (بما في ذلك الصفحات المعروضة عبر JavaScript).

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

  1. أنشئ حساب Tavily على tavily.com.
  2. أنشئ مفتاح API من لوحة التحكم.
  3. خزّنه في الإعداد أو اضبط TAVILY_API_KEY في بيئة gateway.

تهيئة بحث Tavily

{
  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",
      },
    },
  },
}

ملاحظات:

  • يؤدي اختيار Tavily أثناء onboarding أو عبر openclaw configure --section web إلى تفعيل Plugin Tavily المجمّعة تلقائيًا.
  • خزّن إعداد Tavily تحت plugins.entries.tavily.config.webSearch.*.
  • يدعم web_search مع Tavily المعلمتين query وcount (حتى 20 نتيجة).
  • بالنسبة إلى عناصر التحكم الخاصة بـ Tavily مثل search_depth، وtopic، وinclude_answer، أو مرشحات النطاقات، فاستخدم tavily_search.

أدوات Plugin الخاصة بـ Tavily

استخدم هذا عندما تريد عناصر تحكم في البحث خاصة بـ Tavily بدلًا من web_search العامة.

المعلمة الوصف
query سلسلة استعلام البحث (أبقها تحت 400 حرف)
search_depth basic (الافتراضي، متوازن) أو advanced (أعلى صلة، أبطأ)
topic general (الافتراضي)، أو news (تحديثات آنية)، أو finance
max_results عدد النتائج، من 1 إلى 20 (الافتراضي: 5)
include_answer تضمين ملخص إجابة مولد بالذكاء الاصطناعي (الافتراضي: false)
time_range التصفية حسب الحداثة: day، أو week، أو month، أو year
include_domains مصفوفة من النطاقات لقصر النتائج عليها
exclude_domains مصفوفة من النطاقات لاستبعادها من النتائج

عمق البحث:

العمق السرعة الصلة الأنسب لـ
basic أسرع عالية الاستعلامات العامة (الافتراضي)
advanced أبطأ الأعلى الدقة، والحقائق المحددة، والبحث

tavily_extract

استخدم هذا لاستخراج محتوى نظيف من عنوان URL واحد أو أكثر. فهو يتعامل مع الصفحات المعروضة عبر JavaScript ويدعم تقسيمًا مركزًا على الاستعلام من أجل استخراج موجّه.

المعلمة الوصف
urls مصفوفة من عناوين URL المطلوب استخراجها (من 1 إلى 20 لكل طلب)
query إعادة ترتيب الأجزاء المستخرجة حسب صلتها بهذا الاستعلام
extract_depth basic (الافتراضي، سريع) أو advanced (للصفحات الثقيلة بـ JS)
chunks_per_source عدد الأجزاء لكل URL، من 1 إلى 5 (يتطلب query)
include_images تضمين عناوين URL الخاصة بالصور في النتائج (الافتراضي: false)

عمق الاستخراج:

العمق متى يُستخدم
basic الصفحات البسيطة - جرّبه أولًا
advanced تطبيقات SPA المعروضة عبر JS، والمحتوى الديناميكي، والجداول

نصائح:

  • الحد الأقصى هو 20 عنوان URL لكل طلب. قسّم القوائم الأكبر إلى عدة استدعاءات.
  • استخدم query + chunks_per_source للحصول على المحتوى ذي الصلة فقط بدلًا من الصفحات الكاملة.
  • جرّب basic أولًا؛ ثم ارجع إلى advanced إذا كان المحتوى مفقودًا أو غير مكتمل.

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

الحاجة الأداة
بحث ويب سريع، من دون خيارات خاصة web_search
بحث مع العمق، والموضوع، وإجابات الذكاء الاصطناعي tavily_search
استخراج المحتوى من عناوين URL محددة tavily_extract

ذو صلة