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

​
Tavily

يمكن لـ OpenClaw استخدام Tavily بطريقتين:
  • كمزوّد web_search
  • كأدوات plugin صريحة: tavily_search و tavily_extract
Tavily عبارة عن API بحث مصممة لتطبيقات AI، وتعيد نتائج منظَّمة مُحسّنة لاستهلاك LLM. وهي تدعم عمق بحث قابلًا للضبط، وتصفية حسب الموضوع، ومرشحات النطاقات، وملخصات إجابات مولّدة بواسطة AI، واستخراج المحتوى من عناوين 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 أثناء الإعداد الأولي أو عبر 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تضمين ملخص إجابة مولّد بواسطة AI ‏(الافتراضي: 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 ‏(للصفحات الثقيلة بـ JavaScript)
chunks_per_sourceعدد الأجزاء لكل URL، من 1 إلى 5 ‏(يتطلب query)
include_imagesتضمين عناوين URL للصور في النتائج ‏(الافتراضي: false)
عمق الاستخراج:
العمقمتى يُستخدم
basicالصفحات البسيطة - جرّبه أولًا
advancedتطبيقات SPA المعروضة بـ JavaScript، والمحتوى الديناميكي، والجداول
نصائح:
  • الحد الأقصى 20 عنوان URL لكل طلب. قسّم القوائم الأكبر إلى عدة استدعاءات.
  • استخدم query + chunks_per_source للحصول على المحتوى ذي الصلة فقط بدلًا من الصفحات الكاملة.
  • جرّب basic أولًا؛ ثم ارجع إلى advanced إذا كان المحتوى مفقودًا أو غير مكتمل.

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

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

​
ذو صلة