Context API कोणत्याही वेब पेजमधून संपूर्ण संदर्भ काढते

कॅश केलेल्या किंवा लाइव्ह वेब पेजेसमधून AI एजंट्सना स्वच्छ Markdown, लिंक्स आणि संबंधित उतारे देण्यासाठी Perplexity Context API वापरा.

Context API artwork with a luminous mineral cross-section and geometric lines.

एखादी व्यक्ती चॅटबॉटला प्रश्न विचारते तेव्हा, त्याचे उत्तर देण्यासाठी AI एजंटला अनेक वेब पेजेस वाचावी लागू शकतात. सामान्य शोध परिणामांमध्ये अनेकदा फक्त स्निपेट्स मिळतात. पेज थेट फेच केल्यास कच्चे HTML मिळू शकते, जे नेव्हिगेशन, कुकी बॅनर आणि जाहिरातींनी भरलेले असते. एजंट्सना पेजचा संदर्भ मॉडेल वापरू शकेल अशा फॉरमॅटमध्ये हवा असतो, तर डेव्हलपर्सना तो संदर्भ किती ताजा असावा हे नियंत्रित करण्याचा मार्ग हवा असतो.

आज आम्ही Perplexity Context API लाँच करत आहोत, जे 10 पर्यंत URLs वाचते आणि प्रत्येक पेजसाठी स्वच्छ markdown, HTML, लिंक्स आणि क्वेरीवर आधारित स्निपेट्स परत देते. ही माहिती Perplexity च्या विशाल वेब इंडेक्समधून किंवा लाइव्ह फेचमधून येते. एजंट्स प्रत्येक विनंतीसाठी ताजेपणा निर्दिष्ट करू शकतात आणि प्रत्येक परिणामाचा स्रोत पडताळू शकतात.

Context API विविध फॉरमॅट्सना सपोर्ट करते

एजंट्स URLs ची सूची देऊन आणि आउटपुट फॉरमॅट्स निर्दिष्ट करून विनंती सुरू करू शकतात. API प्रत्येक URL साठी त्याच क्रमाने एक परिणाम परत देते.

Context API विविध रिस्पॉन्स फॉरमॅट्सना सपोर्ट करते:

  • Markdown: पेजचा मजकूर स्वच्छ Markdown स्वरूपात, मॉडेलच्या संदर्भात ठेवण्यासाठी तयार.
  • HTML: स्वतःचे पार्सिंग चालवणाऱ्या ॲप्लिकेशन्ससाठी पेजचे HTML.
  • लिंक्स: पेजवरील लिंक्स पूर्ण (absolute) URLs स्वरूपात, डुप्लिकेट्सशिवाय आणि पेजवरील क्रमाने, जेणेकरून एजंट पुढे कुठे जायचे ते ठरवू शकेल.
  • स्निपेट्स: दिलेल्या क्वेरीशी सर्वाधिक संबंधित असलेले पेजमधील उतारे, डेव्हलपरने प्रत्येक पेजसाठी सेट केलेल्या टोकन मर्यादेत.

Context API सारांश तयार करण्याऐवजी प्रत्येक पेजमधून क्वेरीशी संबंधित उतारे निवडते. परिणामी, मॉडेलला पेजमधील मूळ शब्दरचना मिळते, पण फक्त निवडलेले उतारेच, त्यामुळे प्रक्रिया करण्यासाठी कमी मजकूर असतो.

प्रत्येक यशस्वी परिणामामध्ये शीर्षक, वर्णन, भाषा, लेखक आणि प्रकाशनाची तारीख यांसारखा मेटाडेटा, तसेच पेजचे Open Graph टॅग्ज देखील समाविष्ट असतात. Markdown तयार करण्यासाठी, Context API पेजचे ब्लॉक्समध्ये विभाजन करते आणि एक मॉडेल प्रत्येक ब्लॉकला मुख्य मजकूर किंवा बॉयलरप्लेट म्हणून गुण देते. फक्त मजकूर असलेले ब्लॉक्सच ठेवले जातात.

संपूर्ण चित्र आवश्यक असलेल्या कामांसाठी अत्यावश्यक

एखादे काम पूर्ण करण्यासाठी संबंधित पेज सापडणे नेहमीच पुरेसे नसते. Context API वापरून, एजंट्स गुंतागुंतीची कामे पूर्ण करण्यासाठी निवडलेल्या URLs मधून आवश्यक असलेला मजकूर मिळवू शकतात.

  • API इंटिग्रेशन लागू करणे: शोध परिणाम योग्य डॉक्युमेंटेशन ओळखू शकतो, पण त्यात आवश्यक पॅरामीटर्स, ऑथेंटिकेशन सूचना किंवा एरर केसेस समाविष्ट नसू शकतात. Context API कोडिंग एजंटला डॉक्युमेंटेशन आणि API संदर्भ मिळवण्यास मदत करू शकते, जेणेकरून त्या तपशिलांवर आधारित इंटिग्रेशन लिहिता येईल.
  • सध्याच्या किमतींची तुलना करणे: नमूद केलेली किंमत वापराच्या मर्यादा, बिलिंग अटी किंवा पात्रतेच्या अटींवर अवलंबून असू शकते, ज्या शोध उताऱ्यात नसतात. एजंट निवडलेल्या किंमत पेजेसचे लाइव्ह फेच मागवू शकतो आणि तुलना करण्यापूर्वी त्या अटी वाचू शकतो.
  • धोरणविषयक प्रश्नांची उत्तरे देणे: रिटर्न धोरणाच्या उताऱ्यात सामान्य रिटर्न कालावधी नमूद असू शकतो, पण विशिष्ट उत्पादने किंवा प्रदेशांसाठीचे अपवाद वगळलेले असू शकतात. सपोर्ट एजंट धोरणाचे पेज मिळवू शकतो, जेणेकरून त्याच्या उत्तरात ते अपवाद विचारात घेतले जातील.
  • अनेक स्रोतांमध्ये संशोधन करणे: शोध उताऱ्यात एखादा निष्कर्ष दिसू शकतो, पण त्याची पद्धती, मर्यादा किंवा आजूबाजूचा युक्तिवाद त्यात नसू शकतो. संशोधन एजंट निवडलेले लेख आणि अहवाल मिळवू शकतो, आणि नंतर फक्त उताऱ्यांवर अवलंबून न राहता पुराव्यांची तुलना करू शकतो.

