Context API izvlači potpun kontekst sa bilo koje veb-stranice

Koristite Perplexity Context API da biste AI agentima pružili čist Markdown, linkove i relevantne odlomke sa keširanih veb-stranica ili stranica uživo.

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

Kada neko postavi pitanje četbotu, AI agent će možda morati da pročita nekoliko veb-stranica da bi odgovorio. Standardni rezultati pretrage često vraćaju samo isečke. Direktno preuzimanje stranice može da vrati sirovi HTML, pun navigacije, banera za kolačiće i oglasa. Agentima je potreban kontekst stranice u formatu koji model može da koristi, dok je programerima potreban način da kontrolišu koliko taj kontekst mora da bude svež.

Danas predstavljamo Perplexity Context API, koji čita do 10 URL adresa i za svaku stranicu vraća čist Markdown, HTML, linkove i isečke zasnovane na upitu. Informacije potiču iz ogromnog veb-indeksa kompanije Perplexity ili iz preuzimanja uživo. Agenti mogu da odrede svežinu svakog zahteva i da provere izvor svakog rezultata.

Context API podržava različite formate

Agenti mogu da pokrenu zahtev tako što navedu listu URL adresa i odrede izlazne formate. API vraća rezultat za svaku URL adresu istim redosledom.

Context API podržava različite formate odgovora:

  • Markdown: Sadržaj stranice kao čist Markdown, spreman za unos u kontekst modela.
  • HTML: HTML stranice, za aplikacije koje same obavljaju raščlanjivanje.
  • Linkovi: Linkovi na stranici kao apsolutne URL adrese, bez duplikata i redosledom kojim se pojavljuju na stranici, kako bi agent mogao da odluči kuda dalje.
  • Isečci: Odlomci stranice koji su najrelevantniji za zadati upit, u okviru ograničenja tokena koje programer postavi za svaku stranicu.

Context API sa svake stranice bira odlomke relevantne za upit, umesto da generiše rezime. Zahvaljujući tome, model dobija originalni tekst stranice, ali samo izabrane odlomke, pa ima manje teksta za obradu.

Svaki uspešan rezultat sadrži i metapodatke kao što su naslov, opis, jezik, autor i datum objavljivanja, kao i Open Graph oznake stranice. Da bi napravio Markdown, Context API deli stranicu na blokove, a model svaki blok ocenjuje kao glavni sadržaj ili šablonski tekst. Zadržavaju se samo blokovi sa sadržajem.

Neophodan za zadatke kojima je potrebna potpuna slika

Pronalaženje relevantne stranice nije uvek dovoljno za obavljanje posla. Uz Context API, agenti mogu da preuzmu sadržaj koji im je potreban sa izabranih URL adresa kako bi obavili složene zadatke.

  • Implementacija API integracije: Rezultat pretrage može da ukaže na pravu dokumentaciju, a da ne sadrži potrebne parametre, uputstva za autentifikaciju ili slučajeve grešaka. Context API može da pomogne agentu za programiranje da preuzme dokumentaciju i API reference kako bi na osnovu tih detalja napisao integraciju.
  • Poređenje aktuelnih cena: Navedena cena može da zavisi od ograničenja korišćenja, uslova naplate ili uslova podobnosti koji nedostaju u isečku iz pretrage. Agent može da zatraži preuzimanje izabranih stranica sa cenama uživo i da pročita te uslove pre poređenja.
  • Odgovaranje na pitanja o pravilima: Isečak iz pravila o povraćaju može da navede standardni rok za povraćaj, ali da izostavi izuzetke za određene proizvode ili regione. Agent za podršku može da preuzme stranicu sa pravilima kako bi njegov odgovor uzeo u obzir te izuzetke.
  • Istraživanje iz više izvora: Isečak iz pretrage može da izdvoji nalaz bez metodologije, ograda ili argumentacije koja ga okružuje. Agent za istraživanje može da preuzme izabrane članke i izveštaje, a zatim da uporedi dokaze umesto da se oslanja samo na isečke.

Kontrolišite svežinu i pouzdano obrađujte URL adrese

Context API podrazumevano najpre proverava da li u veb-indeksu kompanije Perplexity postoji kopija stranice preuzeta u poslednja dva dana. Ako je nema, preuzima stranicu uživo. Programeri mogu da promene max_age_seconds na 0 kako bi za cene, rezultate i najnovije vesti uvek čitali stranice uživo. Za referentni materijal koji se retko menja mogu da povećaju tu vrednost. Postavite cache_only na true za radna opterećenja koja nikada ne bi trebalo da pokrenu zahtev uživo.

Svaki rezultat beleži da li je sadržaj potekao iz sačuvane kopije ili iz preuzimanja uživo, kao i kada je preuzet.

URL adrese u zahtevu preuzimaju se paralelno, svaka sa sopstvenim vremenskim budžetom i sopstvenim statusom. Jedna spora ili neispravna stranica ne obara ostale. Status pokazuje šta se desilo sa svakom URL adresom, tako da agent može ponovo da pokuša samo sa stranicama kojima je isteklo vreme, a ostale da zadrži.

Context API vraća upotrebljiv i potpun sadržaj

Testirali smo Context API u poređenju sa servisima Firecrawl, Exa, Parallel, Keenable i Context.dev na 1.000 URL adresa uzorkovanih iz stvarnih zahteva agenata za preuzimanje. Skup obuhvata 715 sajtova i uključuje državne i akademske izvore, kao i stranice koje nisu na engleskom. Zatim je zaseban model-sudija ocenio izlaze, ne znajući koji ih je provajder proizveo.

Grafikon meri učinak prema tri kriterijuma:

  • Upotrebljivost: Udeo URL adresa za koje je vraćen stvarni sadržaj stranice, a ne stranica sa greškom ili prazan rezultat.
  • Odziv činjenica: Sudija prikuplja ključne činjenice pronađene na stranici kod svih provajdera, a zatim proverava koje od njih sadrži svaki pojedinačni izlaz. Neuspelo preuzimanje dobija nula poena.
  • Preciznost sadržaja: Udeo vraćenog teksta koji predstavlja sadržaj stranice, a ne obaveštenja o kolačićima, navigaciju ili oglase, u proseku za sve URL adrese. Neuspešno preuzimanje dobija nula poena.

U ovoj evaluaciji Context API je vratio upotrebljiv sadržaj za 92,3% URL adresa, izdvojio 87,9% ključnih činjenica i ostvario preciznost sadržaja od 80,3%.

Cene

Context API košta 1 USD na 1.000 preuzetih URL adresa. Programeri plaćaju za svaku URL adresu koja vrati status ok. URL adrese koje ne uspeju ne naplaćuju se.

Prvi koraci

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

Svaki rezultat stiže sa Markdown sadržajem stranice, odlomcima koji odgovaraju upitu, metapodacima stranice i statusom. Proverite status svakog rezultata pre nego što upotrebite njegov sadržaj.

Pročitajte dokumentaciju za Context API ili pogledajte API referencu.

  1. Orchestrator: jedan API za pouzdanu inferencijuProgrameri17. nov 2026.
  2. Predstavljamo Monitor API kompanije PerplexityProgrameri16. nov 2026.