Context API кез келген веб-беттен толық контекст алады
Perplexity Context API көмегімен ЖИ агенттеріне кэштелген немесе тікелей жүктелген веб-беттерден таза Markdown, сілтемелер және қатысты үзінділер беріңіз.

Біреу чат-ботқа сұрақ қойғанда, ЖИ агентіне жауап беру үшін бірнеше веб-бетті оқу қажет болуы мүмкін. Стандартты іздеу нәтижелері көбіне тек үзінділерді қайтарады. Бетті тікелей жүктеу навигацияға, cookie баннерлеріне және жарнамаға толы шикі 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 интеграциясын енгізу: Іздеу нәтижесі қажетті параметрлерді, аутентификация нұсқауларын немесе қате жағдайларын қамтымай, тек дұрыс құжаттаманы көрсетуі мүмкін. Context API кодтау агентіне осы мәліметтерге негізделген интеграцияны жазу үшін құжаттама мен 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 мекенжайларының үлесі.
- Фактілерді қамту: Бағалаушы барлық провайдерлер бойынша беттен табылған негізгі фактілерді жинап, содан кейін әр нәтижеде олардың қайсысы бар екенін тексереді. Сәтсіз жүктеуге нөл ұпай беріледі.
- Мазмұн дәлдігі: қайтарылған мәтіннің cookie туралы хабарламалар, навигация немесе жарнама емес, бет мазмұнынан тұратын үлесі; барлық URL мекенжайлары бойынша орташа мән. Сәтсіз жүктеу нөлмен бағаланады.
Бұл бағалауда Context API URL мекенжайларының 92,3% бөлігі үшін пайдалануға жарамды мазмұн қайтарды, негізгі фактілердің 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 анықтамалығын қараңыз.