Context API hangib mis tahes veebilehelt täieliku konteksti

Kasutage Perplexity Context API-t, et anda AI-agentidele puhast Markdowni, linke ja asjakohaseid lõike vahemällu salvestatud või reaalajas veebilehtedelt.

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

Kui keegi esitab vestlusrobotile küsimuse, võib AI-agent vastamiseks vajada mitme veebilehe lugemist. Tavalised otsingutulemused annavad sageli vaid lühikesi väljavõtteid. Lehe otse toomine võib tagastada töötlemata HTML-i, mis on täis navigeerimiselemente, küpsiste bännereid ja reklaame. Agendid vajavad lehe konteksti vormingus, mida mudel saab kasutada, arendajad aga vajavad võimalust määrata, kui värske see kontekst peab olema.

Täna toome turule Perplexity Context API, mis loeb kuni 10 URL-i ja tagastab iga lehe kohta puhta Markdowni, HTML-i, lingid ja päringupõhised väljavõtted. Teave pärineb Perplexity ulatuslikust veebiindeksist või reaalajas toomisest. Agendid saavad määrata iga päringu värskuse ja kontrollida iga tulemuse allikat.

Context API toetab mitmesuguseid vorminguid

Agendid saavad päringu algatada, esitades URL-ide loendi ja määrates väljundvormingud. API tagastab iga URL-i kohta tulemuse samas järjekorras.

Context API toetab mitmesuguseid vastusevorminguid:

  • Markdown: Lehe sisu puhta Markdownina, valmis mudeli konteksti lisamiseks.
  • HTML: Lehe HTML rakendustele, mis teevad parsimise ise.
  • Lingid: Lehel olevad lingid absoluutsete URL-idena, ilma duplikaatideta ja lehel esinemise järjekorras, et agent saaks otsustada, kuhu edasi minna.
  • Väljavõtted: Lehe lõigud, mis on antud päringu jaoks kõige asjakohasemad, arendaja poolt iga lehe jaoks määratud tokenilimiidi piires.

Context API valib igalt lehelt päringu jaoks asjakohased lõigud, selle asemel et koostada kokkuvõte. Seega saab mudel lehe algse sõnastuse, kuid ainult valitud lõigud, mistõttu on töödeldavat teksti vähem.

Iga õnnestunud tulemus sisaldab ka metaandmeid, nagu pealkiri, kirjeldus, keel, autor ja avaldamiskuupäev, ning lisaks lehe Open Graphi silte. Markdowni koostamiseks jagab Context API lehe plokkideks ja mudel hindab iga plokki kas põhisisuks või šabloontekstiks. Alles jäetakse ainult sisuplokid.

Hädavajalik ülesannete puhul, mis nõuavad täielikku pilti

Asjakohase lehe leidmisest ei piisa alati töö tegemiseks. Context API abil saavad agendid keerukate ülesannete täitmiseks hankida valitud URL-idelt vajaliku sisu.

  • API-integratsiooni loomine: Otsingutulemus võib viidata õigele dokumentatsioonile, kuid jätta välja vajalikud parameetrid, autentimisjuhised või veajuhtumid. Context API aitab kodeerimisagendil hankida dokumentatsiooni ja API-viitematerjali, et kirjutada nende üksikasjade põhjal integratsioon.
  • Praeguste hindade võrdlemine: Avaldatud hind võib sõltuda kasutuspiirangutest, arveldustingimustest või sobivustingimustest, mis otsingu väljavõttest puuduvad. Agent saab taotleda valitud hinnalehtede reaalajas toomist ja lugeda need tingimused läbi enne võrdluse tegemist.
  • Tingimusi puudutavatele küsimustele vastamine: Tagastustingimuste väljavõttes võib olla märgitud tavapärane tagastusaeg, kuid puududa erandid teatud toodete või piirkondade kohta. Klienditoe agent saab hankida tingimuste lehe, et tema vastuses oleks need erandid arvesse võetud.
  • Mitme allika põhjal uurimine: Otsingu väljavõte võib esile tuua leiu ilma metoodika, reservatsioonide või seda ümbritseva argumentatsioonita. Uurimisagent saab hankida valitud artiklid ja aruanded ning seejärel tõendeid võrrelda, selle asemel et tugineda ainult väljavõtetele.

Värskuse kontroll ja URL-ide usaldusväärne käsitlemine

Vaikimisi kontrollib Context API esmalt, kas Perplexity veebiindeksis on lehe koopia, mis on toodud viimase kahe päeva jooksul. Kui seda pole, toob API lehe reaalajas. Hindade, sporditulemuste ja värskete uudiste puhul saavad arendajad määrata max_age_seconds väärtuseks 0, et lugeda alati reaalajas lehti. Harva muutuva viitematerjali puhul saavad nad seda väärtust suurendada. Määrake cache_only väärtuseks true töökoormuste puhul, mis ei tohiks kunagi käivitada reaalajas päringut.

Iga tulemus märgib, kas sisu pärines salvestatud koopiast või reaalajas toomisest ja millal see toodi.

Päringus olevad URL-id tuuakse paralleelselt, igaühel oma ajaeelarve ja oma olek. Üks aeglane või katkine leht ei põhjusta teiste ebaõnnestumist. Olek näitab, mis iga URL-iga juhtus, nii et agent saab uuesti proovida ainult neid lehti, mille aeg sai otsa, ja ülejäänud alles jätta.

Context API tagastab kasutuskõlbliku ja täieliku sisu

Võrdlesime Context API-t teenustega Firecrawl, Exa, Parallel, Keenable ja Context.dev 1000 URL-i põhjal, mis valiti päris agentide toomispäringute hulgast. Valim hõlmab 715 saiti ning sisaldab valitsus- ja akadeemilisi allikaid ning mitteingliskeelseid lehti. Seejärel hindas eraldi hindajamudel väljundeid, teadmata, milline teenusepakkuja iga väljundi lõi.

Diagramm mõõdab jõudlust kolme kriteeriumi alusel:

  • Kasutuskõlblikkus: Nende URL-ide osakaal, mille puhul saadi tagasi lehe tegelik sisu, mitte vealeht ega tühi tulemus.
  • Faktide saagis: Hindaja kogub kõigi teenusepakkujate väljunditest lehel leiduvad põhifaktid ja kontrollib seejärel, milliseid neist iga väljund sisaldab. Ebaõnnestunud toomise tulemus on null.
  • Sisu täpsus: tagastatud teksti osakaal, mis on lehe sisu, mitte küpsiseteated, navigeerimine ega reklaamid, keskmistatuna kõigi URL-ide peale. Ebaõnnestunud toomise skoor on null.

Selles hindamises tagastas Context API kasutatava sisu 92,3% URL-ide puhul, taastas 87,9% põhifaktidest ning saavutas sisu täpsuse mõõdikus 80,3% täpsuse.

Hinnad

Context API maksab 1 $ iga 1000 toodud URL-i eest. Arendajad maksavad iga URL-i eest, mis tagastab oleku ok. Ebaõnnestunud URL-ide eest arvet ei esitata.

Alustamine

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"] }'

Iga tulemusega tulevad kaasa lehe Markdown, päringule vastavad lõigud, lehe metaandmed ja olek. Enne tulemuse sisu kasutamist kontrollige selle olekut.

Lugege Context API dokumentatsiooni või vaadake API-viitematerjali.

  1. Orchestrator: üks API töökindlaks järeldamiseksArendajad17. nov 2026
  2. Tutvustame Perplexity Monitor API-tArendajad16. nov 2026