Tavily

Tavily AI अनुप्रयोगों के लिए डिज़ाइन किया गया एक खोज API है। OpenClaw इसे दो तरीकों से उपलब्ध कराता है:

सामान्य खोज टूल के लिए web_search प्रदाता के रूप में
स्पष्ट Plugin टूल के रूप में: tavily_search और tavily_extract

Tavily LLM के उपयोग के लिए अनुकूलित संरचित परिणाम देता है, जिनमें कॉन्फ़िगर करने योग्य खोज गहराई, विषय फ़िल्टरिंग, डोमेन फ़िल्टर, AI-जनित उत्तर सारांश और URL से सामग्री निष्कर्षण (JavaScript द्वारा रेंडर किए गए पृष्ठों सहित) शामिल हैं।

गुण	मान
Plugin आईडी	`tavily`
पैकेज	`@openclaw/tavily-plugin`
प्रमाणीकरण	`TAVILY_API_KEY` एनवायरनमेंट वेरिएबल या कॉन्फ़िग `apiKey`
आधार URL	`https://api.tavily.com` (डिफ़ॉल्ट); ओवरराइड करने के लिए `TAVILY_BASE_URL` एनवायरनमेंट वेरिएबल या कॉन्फ़िग `baseUrl`
टाइमआउट	खोज के लिए 30s, निष्कर्षण के लिए 60s (डिफ़ॉल्ट)
टूल	`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 को कॉल करें।

ऑनबोर्डिंग या openclaw configure --section web में Tavily चुनने पर आवश्यकता होने पर आधिकारिक Tavily Plugin इंस्टॉल और सक्षम हो जाता है।

टूल संदर्भ

`tavily_search`

जब सामान्य web_search के बजाय Tavily-विशिष्ट खोज नियंत्रण चाहिए हों, तो इसका उपयोग करें।

पैरामीटर	प्रकार	बाधाएँ / डिफ़ॉल्ट	विवरण
`query`	स्ट्रिंग	आवश्यक	खोज क्वेरी स्ट्रिंग।
`search_depth`	एनम	`basic` (डिफ़ॉल्ट), `advanced`	`advanced` धीमा है, लेकिन अधिक प्रासंगिक है।
`topic`	एनम	`general` (डिफ़ॉल्ट), `news`, `finance`	विषय वर्ग के अनुसार फ़िल्टर करें।
`max_results`	पूर्णांक	1-20, डिफ़ॉल्ट `5`	परिणामों की संख्या।
`include_answer`	बूलियन	डिफ़ॉल्ट `false`	Tavily का AI-जनित उत्तर सारांश शामिल करें।
`time_range`	एनम	`day`, `week`, `month`, `year`	नवीनता के अनुसार परिणाम फ़िल्टर करें।
`include_domains`	स्ट्रिंग ऐरे	(कोई नहीं)	केवल इन डोमेन के परिणाम शामिल करें।
`exclude_domains`	स्ट्रिंग ऐरे	(कोई नहीं)	इन डोमेन के परिणाम बाहर रखें।

खोज गहराई का संतुलन:

गहराई	गति	प्रासंगिकता	इनके लिए सर्वोत्तम
`basic`	अधिक तेज़	उच्च	सामान्य प्रयोजन की क्वेरी (डिफ़ॉल्ट)।
`advanced`	धीमा	उच्चतम	सटीक शोध और तथ्य-अन्वेषण।

`tavily_extract`

एक या अधिक URL से स्वच्छ सामग्री निकालने के लिए इसका उपयोग करें। यह JavaScript द्वारा रेंडर किए गए पृष्ठों को संभालता है और लक्षित निष्कर्षण के लिए क्वेरी-केंद्रित खंडन का समर्थन करता है।

पैरामीटर	प्रकार	बाधाएँ / डिफ़ॉल्ट	विवरण
`urls`	स्ट्रिंग ऐरे	आवश्यक, 1-20	वे URL जिनसे सामग्री निकालनी है।
`query`	स्ट्रिंग	(वैकल्पिक)	इस क्वेरी की प्रासंगिकता के आधार पर निकाले गए खंडों को फिर से क्रमबद्ध करें।
`extract_depth`	एनम	`basic` (डिफ़ॉल्ट), `advanced`	अधिक JS वाले पृष्ठों, SPA या डायनेमिक तालिकाओं के लिए `advanced` का उपयोग करें।
`chunks_per_source`	पूर्णांक	1-5; `query` आवश्यक है	प्रति URL लौटाए गए खंड। `query` के बिना सेट करने पर त्रुटि होती है।
`include_images`	बूलियन	डिफ़ॉल्ट `false`	परिणामों में इमेज URL शामिल करें।

निष्कर्षण गहराई का संतुलन:

गहराई	कब उपयोग करें
`basic`	सरल पृष्ठ। पहले इसे आज़माएँ।
`advanced`	JS द्वारा रेंडर किए गए SPA, डायनेमिक सामग्री, तालिकाएँ।

बड़ी URL सूचियों को कई tavily_extract कॉल में बैच करें (प्रति अनुरोध अधिकतम 20)। पूरे पृष्ठों के बजाय केवल प्रासंगिक सामग्री प्राप्त करने के लिए query के साथ chunks_per_source का उपयोग करें।

सही टूल चुनना

आवश्यकता	टूल
त्वरित वेब खोज, कोई विशेष विकल्प नहीं	`web_search`
गहराई, विषय और AI उत्तरों के साथ खोज	`tavily_search`
विशिष्ट URL से सामग्री निकालना	`tavily_extract`

Tavily को प्रदाता के रूप में उपयोग करने वाला सामान्य web_search टूल query और count (अधिकतम 20 परिणाम) का समर्थन करता है। Tavily-विशिष्ट नियंत्रणों (search_depth, topic, include_answer, डोमेन फ़िल्टर, समय सीमा) के लिए इसके बजाय tavily_search का उपयोग करें।

उन्नत कॉन्फ़िगरेशन

API कुंजी समाधान क्रम

Tavily क्लाइंट अपनी API कुंजी इस क्रम में खोजता है:

plugins.entries.tavily.config.webSearch.apiKey (SecretRefs के माध्यम से समाधान किया गया)।
Gateway एनवायरनमेंट से TAVILY_API_KEY।

यदि इनमें से कोई भी मौजूद नहीं है, तो tavily_search और tavily_extract दोनों सेटअप त्रुटि उत्पन्न करते हैं।

कस्टम आधार URL

यदि Tavily को प्रॉक्सी के माध्यम से उपलब्ध कराया जाता है, तो plugins.entries.tavily.config.webSearch.baseUrl को ओवरराइड करें या TAVILY_BASE_URL सेट करें। कॉन्फ़िग को एनवायरनमेंट वेरिएबल पर प्राथमिकता मिलती है। डिफ़ॉल्ट https://api.tavily.com है।

`chunks_per_source` के लिए `query` आवश्यक है

tavily_extract उन कॉल को अस्वीकार करता है जो query के बिना chunks_per_source पास करती हैं। Tavily क्वेरी प्रासंगिकता के आधार पर खंडों को क्रम देता है, इसलिए इसके बिना यह पैरामीटर अर्थहीन है।

वेब खोज का अवलोकन

सभी प्रदाता और स्वतः-पहचान नियम।

Firecrawl

सामग्री निष्कर्षण के साथ खोज और स्क्रैपिंग।

Exa खोज

सामग्री निष्कर्षण के साथ न्यूरल खोज।

कॉन्फ़िगरेशन

Plugin प्रविष्टियों और टूल रूटिंग के लिए पूर्ण कॉन्फ़िग स्कीमा।

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

आरंभ करना

टूल संदर्भ

`tavily_search`

`tavily_extract`

सही टूल चुनना

उन्नत कॉन्फ़िगरेशन

संबंधित

वेब खोज का अवलोकन

Firecrawl

Exa खोज

कॉन्फ़िगरेशन

​आरंभ करना

​टूल संदर्भ

​tavily_search

​tavily_extract

​सही टूल चुनना

​उन्नत कॉन्फ़िगरेशन

​संबंधित

वेब खोज का अवलोकन

Firecrawl

Exa खोज

कॉन्फ़िगरेशन

आरंभ करना

टूल संदर्भ

`tavily_search`

`tavily_extract`

सही टूल चुनना

उन्नत कॉन्फ़िगरेशन

संबंधित