Context API किसी भी वेब पेज से पूरा संदर्भ निकालता है
कैश किए गए या लाइव वेब पेजों से AI एजेंट को साफ़ Markdown, लिंक और प्रासंगिक अंश देने के लिए Perplexity Context API का इस्तेमाल करें।

जब कोई व्यक्ति किसी चैटबॉट से सवाल पूछता है, तो उसका जवाब देने के लिए किसी AI एजेंट को कई वेब पेज पढ़ने पड़ सकते हैं। सामान्य खोज परिणाम अक्सर सिर्फ़ स्निपेट लौटाते हैं। किसी पेज को सीधे फ़ेच करने पर रॉ HTML मिल सकता है, जो नेविगेशन, कुकी बैनर और विज्ञापनों से भरा होता है। एजेंट को पेज का संदर्भ ऐसे फ़ॉर्मैट में चाहिए जिसे मॉडल इस्तेमाल कर सके, जबकि डेवलपर को यह नियंत्रित करने का तरीका चाहिए कि वह संदर्भ कितना ताज़ा होना चाहिए।
आज हम Perplexity Context API लॉन्च कर रहे हैं, जो अधिकतम 10 URL पढ़ता है और हर पेज के लिए साफ़ Markdown, HTML, लिंक और क्वेरी-आधारित स्निपेट लौटाता है। यह जानकारी Perplexity के विशाल वेब इंडेक्स से या लाइव फ़ेच से आती है। एजेंट हर अनुरोध के लिए ताज़गी तय कर सकते हैं और हर परिणाम के स्रोत की पुष्टि कर सकते हैं।
Context API कई तरह के फ़ॉर्मैट सपोर्ट करता है
एजेंट URL की सूची देकर और आउटपुट फ़ॉर्मैट तय करके अनुरोध शुरू कर सकते हैं। API हर URL के लिए उसी क्रम में परिणाम लौटाता है।
Context API कई तरह के रिस्पॉन्स फ़ॉर्मैट सपोर्ट करता है:
- Markdown: पेज की सामग्री साफ़ Markdown के रूप में, जिसे सीधे मॉडल के संदर्भ में रखा जा सके।
- HTML: पेज का HTML, उन ऐप्लिकेशन के लिए जो अपनी पार्सिंग खुद करते हैं।
- लिंक: पेज पर मौजूद लिंक, पूर्ण (absolute) URL के रूप में, बिना डुप्लिकेट के और पेज के क्रम में, ताकि एजेंट तय कर सके कि आगे कहाँ जाना है।
- स्निपेट: दी गई क्वेरी के लिए पेज के सबसे प्रासंगिक अंश, हर पेज के लिए डेवलपर द्वारा तय की गई टोकन सीमा के भीतर।
Context API सारांश तैयार करने के बजाय हर पेज से क्वेरी के लिए प्रासंगिक अंश चुनता है। इस तरह मॉडल को पेज के मूल शब्द ही मिलते हैं, लेकिन सिर्फ़ चुने गए अंश, इसलिए प्रोसेस करने के लिए कम टेक्स्ट होता है।
हर सफल परिणाम में शीर्षक, विवरण, भाषा, लेखक और प्रकाशन तिथि जैसे मेटाडेटा के साथ पेज के Open Graph टैग भी शामिल होते हैं। Markdown बनाने के लिए, Context API पेज को ब्लॉक में बाँटता है और एक मॉडल हर ब्लॉक को मुख्य सामग्री या बॉयलरप्लेट के रूप में स्कोर करता है। सिर्फ़ सामग्री वाले ब्लॉक रखे जाते हैं।
उन कामों के लिए ज़रूरी, जिनमें पूरी तस्वीर चाहिए
किसी काम को पूरा करने के लिए सिर्फ़ प्रासंगिक पेज ढूँढ लेना हमेशा काफ़ी नहीं होता। Context API की मदद से एजेंट जटिल काम पूरे करने के लिए चुने गए URL से ज़रूरी सामग्री हासिल कर सकते हैं।
- API इंटीग्रेशन लागू करना: किसी खोज परिणाम से सही डॉक्यूमेंटेशन का पता तो चल सकता है, लेकिन हो सकता है कि उसमें ज़रूरी पैरामीटर, ऑथेंटिकेशन निर्देश या एरर केस शामिल न हों। Context API किसी कोडिंग एजेंट को डॉक्यूमेंटेशन और API रेफ़रेंस हासिल करने में मदद कर सकता है, ताकि वह इन जानकारियों के आधार पर इंटीग्रेशन लिख सके।
- मौजूदा कीमतों की तुलना करना: सूचीबद्ध कीमत उपयोग सीमाओं, बिलिंग शर्तों या पात्रता शर्तों पर निर्भर हो सकती है, जो खोज के अंश में नहीं होतीं। एजेंट चुने गए प्राइसिंग पेज का लाइव फ़ेच माँग सकता है और तुलना करने से पहले उन शर्तों को पढ़ सकता है।
- पॉलिसी से जुड़े सवालों के जवाब देना: रिटर्न पॉलिसी के किसी अंश में सामान्य रिटर्न अवधि तो बताई गई हो सकती है, लेकिन कुछ खास प्रोडक्ट या क्षेत्रों के लिए अपवाद छूट सकते हैं। सपोर्ट एजेंट पॉलिसी पेज हासिल कर सकता है, ताकि उसके जवाब में उन अपवादों का ध्यान रखा जा सके।
- कई स्रोतों में शोध करना: खोज के किसी अंश में कोई निष्कर्ष तो दिख सकता है, लेकिन उसकी कार्यप्रणाली, शर्तें या उससे जुड़ा पूरा तर्क नहीं। शोध एजेंट चुने गए लेख और रिपोर्ट हासिल कर सकता है और फिर सिर्फ़ अंशों पर निर्भर रहने के बजाय सबूतों की तुलना कर सकता है।
ताज़गी नियंत्रित करें और URL को भरोसेमंद ढंग से हैंडल करें
डिफ़ॉल्ट रूप से, Context API सबसे पहले Perplexity के वेब इंडेक्स में पिछले दो दिनों के भीतर फ़ेच की गई पेज की कॉपी देखता है। अगर ऐसी कोई कॉपी नहीं मिलती, तो वह पेज को लाइव फ़ेच करता है। कीमतों, स्कोर और ब्रेकिंग न्यूज़ के लिए हमेशा लाइव पेज पढ़ने हेतु डेवलपर max_age_seconds को बदलकर 0 कर सकते हैं। कम बदलने वाली संदर्भ सामग्री के लिए वे इसे बढ़ा सकते हैं। जिन वर्कलोड में कभी भी लाइव अनुरोध ट्रिगर नहीं होना चाहिए, उनके लिए cache_only को true पर सेट करें।
हर परिणाम में दर्ज होता है कि सामग्री स्टोर की गई कॉपी से आई या लाइव फ़ेच से, और उसे कब फ़ेच किया गया।
किसी अनुरोध में शामिल URL समानांतर रूप से फ़ेच किए जाते हैं, और हर URL का अपना समय बजट और अपना स्टेटस होता है। कोई एक धीमा या खराब पेज बाकी पेजों को विफल नहीं करता। स्टेटस बताता है कि हर URL के साथ क्या हुआ, ताकि एजेंट सिर्फ़ उन पेजों को दोबारा आज़मा सके जिनका टाइम आउट हुआ और बाकी को रख सके।
Context API इस्तेमाल लायक, पूरी सामग्री लौटाता है
हमने असली एजेंट फ़ेच अनुरोधों से लिए गए 1,000 URL के नमूने पर Context API की तुलना Firecrawl, Exa, Parallel, Keenable और Context.dev से की। इस सेट में 715 साइटें शामिल हैं, जिनमें सरकारी और अकादमिक स्रोत तथा गैर-अंग्रेज़ी पेज भी हैं। इसके बाद एक अलग जज मॉडल ने यह जाने बिना आउटपुट को स्कोर किया कि किस प्रोवाइडर ने कौन-सा आउटपुट दिया है।
चार्ट तीन मानदंडों पर प्रदर्शन मापता है:
- इस्तेमाल लायक: उन URL का हिस्सा जिनसे पेज की असली सामग्री मिली, न कि कोई एरर पेज या खाली परिणाम।
- तथ्य रिकॉल: जज सभी प्रोवाइडर में किसी पेज पर मिले मुख्य तथ्यों को इकट्ठा करता है, फिर जाँचता है कि हर आउटपुट में उनमें से कौन-से तथ्य हैं। विफल फ़ेच को शून्य स्कोर मिलता है।
- सामग्री सटीकता: लौटाए गए टेक्स्ट में पेज सामग्री का हिस्सा (कुकी नोटिस, नेविगेशन या विज्ञापन नहीं), जिसका औसत सभी URL पर निकाला गया है। विफल फ़ेच का स्कोर शून्य होता है।
इस मूल्यांकन में Context API ने 92.3% URL के लिए उपयोग योग्य सामग्री लौटाई, 87.9% मुख्य तथ्य प्राप्त किए, और सामग्री सटीकता पर 80.3% सटीकता हासिल की।
मूल्य निर्धारण
Context API की कीमत हर 1,000 फ़ेच किए गए URL पर $1 है। डेवलपर हर उस URL के लिए भुगतान करते हैं जो ok लौटाता है। विफल होने वाले URL का बिल नहीं बनता।
शुरुआत करें
curl --request POST https://api.perplexity.ai/v1/context \
--header "Authorization: Bearer $PERPLEXITY_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"urls": ["https://info.cern.ch/hypertext/WWW/TheProject.html"],
"formats": ["markdown"]
}'हर परिणाम के साथ पेज का Markdown, क्वेरी से मेल खाने वाले अंश, पेज का मेटाडेटा और एक स्टेटस मिलता है। किसी परिणाम की सामग्री इस्तेमाल करने से पहले उसका स्टेटस जाँच लें।
Context API डॉक्यूमेंटेशन पढ़ें या API रेफ़रेंस देखें।