Context API எந்த வலைப்பக்கத்திலிருந்தும் முழுச் சூழலைப் பிரித்தெடுக்கிறது
தற்காலிகமாகச் சேமிக்கப்பட்ட அல்லது நேரடி வலைப்பக்கங்களிலிருந்து சுத்தமான Markdown, இணைப்புகள், தொடர்புடைய பகுதிகள் ஆகியவற்றை AI ஏஜென்ட்களுக்கு வழங்க Perplexity Context API-ஐப் பயன்படுத்துங்கள்.

ஒருவர் சாட்பாட்டிடம் ஒரு கேள்வி கேட்கும்போது, அதற்குப் பதிலளிக்க ஒரு AI ஏஜென்ட் பல வலைப்பக்கங்களைப் படிக்க வேண்டியிருக்கலாம். வழக்கமான தேடல் முடிவுகள் பெரும்பாலும் சிறு துணுக்குகளை மட்டுமே தருகின்றன. ஒரு பக்கத்தை நேரடியாகப் பெற்றால், வழிசெலுத்தல், குக்கீ பேனர்கள், விளம்பரங்கள் நிறைந்த மூல HTML கிடைக்கக்கூடும். ஒரு மாடல் பயன்படுத்தக்கூடிய வடிவத்தில் பக்கத்தின் சூழல் ஏஜென்ட்களுக்குத் தேவை; அதே நேரத்தில், அந்தச் சூழல் எவ்வளவு புதியதாக இருக்க வேண்டும் என்பதைக் கட்டுப்படுத்த டெவலப்பர்களுக்கு ஒரு வழி தேவை.
இன்று நாங்கள் Perplexity Context API-ஐ அறிமுகப்படுத்துகிறோம். இது அதிகபட்சம் 10 URL-களைப் படித்து, ஒவ்வொரு பக்கத்திற்கும் சுத்தமான markdown, HTML, இணைப்புகள், வினவல் அடிப்படையிலான துணுக்குகள் ஆகியவற்றைத் தருகிறது. இந்தத் தகவல் Perplexity-இன் பரந்த வலை அட்டவணையிலிருந்தோ நேரடிப் பெறுதலிலிருந்தோ வருகிறது. ஒவ்வொரு கோரிக்கைக்கும் தரவு எவ்வளவு புதியதாக இருக்க வேண்டும் என்பதை ஏஜென்ட்கள் குறிப்பிடலாம், ஒவ்வொரு முடிவின் மூலத்தையும் சரிபார்க்கலாம்.
Context API பல்வேறு வடிவங்களை ஆதரிக்கிறது
URL-களின் பட்டியலை வழங்கி, வெளியீட்டு வடிவங்களைக் குறிப்பிடுவதன் மூலம் ஏஜென்ட்கள் ஒரு கோரிக்கையைத் தொடங்கலாம். API ஒவ்வொரு URL-க்கும் ஒரு முடிவை அதே வரிசையில் தருகிறது.
Context API பல்வேறு பதில் வடிவங்களை ஆதரிக்கிறது:
- Markdown: ஒரு மாடலின் சூழலில் வைக்கத் தயாரான, சுத்தமான Markdown வடிவில் பக்க உள்ளடக்கம்.
- HTML: சொந்தமாகப் பாகுபடுத்தலை (parsing) இயக்கும் பயன்பாடுகளுக்கான பக்கத்தின் HTML.
- இணைப்புகள்: பக்கத்தில் உள்ள இணைப்புகள், நகல்கள் இல்லாமல், பக்கத்தில் உள்ள வரிசைப்படி, முழுமையான (absolute) URL-களாக; இதனால் ஒரு ஏஜென்ட் அடுத்து எங்கே செல்வது என்பதைத் தீர்மானிக்கலாம்.
- துணுக்குகள்: வழங்கப்பட்ட வினவலுக்கு மிகவும் தொடர்புடைய பக்கப் பகுதிகள், ஒவ்வொரு பக்கத்திற்கும் டெவலப்பர் அமைத்த டோக்கன் வரம்பிற்குள்.
Context API சுருக்கம் ஒன்றை உருவாக்குவதற்குப் பதிலாக, ஒவ்வொரு பக்கத்திலிருந்தும் வினவலுக்குத் தொடர்புடைய பகுதிகளைத் தேர்ந்தெடுக்கிறது. இதன் விளைவாக, மாடல் பக்கத்தின் அசல் சொற்களைப் பெறுகிறது; ஆனால் தேர்ந்தெடுக்கப்பட்ட பகுதிகளை மட்டுமே பெறுவதால், செயலாக்க வேண்டிய உரை குறைவாக இருக்கும்.
வெற்றிகரமான ஒவ்வொரு முடிவிலும் தலைப்பு, விளக்கம், மொழி, ஆசிரியர், வெளியிடப்பட்ட தேதி போன்ற மெட்டாடேட்டாவும், பக்கத்தின் Open Graph குறிச்சொற்களும் அடங்கும். Markdown-ஐ உருவாக்க, Context API ஒரு பக்கத்தைத் தொகுதிகளாகப் பிரிக்கிறது; ஒரு மாடல் ஒவ்வொரு தொகுதியையும் முதன்மை உள்ளடக்கமா அல்லது பொதுவான நிலையான உரையா (boilerplate) என மதிப்பிடுகிறது. உள்ளடக்கத் தொகுதிகள் மட்டுமே வைத்துக்கொள்ளப்படுகின்றன.
முழுமையான சித்திரம் தேவைப்படும் பணிகளுக்கு இன்றியமையாதது
ஒரு பணியை முடிக்க, தொடர்புடைய பக்கத்தைக் கண்டறிவது மட்டும் எப்போதும் போதுமானதல்ல. Context API-ஐப் பயன்படுத்தி, சிக்கலான பணிகளை முடிக்கத் தேவையான உள்ளடக்கத்தை ஏஜென்ட்கள் தேர்ந்தெடுக்கப்பட்ட URL-களிலிருந்து பெறலாம்.
- API ஒருங்கிணைப்பைச் செயல்படுத்துதல்: ஒரு தேடல் முடிவு சரியான ஆவணத்தை அடையாளம் காட்டினாலும், தேவையான அளவுருக்கள், அங்கீகார வழிமுறைகள் அல்லது பிழை நிலைகளைச் சேர்க்காமல் இருக்கலாம். அந்த விவரங்களின் அடிப்படையில் ஒருங்கிணைப்பை எழுத, ஆவணங்களையும் API குறிப்புகளையும் பெற ஒரு கோடிங் ஏஜென்ட்டுக்கு Context API உதவும்.
- தற்போதைய விலைகளை ஒப்பிடுதல்: பட்டியலிடப்பட்ட விலை, பயன்பாட்டு வரம்புகள், கட்டண விதிமுறைகள் அல்லது தகுதி நிபந்தனைகளைச் சார்ந்திருக்கலாம்; இவை தேடல் பகுதியில் இடம்பெறாமல் இருக்கலாம். ஒரு ஏஜென்ட் தேர்ந்தெடுக்கப்பட்ட விலைப் பக்கங்களை நேரடியாகப் பெறக் கோரி, ஒப்பீடு செய்வதற்கு முன் அந்த நிபந்தனைகளைப் படிக்கலாம்.
- கொள்கை தொடர்பான கேள்விகளுக்குப் பதிலளித்தல்: திருப்பி அனுப்பும் கொள்கையின் ஒரு பகுதி நிலையான திருப்பி அனுப்பும் காலத்தைக் குறிப்பிட்டாலும், குறிப்பிட்ட தயாரிப்புகள் அல்லது பிராந்தியங்களுக்கான விதிவிலக்குகளை விட்டுவிடலாம். ஒரு ஆதரவு ஏஜென்ட் கொள்கைப் பக்கத்தைப் பெறுவதன் மூலம், அதன் பதில் அந்த விதிவிலக்குகளையும் கணக்கில் எடுத்துக்கொள்ளும்.
- பல மூலங்களில் ஆராய்ச்சி செய்தல்: ஒரு தேடல் பகுதி, ஆய்வு முறை, வரம்புகள் அல்லது சுற்றியுள்ள வாதம் இல்லாமல் ஒரு கண்டுபிடிப்பை மட்டும் வெளிப்படுத்தலாம். ஒரு ஆராய்ச்சி ஏஜென்ட் தேர்ந்தெடுக்கப்பட்ட கட்டுரைகளையும் அறிக்கைகளையும் பெற்று, பகுதிகளை மட்டும் நம்பியிருக்காமல் சான்றுகளை ஒப்பிடலாம்.
தரவின் புதுமையைக் கட்டுப்படுத்தி, URL-களை நம்பகமாகக் கையாளுங்கள்
இயல்பாக, Context API முதலில் கடந்த இரண்டு நாட்களுக்குள் பெறப்பட்ட பக்கத்தின் நகல் ஏதேனும் Perplexity-இன் வலை அட்டவணையில் உள்ளதா எனச் சரிபார்க்கிறது. அப்படி இல்லையென்றால், அது பக்கத்தை நேரடியாகப் பெறுகிறது. விலைகள், விளையாட்டு ஸ்கோர்கள், உடனடிச் செய்திகள் போன்றவற்றுக்கு எப்போதும் நேரடிப் பக்கங்களைப் படிக்க, டெவலப்பர்கள் max_age_seconds மதிப்பை 0 என மாற்றலாம். அரிதாக மாறும் குறிப்புத் தகவல்களுக்கு, அவர்கள் அதை அதிகரிக்கலாம். ஒருபோதும் நேரடிக் கோரிக்கையைத் தூண்டக்கூடாத பணிச்சுமைகளுக்கு cache_only மதிப்பை true என அமைக்கவும்.
உள்ளடக்கம் சேமிக்கப்பட்ட நகலிலிருந்து வந்ததா அல்லது நேரடிப் பெறுதலிலிருந்து வந்ததா, அது எப்போது பெறப்பட்டது என்பதை ஒவ்வொரு முடிவும் பதிவு செய்கிறது.
ஒரு கோரிக்கையில் உள்ள URL-கள் இணையாகப் பெறப்படுகின்றன; ஒவ்வொன்றுக்கும் அதற்கெனத் தனி நேர வரம்பும் தனி நிலையும் உண்டு. மெதுவான அல்லது செயலிழந்த ஒரு பக்கம் மற்றவற்றைத் தோல்வியடையச் செய்யாது. ஒவ்வொரு URL-க்கும் என்ன நடந்தது என்பதை நிலை காட்டுவதால், ஒரு ஏஜென்ட் நேரம் முடிந்த பக்கங்களை மட்டும் மீண்டும் முயற்சித்து, மீதமுள்ளவற்றை வைத்துக்கொள்ளலாம்.
Context API பயன்படுத்தக்கூடிய, முழுமையான உள்ளடக்கத்தைத் தருகிறது
உண்மையான ஏஜென்ட் பெறுதல் கோரிக்கைகளிலிருந்து மாதிரியாக எடுக்கப்பட்ட 1,000 URL-களில், Firecrawl, Exa, Parallel, Keenable, Context.dev ஆகியவற்றுடன் Context API-ஐ ஒப்பிட்டுச் சோதித்தோம். இந்தத் தொகுப்பு 715 தளங்களை உள்ளடக்கியது; அரசு மற்றும் கல்விசார் மூலங்களும், ஆங்கிலம் அல்லாத பக்கங்களும் இதில் அடங்கும். பின்னர், ஒவ்வொரு வெளியீட்டையும் எந்த வழங்குநர் உருவாக்கியது என்று தெரியாமலேயே, தனி மதிப்பீட்டு மாடல் ஒன்று வெளியீடுகளுக்கு மதிப்பெண் வழங்கியது.
இந்த விளக்கப்படம் மூன்று அளவுகோல்களின் அடிப்படையில் செயல்திறனை அளவிடுகிறது:
- பயன்படுத்தக்கூடியது: பிழைப் பக்கமோ வெற்று முடிவோ அல்லாமல், பக்கத்தின் உண்மையான உள்ளடக்கத்துடன் திரும்பிய URL-களின் விகிதம்.
- உண்மைத் தகவல் மீட்பு: அனைத்து வழங்குநர்களிலும் ஒரு பக்கத்தில் காணப்பட்ட முக்கியத் தகவல்களை மதிப்பீட்டு மாடல் சேகரித்து, ஒவ்வொரு வெளியீட்டிலும் அவற்றில் எவை உள்ளன என்பதைச் சரிபார்க்கிறது. தோல்வியடைந்த பெறுதலுக்கு மதிப்பெண் பூஜ்ஜியம்.
- உள்ளடக்கத் துல்லியம்: திருப்பி அனுப்பப்பட்ட உரையில் குக்கீ அறிவிப்புகள், வழிசெலுத்தல் அல்லது விளம்பரங்கள் அல்லாமல் பக்க உள்ளடக்கமாக உள்ள பங்கு; இது அனைத்து URL-களுக்கும் சராசரியாகக் கணக்கிடப்படுகிறது. பெறுதல் தோல்வியடைந்தால் மதிப்பெண் பூஜ்ஜியம்.
இந்த மதிப்பீட்டில், Context API 92.3% URL-களுக்குப் பயன்படுத்தக்கூடிய உள்ளடக்கத்தை வழங்கியது, முக்கிய உண்மைகளில் 87.9%-ஐ மீட்டெடுத்தது, மேலும் உள்ளடக்கத் துல்லியத்தில் 80.3% துல்லிய மதிப்பெண் பெற்றது.
விலை நிர்ணயம்
Context API-க்கான கட்டணம், பெறப்படும் ஒவ்வொரு 1,000 URL-களுக்கும் $1. ok நிலையைத் தரும் ஒவ்வொரு URL-க்கும் டெவலப்பர்கள் கட்டணம் செலுத்துவார்கள். தோல்வியடையும் 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 குறிப்பைப் பார்க்கவும்.