Context API ištraukia visą kontekstą iš bet kurio tinklalapio
Naudokite Perplexity Context API, kad DI agentams pateiktumėte švarų Markdown tekstą, nuorodas ir aktualius fragmentus iš talpykloje saugomų arba realiuoju laiku gaunamų tinklalapių.

Kai kas nors užduoda klausimą pokalbių robotui, DI agentui gali tekti perskaityti kelis tinklalapius, kad į jį atsakytų. Standartiniai paieškos rezultatai dažnai pateikia tik ištraukas. Tiesiogiai atsisiuntus puslapį, gali būti grąžintas neapdorotas HTML kodas, kuriame gausu naršymo elementų, slapukų pranešimų ir reklamų. Agentams reikia puslapio konteksto tokiu formatu, kurį galėtų naudoti modelis, o kūrėjams – būdo valdyti, koks naujas turi būti šis kontekstas.
Šiandien pristatome Perplexity Context API, kuri nuskaito iki 10 URL adresų ir kiekvienam puslapiui grąžina švarų Markdown tekstą, HTML, nuorodas ir užklausa pagrįstas ištraukas. Informacija gaunama iš didžiulio Perplexity žiniatinklio indekso arba atsisiunčiama realiuoju laiku. Agentai gali nurodyti kiekvienos užklausos naujumo reikalavimą ir patikrinti kiekvieno rezultato šaltinį.
Context API palaiko įvairius formatus
Agentai gali pateikti užklausą nurodydami URL adresų sąrašą ir išvesties formatus. API grąžina kiekvieno URL rezultatą ta pačia tvarka.
Context API palaiko įvairius atsakymo formatus:
- Markdown: Puslapio turinys švariu Markdown formatu, paruoštas įtraukti į modelio kontekstą.
- HTML: Puslapio HTML kodas programoms, kurios pačios jį analizuoja.
- Nuorodos: Puslapyje esančios nuorodos kaip absoliutūs URL adresai, be pasikartojimų ir tokia tvarka, kokia jos pateiktos puslapyje, kad agentas galėtų nuspręsti, kur eiti toliau.
- Ištraukos: Puslapio fragmentai, labiausiai susiję su pateikta užklausa, neviršijant kūrėjo kiekvienam puslapiui nustatyto žetonų limito.
Užuot generavusi santrauką, Context API iš kiekvieno puslapio atrenka su užklausa susijusius fragmentus. Todėl modelis gauna originalų puslapio tekstą, bet tik atrinktus fragmentus, tad apdoroti reikia mažiau teksto.
Kiekviename sėkmingame rezultate taip pat pateikiami metaduomenys, pvz., pavadinimas, aprašas, kalba, autorius ir paskelbimo data, taip pat puslapio Open Graph žymos. Kad sukurtų Markdown tekstą, Context API padalija puslapį į blokus, o modelis kiekvieną bloką įvertina kaip pagrindinį turinį arba šabloninį tekstą. Išsaugomi tik turinio blokai.
Būtina užduotims, kurioms reikia viso vaizdo
Rasti tinkamą puslapį ne visada pakanka darbui atlikti. Naudodami Context API, agentai gali gauti reikiamą turinį iš pasirinktų URL adresų ir atlikti sudėtingas užduotis.
- API integracijos diegimas: Paieškos rezultatas gali nurodyti tinkamą dokumentaciją, bet neįtraukti reikiamų parametrų, autentifikavimo instrukcijų ar klaidų atvejų. Context API gali padėti programavimo agentui gauti dokumentaciją ir API žinynus, kad pagal šią informaciją jis parašytų integraciją.
- Dabartinių kainų palyginimas: Nurodyta kaina gali priklausyti nuo naudojimo limitų, atsiskaitymo sąlygų ar tinkamumo reikalavimų, kurių nėra paieškos ištraukoje. Agentas gali paprašyti realiuoju laiku atsisiųsti pasirinktus kainodaros puslapius ir perskaityti tas sąlygas prieš atlikdamas palyginimą.
- Atsakymai į klausimus apie taisykles: Grąžinimo taisyklių ištraukoje gali būti nurodytas standartinis grąžinimo laikotarpis, bet praleistos išimtys tam tikriems produktams ar regionams. Pagalbos agentas gali gauti taisyklių puslapį, kad jo atsakyme būtų atsižvelgta į tas išimtis.
- Tyrimai naudojant kelis šaltinius: Paieškos ištraukoje gali būti pateikta išvada be metodikos, išlygų ar platesnio argumentų konteksto. Tyrimų agentas gali gauti pasirinktus straipsnius ir ataskaitas, tada palyginti įrodymus, užuot rėmęsis vien ištraukomis.
Valdykite naujumą ir patikimai apdorokite URL adresus
Pagal numatytuosius nustatymus Context API pirmiausia patikrina, ar Perplexity žiniatinklio indekse yra per pastarąsias dvi dienas atsisiųsta puslapio kopija. Jei jos nėra, puslapis atsisiunčiamas realiuoju laiku. Kūrėjai gali pakeisti max_age_seconds reikšmę į 0, kad puslapiai visada būtų skaitomi realiuoju laiku – tai naudinga kainoms, sporto rezultatams ir karščiausioms naujienoms. Retai kintančiai informacinei medžiagai šią reikšmę galima padidinti. Darbo krūviams, kurie niekada neturėtų inicijuoti užklausos realiuoju laiku, nustatykite cache_only reikšmę true.
Kiekviename rezultate užfiksuojama, ar turinys gautas iš saugomos kopijos, ar atsisiųstas realiuoju laiku, ir kada jis buvo atsisiųstas.
Užklausoje pateikti URL adresai atsisiunčiami lygiagrečiai, kiekvienam skiriant atskirą laiko biudžetą ir priskiriant atskirą būseną. Vienas lėtas ar neveikiantis puslapis nesutrikdo kitų. Būsena parodo, kas nutiko su kiekvienu URL, todėl agentas gali pakartotinai bandyti gauti tik tuos puslapius, kuriems baigėsi skirtas laikas, o likusius išsaugoti.
Context API grąžina tinkamą naudoti ir išsamų turinį
Palyginome Context API su Firecrawl, Exa, Parallel, Keenable ir Context.dev, naudodami 1 000 URL adresų, atrinktų iš realių agentų atsisiuntimo užklausų. Šis rinkinys apima 715 svetainių, įskaitant vyriausybės ir akademinius šaltinius bei ne anglų kalbos puslapius. Tada atskiras vertinimo modelis įvertino rezultatus, nežinodamas, kuris teikėjas sukūrė kiekvieną iš jų.
Diagramoje rezultatai vertinami pagal tris kriterijus:
- Tinkamumas naudoti: Dalis URL adresų, kuriems buvo grąžintas tikrasis puslapio turinys, o ne klaidos puslapis ar tuščias rezultatas.
- Faktų aprėptis: Vertinimo modelis surenka pagrindinius puslapyje rastus faktus iš visų teikėjų rezultatų, tada patikrina, kuriuos iš jų turi kiekvienas rezultatas. Nepavykęs atsisiuntimas vertinamas nuliu.
- Turinio tikslumas: grąžinto teksto dalis, kurią sudaro puslapio turinys, o ne pranešimai apie slapukus, navigacijos elementai ar reklamos, apskaičiuota kaip visų URL adresų vidurkis. Jei puslapio gauti nepavyksta, įvertis lygus nuliui.
Šio vertinimo metu Context API grąžino tinkamą naudoti turinį 92,3 % URL adresų, atkūrė 87,9 % pagrindinių faktų, o turinio tikslumas siekė 80,3 %.
Kainodara
Context API kainuoja 1 $ už 1 000 atsisiųstų URL adresų. Kūrėjai moka už kiekvieną URL, kuris grąžina būseną ok. Už nepavykusius URL mokestis neskaičiuojamas.
Kaip pradėti
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"]
}'Kiekvienas rezultatas grąžinamas su puslapio Markdown tekstu, užklausą atitinkančiais fragmentais, puslapio metaduomenimis ir būsena. Prieš naudodami rezultato turinį, patikrinkite jo būseną.
Skaitykite Context API dokumentaciją arba peržiūrėkite API žinyną.