वेब खोज सर्वर टूल

जब मॉडल को नवीनतम या स्रोत-आधारित जानकारी चाहिए, तब phaseo:web_search उपयोग करें। मॉडल तय करता है कि कब खोजना है, query लिखता है और एक अनुरोध में कई बार खोज सकता है। Phaseo मॉडल को URLs, titles, snippets, highlights और वैकल्पिक page text देता है, ताकि वह स्रोत-आधारित उत्तर लिख सके।

TinyFish Search वैकल्पिक प्रबंधित इंजन के रूप में उपलब्ध है। समर्थित रूट पर engine: "native" से प्रदाता की मूल खोज भी उपलब्ध रहती है।

यह कैसे काम करता है

{ "type": "phaseo:web_search" } को tools में जोड़ें।
मॉडल तय करता है कि खोज करनी है या नहीं और query भेजता है।
Phaseo configured engine से खोज करता है।
परिणाम tool context के रूप में मॉडल को लौटाए जाते हैं।
मॉडल अंतिम उत्तर लिखता है और ज़रूरत पड़ने पर फिर खोज सकता है।

त्वरित शुरुआत

curl https://api.phaseo.app/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5-nano",
    "messages": [
      { "role": "user", "content": "What were the major AI announcements this week?" }
    ],
    "tools": [
      { "type": "phaseo:web_search" }
    ]
  }'

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

{
  "type": "phaseo:web_search",
  "parameters": {
    "engine": "exa",
    "max_results": 5,
    "max_total_results": 15,
    "search_context_size": "medium",
    "max_characters": 2048,
    "allowed_domains": ["arxiv.org", "nature.com"],
    "excluded_domains": ["reddit.com"],
    "include_highlights": true,
    "include_text": false
  }
}

पैरामीटर	प्रकार	डिफ़ॉल्ट	विवरण
`engine`	string	`exa`	खोज इंजन: `auto`, `native`, `exa`, `parallel`, `firecrawl`, `perplexity` या `tinyfish`।
`max_results`	integer	`5`	हर खोज कॉल में लौटाए जाने वाले परिणामों की अधिकतम संख्या।
`max_total_results`	integer	`10`	पूरे सर्वर-टूल लूप में परिणामों की कुल अधिकतम संख्या।
`max_uses`	integer	`10`	पूरे सर्वर-टूल लूप में खोज कॉल की अधिकतम संख्या।
`search_context_size`	string	`medium`	जिन इंजनों में highlights का आकार तय किया जा सकता है, उनके लिए संदर्भ आकार: `low`, `medium` या `high`।
`max_characters`	integer	engine default	टेक्स्ट शामिल होने पर हर परिणाम में अधिकतम टेक्स्ट वर्ण।
`allowed_domains`	string[]	none	केवल इन डोमेन से परिणाम लौटाएँ। इसका alias `include_domains` है।
`excluded_domains`	string[]	none	इन domains के results हटाएँ। Alias: `exclude_domains`।
`include_highlights`	boolean	`true`	उपलब्ध होने पर engine द्वारा दिए गए highlights/snippets शामिल करें।
`include_text`	boolean	`false`	Engine support करे तो result का अधिक विस्तृत text शामिल करें।
`user_location`	object	none	Localized search support करने वाले engines के लिए वैकल्पिक location hint।
`language`	स्ट्रिंग	कोई नहीं	TinyFish भाषा संकेत, जैसे `en`।
`page`	पूर्णांक	`0`	TinyFish परिणाम पेज, `0` से `10` तक।

सर्च इंजन चुनें

Engine	व्यवहार
`exa`	Managed Exa search। Gateway runtime के लिए Phaseo में Exa configure होना चाहिए।
`auto`	Configured managed default, अभी Exa, उपयोग करता है।
`parallel`	Configure होने पर Parallel search उपयोग करता है।
`firecrawl`	Configure होने पर Firecrawl search उपयोग करता है।
`perplexity`	Configure होने पर first-party Perplexity Search API उपयोग करता है। Ranked results, `search_context_size`, `user_location.country` से regional search और allowed या excluded domains समर्थित हैं।
`tinyfish`	`TINYFISH_API_KEY` सेट होने पर TinyFish Search इस्तेमाल करता है। स्थानीयकृत, पृष्ठों में विभाजित और क्रमबद्ध नतीजे देता है तथा `allowed_domains` / `excluded_domains` को खोज ऑपरेटर में बदलता है। TinyFish Search पूरा पेज टेक्स्ट नहीं देता; अधिक सामग्री के लिए `phaseo:web_fetch` इस्तेमाल करें।
`native`	Request surface support करने पर upstream model call से पहले declaration को provider-native web-search tool में बदलता है।

