Context API извлачи потпун контекст са било које веб-странице

Користите Perplexity Context API да агентима вјештачке интелигенције обезбиједите чист Markdown, линкове и релевантне дијелове кешираних веб-страница или страница уживо.

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

Када неко постави питање четботу, агент вјештачке интелигенције ће можда морати да прочита неколико веб-страница да би одговорио. Стандардни резултати претраге често враћају само исјечке. Директно преузимање странице може вратити сирови 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 враћа употребљив и потпун садржај

Тестирали смо Context API у поређењу са сервисима Firecrawl, Exa, Parallel, Keenable и Context.dev на 1.000 URL адреса узоркованих из стварних захтјева агената за преузимање. Скуп обухвата 715 сајтова и укључује владине и академске изворе, као и странице на језицима који нису енглески. Засебни модел-оцјењивач је затим оцијенио резултате не знајући који их је провајдер произвео.

Графикон мјери перформансе према три критеријума:

  • Употребљивост: Удио URL адреса за које је враћен стварни садржај странице, а не страница са грешком или празан резултат.
  • Обухват чињеница: Оцјењивач прикупља кључне чињенице пронађене на страници код свих провајдера, а затим провјерава које од њих садржи сваки излаз. Неуспјело преузимање добија нула бодова.
  • Прецизност садржаја: Удио враћеног текста који представља садржај странице, а не обавјештења о колачићима, навигацију или огласе, усредњен по свим URL адресама. Неуспјело преузимање се оцјењује нулом.

У овој евалуацији Context API је вратио употребљив садржај за 92,3% URL адреса, обухватио 87,9% кључних чињеница и постигао прецизност садржаја од 80,3%.

Цијене

Context API кошта 1 $ за 1.000 преузетих URL адреса. Програмери плаћају за сваку URL адресу која врати статус ok. URL адресе чије преузимање не успије не наплаћују се.

Први кораци

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 за поуздану инференцијуПрограмери17. нов 2026.
  2. Представљамо Monitor API компаније PerplexityПрограмери16. нов 2026.