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 |
| نشانی پایه | https://api.tavily.com (پیشفرض)؛ متغیر محیطی TAVILY_BASE_URL یا پیکربندی baseUrl برای بازنویسی |
| مهلتها | ۳۰ ثانیه برای جستوجو، ۶۰ ثانیه برای استخراج (پیشفرض) |
| ابزارها | tavily_search، tavily_extract |
شروع به کار
نصب Plugin
openclaw plugins install @openclaw/tavily-pluginدریافت کلید API
در tavily.com یک حساب Tavily ایجاد کنید، سپس در داشبورد یک کلید 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
زمانی از این ابزار استفاده کنید که بهجای web_search عمومی، کنترلهای جستوجوی اختصاصی Tavily را میخواهید.
| پارامتر | نوع | محدودیتها / پیشفرض | توضیحات |
|---|---|---|---|
query |
رشته | الزامی | رشتهٔ پرسوجوی جستوجو. |
search_depth |
شمارشی | basic (پیشفرض)، advanced |
advanced کندتر است، اما ارتباط بیشتری با موضوع دارد. |
topic |
شمارشی | general (پیشفرض)، news، finance |
پالایش بر اساس خانوادهٔ موضوعی. |
max_results |
عدد صحیح | ۱ تا ۲۰، پیشفرض 5 |
تعداد نتایج. |
include_answer |
بولی | پیشفرض false |
افزودن خلاصهٔ پاسخ تولیدشده با هوش مصنوعی Tavily. |
time_range |
شمارشی | day، week، month، year |
پالایش نتایج بر اساس تازگی. |
include_domains |
آرایهای از رشته | (هیچکدام) | فقط نتایج این دامنهها را لحاظ میکند. |
exclude_domains |
آرایهای از رشته | (هیچکدام) | نتایج این دامنهها را حذف میکند. |
موازنهٔ عمق جستوجو:
| عمق | سرعت | میزان ارتباط | مناسب برای |
|---|---|---|---|
basic |
سریعتر | زیاد | پرسوجوهای عمومی (پیشفرض). |
advanced |
کندتر | بیشترین | پژوهش دقیق و یافتن اطلاعات واقعی. |
tavily_extract
برای استخراج محتوای پاکسازیشده از یک یا چند نشانی URL از این ابزار استفاده کنید. این ابزار صفحههای رندرشده با JavaScript را پردازش میکند و برای استخراج هدفمند، قطعهبندی متمرکز بر پرسوجو را پشتیبانی میکند.
| پارامتر | نوع | محدودیتها / پیشفرض | توضیحات |
|---|---|---|---|
urls |
آرایهای از رشته | الزامی، ۱ تا ۲۰ | نشانیهای URL که محتوا باید از آنها استخراج شود. |
query |
رشته | (اختیاری) | رتبهبندی دوبارهٔ قطعههای استخراجشده بر اساس ارتباط با این پرسوجو. |
extract_depth |
شمارشی | basic (پیشفرض)، advanced |
برای صفحههای سنگین از نظر JS، برنامههای تکصفحهای یا جدولهای پویا از advanced استفاده کنید. |
chunks_per_source |
عدد صحیح | ۱ تا ۵؛ نیازمند query است |
تعداد قطعههای بازگرداندهشده برای هر URL. اگر بدون query تنظیم شود، خطا میدهد. |
include_images |
بولی | پیشفرض false |
افزودن نشانیهای URL تصاویر به نتایج. |
موازنهٔ عمق استخراج:
| عمق | زمان استفاده |
|---|---|
basic |
صفحههای ساده. ابتدا این گزینه را امتحان کنید. |
advanced |
برنامههای تکصفحهای رندرشده با 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 خطای راهاندازی ایجاد میکنند.
نشانی پایهٔ سفارشی
اگر Tavily را از طریق یک پراکسی در دسترس قرار میدهید، plugins.entries.tavily.config.webSearch.baseUrl را بازنویسی کنید یا TAVILY_BASE_URL را تنظیم کنید. پیکربندی بر متغیر محیطی اولویت دارد. مقدار پیشفرض https://api.tavily.com است.
`chunks_per_source` به `query` نیاز دارد
tavily_extract فراخوانیهایی را که chunks_per_source را بدون query ارسال میکنند، رد میکند. Tavily قطعهها را بر اساس ارتباط با پرسوجو رتبهبندی میکند؛ بنابراین این پارامتر بدون پرسوجو بیمعنا است.