engine: "native" केवल tool declaration में उपयोग करें। पहले से जारी gateway search call में मॉडल engine: "native" भेजे, तो Phaseo tool error देता है, क्योंकि upstream request भेजने से पहले native tools चुनने होते हैं।

TinyFish Search

Phaseo गेटवे रनटाइम सीक्रेट में TINYFISH_API_KEY सेट करके इंजन सक्षम करें, फिर टूल पैरामीटर में उसे चुनें:

{
  "type": "phaseo:web_search",
  "parameters": {
    "engine": "tinyfish",
    "language": "en",
    "page": 0,
    "max_results": 5,
    "allowed_domains": ["phaseo.app", "github.com"],
    "excluded_domains": ["reddit.com"]
  }
}

language भाषा संकेत देता है और page 0 से 10 तक का परिणाम पेज चुनता है। TinyFish दोनों डोमेन फ़िल्टर सूचियाँ स्वीकार करता है; Phaseo उन्हें खोज ऑपरेटर में बदलता है। नतीजों में URL, शीर्षक और अंश/हाइलाइट होते हैं। मॉडल को अधिक पूरा टेक्स्ट चाहिए तो phaseo:web_fetch इस्तेमाल करें।

डोमेन फ़िल्टरिंग

उत्तर को नियंत्रित स्रोतों से ही लेना हो, तो allowed_domains उपयोग करें:

{
  "type": "phaseo:web_search",
  "parameters": {
    "allowed_domains": ["phaseo.app", "github.com"]
  }
}

Broad web search allowed हो, लेकिन कुछ domains को results से हटाना हो, तो excluded_domains उपयोग करें। Perplexity और Firecrawl एक खोज कॉल में allowed_domains या excluded_domains में से एक स्वीकार करते हैं, दोनों नहीं। Perplexity प्रति अनुरोध अधिकतम 20 डोमेन फ़िल्टर लेता है और बाहर रखे डोमेन अपनी निषेध सूची के प्रारूप में बदलता है। TinyFish दोनों ऐरे को क्वेरी में site: और -site: ऑपरेटर में बदलता है। TinyFish Search प्रकाशित योजनाओं में मुफ़्त है, इसलिए Phaseo engine: "tinyfish" पर प्रदाता उपयोग शुल्क नहीं जोड़ता; सामान्य Phaseo अनुरोध और टोकन मूल्य लागू रहते हैं।

Responses API

यही tool shape /v1/responses के साथ भी काम करता है:

{
  "model": "openai/gpt-5-nano",
  "input": "Find the latest release notes for Phaseo.",
  "tools": [
    { "type": "phaseo:web_search", "parameters": { "max_results": 4 } }
  ]
}

उपयोग और मूल्य निर्धारण

Web search calls इनकी गिनती बढ़ाते हैं:

{
  "usage": {
    "server_tool_use": {
      "web_search_requests": 1,
      "web_search_results": 5,
      "web_search_extra_results": 0
    }
  }
}

Managed search pricing में server_tool_web_search_requests और server_tool_web_search_extra_results meters उपयोग हो सकते हैं। Model price card में meter तय होने पर provider-native search में native_web_search_requests उपयोग हो सकता है।

सारांश

मॉडल और रूटिंग

सुविधाएँ

एकीकरण

वर्कस्पेस और पहुँच

विश्वसनीयता और संचालन

प्लेटफ़ॉर्म और अनुसंधान

माइग्रेशन गाइड

समुदाय

वेब खोज सर्वर टूल

यह कैसे काम करता है

त्वरित शुरुआत

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

सर्च इंजन चुनें

TinyFish Search

डोमेन फ़िल्टरिंग

Responses API

उपयोग और मूल्य निर्धारण

संबंधित

​यह कैसे काम करता है

​त्वरित शुरुआत

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

​सर्च इंजन चुनें

​TinyFish Search

​डोमेन फ़िल्टरिंग

​Responses API

​उपयोग और मूल्य निर्धारण

​संबंधित

यह कैसे काम करता है

त्वरित शुरुआत

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

सर्च इंजन चुनें

TinyFish Search

डोमेन फ़िल्टरिंग

Responses API

उपयोग और मूल्य निर्धारण

संबंधित