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.
- లింక్లు: ఏజెంట్ తర్వాత ఎక్కడికి వెళ్లాలో నిర్ణయించుకునేలా, పేజీలోని లింక్లు డూప్లికేట్లు లేకుండా, పేజీలో ఉన్న క్రమంలో, అబ్సొల్యూట్ URLలుగా.
- స్నిప్పెట్లు: ఇచ్చిన క్వెరీకి అత్యంత సంబంధితమైన పేజీ భాగాలు, ప్రతి పేజీకి డెవలపర్ నిర్ణయించిన టోకెన్ పరిమితిలోపు.
Context API సారాంశాన్ని రూపొందించడానికి బదులుగా, ప్రతి పేజీ నుండి క్వెరీకి సంబంధించిన భాగాలను ఎంచుకుంటుంది. ఫలితంగా, మోడల్కు పేజీ యొక్క అసలు పదాలే అందుతాయి, కానీ ఎంచుకున్న భాగాలు మాత్రమే అందుతాయి కాబట్టి ప్రాసెస్ చేయాల్సిన టెక్స్ట్ తక్కువగా ఉంటుంది.
ప్రతి విజయవంతమైన ఫలితంలో శీర్షిక, వివరణ, భాష, రచయిత, ప్రచురణ తేదీ వంటి మెటాడేటాతో పాటు పేజీ యొక్క Open Graph ట్యాగ్లు కూడా ఉంటాయి. Markdownను రూపొందించడానికి, Context API పేజీని బ్లాక్లుగా విభజిస్తుంది, ఆపై ఒక మోడల్ ప్రతి బ్లాక్ను ప్రధాన కంటెంట్గా లేదా బాయిలర్ప్లేట్గా స్కోర్ చేస్తుంది. కంటెంట్ బ్లాక్లు మాత్రమే ఉంచబడతాయి.
పూర్తి చిత్రం అవసరమైన పనులకు తప్పనిసరి
పనిని పూర్తి చేయడానికి సంబంధిత పేజీని కనుగొనడం ఒక్కటే ఎల్లప్పుడూ సరిపోదు. 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లపై మేము 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. 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 రిఫరెన్స్ను చూడండి.