Tools
Tavily
OpenClaw میتواند از Tavily به دو روش استفاده کند:
- بهعنوان ارائهدهندهی
web_search - بهعنوان ابزارهای صریح Plugin:
tavily_searchوtavily_extract
Tavily یک API جستوجو است که برای برنامههای AI طراحی شده و نتایج ساختیافتهای را برمیگرداند که برای مصرف LLM بهینه شدهاند. این سرویس از عمق جستوجوی قابل پیکربندی، فیلترکردن موضوع، فیلترهای دامنه، خلاصههای پاسخ تولیدشده با AI، و استخراج محتوا از URLها (از جمله صفحههای رندرشده با JavaScript) پشتیبانی میکند.
دریافت کلید API
- در tavily.com یک حساب Tavily بسازید.
- در داشبورد یک کلید API تولید کنید.
- آن را در پیکربندی ذخیره کنید یا
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_search
وقتی بهجای web_search عمومی، کنترلهای جستوجوی اختصاصی Tavily را میخواهید
از این استفاده کنید.
| پارامتر | توضیح |
|---|---|
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 (برای صفحههای سنگین از نظر 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 |
| جستوجو با عمق، موضوع، پاسخهای AI | tavily_search |
| استخراج محتوا از URLهای مشخص | tavily_extract |
مرتبط
- نمای کلی جستوجوی وب -- همهی ارائهدهندهها و تشخیص خودکار
- Firecrawl -- جستوجو + خزش با استخراج محتوا
- Exa Search -- جستوجوی عصبی با استخراج محتوا