ताजेपणा नियंत्रित करा आणि URLs विश्वसनीयपणे हाताळा

डीफॉल्टनुसार, Context API सर्वप्रथम Perplexity च्या वेब इंडेक्समध्ये मागील दोन दिवसांत फेच केलेली पेजची प्रत आहे का ते तपासते. अशी प्रत नसल्यास, ते पेज लाइव्ह फेच करते. किमती, स्कोअर्स आणि ताज्या बातम्यांसाठी नेहमी लाइव्ह पेजेस वाचण्याकरिता डेव्हलपर्स max_age_seconds ची व्हॅल्यू 0 करू शकतात. क्वचितच बदलणाऱ्या संदर्भ सामग्रीसाठी, ते ही व्हॅल्यू वाढवू शकतात. कधीही लाइव्ह विनंती ट्रिगर होऊ नये अशा वर्कलोड्ससाठी cache_only ची व्हॅल्यू true सेट करा.

प्रत्येक परिणामात मजकूर संग्रहित प्रतीतून आला की लाइव्ह फेचमधून, आणि तो केव्हा फेच केला गेला, याची नोंद असते.

विनंतीमधील URLs समांतरपणे फेच केले जातात, आणि प्रत्येकाचे स्वतःचे वेळेचे बजेट व स्वतःचे स्टेटस असते. एखादे संथ किंवा बिघडलेले पेज इतरांना अयशस्वी करत नाही. स्टेटस प्रत्येक URL सोबत काय झाले ते दर्शवते, त्यामुळे एजंट फक्त टाइमआउट झालेल्या पेजेससाठी पुन्हा प्रयत्न करू शकतो आणि उर्वरित पेजेस तसेच ठेवू शकतो.

Context API वापरण्यायोग्य, संपूर्ण मजकूर परत देते

आम्ही प्रत्यक्ष एजंट फेच विनंत्यांमधून नमुना म्हणून घेतलेल्या 1,000 URLs वर Context API ची Firecrawl, Exa, Parallel, Keenable आणि Context.dev यांच्याशी तुलनात्मक चाचणी केली. या संचात 715 साइट्सचा समावेश असून त्यात सरकारी आणि शैक्षणिक स्रोत तसेच इंग्रजीतर भाषांतील पेजेस आहेत. त्यानंतर एका स्वतंत्र जज मॉडेलने कोणत्या प्रदात्याने कोणते आउटपुट तयार केले हे न जाणता आउटपुट्सना गुण दिले.

हा चार्ट तीन निकषांवर कामगिरी मोजतो:

  • वापरण्यायोग्य: त्रुटी पेज किंवा रिकाम्या परिणामाऐवजी पेजच्या खऱ्या मजकुरासह परत आलेल्या URLs चे प्रमाण.
  • तथ्य रिकॉल: जज सर्व प्रदात्यांमध्ये पेजवर आढळलेली प्रमुख तथ्ये गोळा करतो, आणि नंतर प्रत्येक आउटपुटमध्ये त्यापैकी कोणती तथ्ये आहेत ते तपासतो. अयशस्वी फेचला शून्य गुण मिळतात.
  • सामग्री अचूकता: परत आलेल्या मजकुरापैकी कुकी सूचना, नेव्हिगेशन किंवा जाहिराती नसून पृष्ठाची सामग्री असलेल्या मजकुराचे प्रमाण, सर्व URL साठी सरासरी काढलेले. अयशस्वी फेचला शून्य गुण मिळतात.

या मूल्यमापनात Context API ने 92.3% URL साठी वापरण्यायोग्य सामग्री परत केली, 87.9% मुख्य तथ्ये पुनर्प्राप्त केली आणि सामग्री अचूकतेमध्ये 80.3% अचूकता गुण मिळवले.

किंमत

Context API ची किंमत प्रति 1,000 फेच केलेल्या URLs साठी $1 आहे. डेव्हलपर्स ok परत करणाऱ्या प्रत्येक URL साठी पैसे देतात. अयशस्वी झालेल्या URLs साठी बिल आकारले जात नाही.

सुरुवात करणे

bash
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 संदर्भ पहा.

  1. Orchestrator: विश्वसनीय इन्फरन्ससाठी एकच APIडेव्हलपर्स१७ नोव्हें, २०२६
  2. Perplexity चे Monitor API सादर करत आहोतडेव्हलपर्स१६ नोव्हें, २०२६