Tools
Tavily
Tavily هي واجهة API للبحث مصممة لتطبيقات الذكاء الاصطناعي. يتيحها OpenClaw بطريقتين:
- بصفتها مزود
web_searchلأداة البحث العامة - بصفتها أدوات Plugin صريحة:
tavily_searchوtavily_extract
تعيد Tavily نتائج منظمة محسنة لاستهلاك LLM مع عمق بحث قابل للضبط، وتصفية حسب الموضوع، ومرشحات نطاقات، وملخصات إجابات مولدة بالذكاء الاصطناعي، واستخراج محتوى من عناوين URL (بما في ذلك الصفحات المعروضة بواسطة JavaScript).
| الخاصية | القيمة |
|---|---|
| معرف Plugin | tavily |
| الحزمة | @openclaw/tavily-plugin |
| المصادقة | TAVILY_API_KEY أو الإعداد apiKey |
| عنوان URL الأساسي | https://api.tavily.com (افتراضي) |
| الأدوات | 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-...", // optional if TAVILY_API_KEY is set baseUrl: "https://api.tavily.com", }, }, }, }, }, tools: { web: { search: { provider: "tavily", }, }, },}تحقق من تشغيل البحث
شغّل web_search من أي وكيل، أو استدعِ tavily_search مباشرة.
مرجع الأدوات
tavily_search
استخدم هذا عندما تريد عناصر تحكم بحث خاصة بـ Tavily بدلا من web_search العام.
| المعامل | النوع | القيود / الافتراضي | الوصف |
|---|---|---|---|
query |
string | مطلوب | سلسلة استعلام البحث. اجعلها أقل من 400 حرف. |
search_depth |
enum | basic (افتراضي), advanced |
advanced أبطأ لكنه أعلى صلة. |
topic |
enum | general (افتراضي), news, finance |
التصفية حسب عائلة الموضوع. |
max_results |
integer | 1-20 | عدد النتائج. |
include_answer |
boolean | الافتراضي false |
تضمين ملخص إجابة مولد بالذكاء الاصطناعي من Tavily. |
time_range |
enum | day, week, month, year |
تصفية النتائج حسب الحداثة. |
include_domains |
string array | (لا شيء) | تضمين النتائج من هذه النطاقات فقط. |
exclude_domains |
string array | (لا شيء) | استبعاد النتائج من هذه النطاقات. |
المفاضلة في عمق البحث:
| العمق | السرعة | الصلة | الأنسب لـ |
|---|---|---|---|
basic |
أسرع | عالية | الاستعلامات العامة الغرض (افتراضي). |
advanced |
أبطأ | الأعلى | البحث الدقيق وتقصي الحقائق. |
tavily_extract
استخدم هذا لاستخراج محتوى نظيف من عنوان URL واحد أو أكثر. يتعامل مع الصفحات المعروضة بواسطة JavaScript ويدعم تقسيم المحتوى الموجه بالاستعلام للاستخراج المستهدف.
| المعامل | النوع | القيود / الافتراضي | الوصف |
|---|---|---|---|
urls |
string array | مطلوب، 1-20 | عناوين URL المراد استخراج المحتوى منها. |
query |
string | (اختياري) | إعادة ترتيب المقاطع المستخرجة حسب صلتها بهذا الاستعلام. |
extract_depth |
enum | basic (افتراضي), advanced |
استخدم advanced للصفحات كثيرة الاعتماد على JS، أو تطبيقات SPA، أو الجداول الديناميكية. |
chunks_per_source |
integer | 1-5؛ يتطلب query |
المقاطع المعادة لكل عنوان URL. يسبب خطأ إذا ضُبط بدون query. |
include_images |
boolean | الافتراضي 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_extract خطأ إعداد إذا لم يكن أي منهما موجودا.
عنوان URL أساسي مخصص
تجاوز plugins.entries.tavily.config.webSearch.baseUrl إذا كنت تضع Tavily خلف وكيل. الافتراضي هو https://api.tavily.com.
`chunks_per_source` يتطلب `query`
يرفض tavily_extract الاستدعاءات التي تمرر chunks_per_source بدون query. ترتب Tavily المقاطع حسب صلتها بالاستعلام، لذلك لا معنى للمعامل بدونه.
