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
وقتی بهجای web_search عمومی، کنترلهای جستوجوی مخصوص Tavily را میخواهید از این ابزار استفاده کنید.
| پارامتر | نوع | محدودیتها / پیشفرض | توضیح |
|---|---|---|---|
query |
string | الزامی | رشته پرسوجوی جستوجو. کمتر از ۴۰۰ نویسه نگه دارید. |
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 |
برای صفحههای سنگین از نظر JS، SPAها، یا جدولهای پویا از advanced استفاده کنید. |
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 پایه سفارشی
اگر Tavily را از طریق یک پراکسی جلوی مسیر قرار میدهید، plugins.entries.tavily.config.webSearch.baseUrl را بازنویسی کنید. مقدار پیشفرض https://api.tavily.com است.
`chunks_per_source` به `query` نیاز دارد
tavily_extract فراخوانیهایی را که chunks_per_source را بدون query ارسال میکنند رد میکند. Tavily قطعهها را بر اساس ارتباط با پرسوجو رتبهبندی میکند، بنابراین این پارامتر بدون آن بیمعنا است.
