phaseo:web_search जोड़ें, ताकि मॉडल को नवीनतम या स्रोत-आधारित जानकारी चाहिए तो वह वेब खोज सके। मॉडल query लिखता है और एक अनुरोध में कई बार खोज सकता है; Phaseo URL, शीर्षक, स्निपेट, हाइलाइट और वैकल्पिक रूप से पेज टेक्स्ट लौटाता है, और मॉडल स्रोत-आधारित उत्तर लिखता है।
/v1/responses और /v1/messages पर tools में भी काम करती है।
पैरामीटर
मॉडल क्या भेजता है
हर कॉल में एकquery होती है। मॉडल max_results, engine, search_context_size, डोमेन सूचियां, include_text, include_highlights, max_characters और ये स्थानीयकरण संकेत भी भेज सकता है:
मॉडल जो मान भेजता है, वे उस कॉल के लिए टूल के डिफ़ॉल्ट की जगह लेते हैं।
max_results फिर भी max_total_results में बचे हिस्से तक सीमित रहता है; वह खत्म होने पर आगे की कॉल max_total_results_reached लौटाती हैं।
इंजन चुनें
अगर कोई प्रबंधित इंजन सक्षम नहीं है, तो कॉल मॉडल को
search_not_configured लौटाती है।
/v1/chat/completions या /v1/responses पर engine: "native" के साथ अनुरोध सिर्फ़ उन प्रदाताओं को जाता है जो खुद वेब खोज चलाते हैं। अगर कोई भी प्रदाता मॉडल को सर्व नहीं करता, तो Phaseo अपना डिफ़ॉल्ट इंजन चलाता है और उसका बिल प्रबंधित खोज के रूप में बनाता है।
इन एंडपॉइंट पर जो प्रदाता खुद वेब खोज चलाते हैं, वे हैं OpenAI, /v1/responses पर Azure OpenAI डिप्लॉयमेंट, xAI, और deepseek/deepseek-v4.1-flash-1017 पर DeepSeek। DeepSeek खुद खोज तभी चलाता है जब वेब खोज अनुरोध का एकमात्र टूल हो, उसमें कोई डोमेन सूची या उपयोगकर्ता की लोकेशन न हो, JSON आउटपुट न माँगा गया हो और tool_choice कोई टूल ज़बरदस्ती न चुनता हो। उसका API डोमेन सूचियों, लोकेशन और JSON आउटपुट को अस्वीकार करता है, अनुरोध में दूसरे टूल होने पर अपनी वेब खोज बंद कर देता है, और खोज को ज़बरदस्ती नहीं चला सकता। उस मॉडल के बाकी अनुरोध इसके बजाय Phaseo की खोज इस्तेमाल करते हैं, जो आपके अपने टूल के साथ काम करती है। reasoning चालू होने पर DeepSeek ज़्यादा गहरी खोज चलाता है, जो कई चरणों में पेज खोलकर पढ़ती है।
OpenAI का अपना { "type": "web_search" } टूल भेजना engine: "native" की तरह ही काम करता है। native सिर्फ़ टूल परिभाषा में सेट करें: अगर मॉडल किसी कॉल में native मांगता है, तो कॉल unsupported_search_engine लौटाती है, क्योंकि प्रदाता का टूल अनुरोध भेजने से पहले चुनना होता है।
डोमेन से फ़िल्टर करें
जब उत्तर स्रोतों के एक तय सेट से ही आना चाहिए, तबallowed_domains उपयोग करें, और खुली खोज से कुछ खास साइटें हटाने के लिए excluded_domains।
- Perplexity दोनों में से एक ही सूची लेता है, दोनों नहीं, और अधिकतम 20 डोमेन। बाहर रखे गए डोमेन उसके deny-list फ़ॉर्मेट में भेजे जाते हैं।
- Firecrawl दोनों में से एक ही सूची लेता है, दोनों नहीं।
- TinyFish दोनों लेता है और उन्हें query में
site:और-site:ऑपरेटर में बदल देता है। - DeepSeek दोनों लेता है और उन्हें
site:और-site:ऑपरेटर में बदल देता है। इसकी queries 128 अक्षरों तक सीमित हैं, इसलिए ऑपरेटर के लिए जगह बनाने हेतु query छोटी कर दी जाती है। अगर अकेली डोमेन सूचियाँ ही सीमा पार कर दें, तो कॉलsearch_query_too_longलौटाती है।
टूल क्या लौटाता है
एक JSON परिणाम, जिसमें इंजन, query और एकresults ऐरे होता है। हर परिणाम में title, url, snippet या highlights होते हैं, और text तब, जब पेज टेक्स्ट मांगा गया हो और इंजन उसे देता हो।
उपयोग और मूल्य
हर खोजusage.server_tool_use में जुड़ती है:
server_tool_web_search_requests और server_tool_web_search_extra_results के लिए अपनी कीमतें तय न करे। असफल searches का शुल्क नहीं लगता, और TinyFish Search अपने प्रकाशित प्लान पर मुफ़्त है, इसलिए engine: "tinyfish" कोई search शुल्क नहीं जोड़ता। सशुल्क engines पर searches के लिए क्रेडिट चाहिए, भले ही मॉडल मुफ़्त हो। Native search का बिल native_web_search_requests से प्रदाता की प्रकाशित कीमत पर बनता है: उदाहरण के लिए OpenAI और Anthropic पर $10 प्रति 1,000 searches, और DeepSeek पर $0.75 प्रति 1,000, जहाँ सिर्फ़ वे searches गिनी जाती हैं जो results लौटाती हैं। DeepSeek हर page fetch का भी, यानी जब वह अपने link-reading टूल से कोई URL पढ़ता है, $0.75 प्रति 1,000 के हिसाब से बिल बनाता है, native_web_fetch_requests के रूप में। reasoning चालू होने पर DeepSeek का एक जवाब दर्जन भर या उससे ज़्यादा खोजें चला सकता है, और वह जो नतीजे पढ़ता है वे इनपुट टोकन में जुड़ते हैं।