Context API izvlači cjelovit kontekst iz bilo koje web-stranice
Koristite Perplexity Context API kako biste AI agentima pružili čisti Markdown, poveznice i relevantne odlomke iz predmemoriranih ili uživo dohvaćenih web-stranica.

Kada netko chatbotu postavi pitanje, AI agent možda će morati pročitati nekoliko web-stranica kako bi odgovorio. Standardni rezultati pretraživanja često vraćaju samo isječke. Izravno dohvaćanje stranice može vratiti sirovi HTML, pun navigacije, bannera za kolačiće i oglasa. Agentima je potreban kontekst stranice u formatu koji model može koristiti, a programerima način da odrede koliko svjež taj kontekst mora biti.
Danas predstavljamo Perplexity Context API, koji čita do 10 URL-ova i za svaku stranicu vraća čisti Markdown, HTML, poveznice i isječke temeljene na upitu. Informacije dolaze iz opsežnog web-indeksa tvrtke Perplexity ili iz dohvaćanja uživo. Agenti mogu odrediti svježinu svakog zahtjeva i provjeriti izvor svakog rezultata.
Context API podržava različite formate
Agenti mogu pokrenuti zahtjev navođenjem popisa URL-ova i izlaznih formata. API vraća rezultat za svaki URL istim redoslijedom.
Context API podržava različite formate odgovora:
- Markdown: Sadržaj stranice kao čisti Markdown, spreman za umetanje u kontekst modela.
- HTML: HTML stranice, za aplikacije koje same provode raščlanjivanje.
- Poveznice: Poveznice sa stranice kao apsolutni URL-ovi, bez duplikata i redoslijedom kojim se pojavljuju na stranici, kako bi agent mogao odlučiti kamo dalje.
- Isječci: Odlomci stranice najrelevantniji za zadani upit, unutar ograničenja tokena koje programer postavi za svaku stranicu.
Context API odabire odlomke svake stranice koji su relevantni za upit, umjesto da generira sažetak. Zbog toga model dobiva izvorni tekst stranice, ali samo odabrane odlomke, pa ima manje teksta za obradu.
Svaki uspješan rezultat sadrži i metapodatke kao što su naslov, opis, jezik, autor i datum objave, uz oznake Open Graph stranice. Kako bi izradio Markdown, Context API dijeli stranicu na blokove, a model svaki blok ocjenjuje kao glavni sadržaj ili šablonski tekst. Zadržavaju se samo blokovi sa sadržajem.
Ključan za zadatke kojima je potrebna cjelovita slika
Pronalazak relevantne stranice nije uvijek dovoljan za obavljanje posla. Uz Context API agenti mogu dohvatiti sadržaj koji im je potreban s odabranih URL-ova kako bi izvršili složene zadatke.
- Implementacija API integracije: Rezultat pretraživanja može upućivati na pravu dokumentaciju, a da ne sadrži potrebne parametre, upute za autentifikaciju ili slučajeve pogrešaka. Context API može pomoći agentu za programiranje da dohvati dokumentaciju i API reference kako bi na temelju tih pojedinosti napisao integraciju.
- Usporedba aktualnih cijena: Navedena cijena može ovisiti o ograničenjima korištenja, uvjetima naplate ili uvjetima prihvatljivosti koji nedostaju u isječku iz pretraživanja. Agent može zatražiti dohvaćanje odabranih stranica s cijenama uživo i pročitati te uvjete prije usporedbe.
- Odgovaranje na pitanja o pravilima: Isječak pravila o povratu može navoditi standardni rok za povrat, ali izostaviti iznimke za određene proizvode ili regije. Agent za podršku može dohvatiti stranicu s pravilima kako bi njegov odgovor uzeo u obzir te iznimke.
- Istraživanje u više izvora: Isječak iz pretraživanja može izdvojiti nalaz bez metodologije, ograda ili šireg argumenta. Istraživački agent može dohvatiti odabrane članke i izvješća, a zatim usporediti dokaze umjesto da se oslanja samo na isječke.
Upravljajte svježinom i pouzdano obrađujte URL-ove
Context API prema zadanim postavkama najprije provjerava sadrži li web-indeks tvrtke Perplexity kopiju stranice dohvaćenu unutar posljednja dva dana. Ako je nema, dohvaća stranicu uživo. Programeri mogu promijeniti max_age_seconds na 0 kako bi za cijene, rezultate i najnovije vijesti uvijek čitali stranice uživo. Za referentni materijal koji se rijetko mijenja tu vrijednost mogu povećati. Postavite cache_only na true za radna opterećenja koja nikada ne bi smjela pokrenuti zahtjev uživo.
Svaki rezultat bilježi je li sadržaj došao iz pohranjene kopije ili iz dohvaćanja uživo te kada je dohvaćen.
URL-ovi u zahtjevu dohvaćaju se paralelno, svaki s vlastitim vremenskim ograničenjem i vlastitim statusom. Jedna spora ili neispravna stranica ne uzrokuje neuspjeh ostalih. Status pokazuje što se dogodilo sa svakim URL-om, pa agent može ponovno pokušati samo sa stranicama kojima je isteklo vrijeme i zadržati ostale.
Context API vraća upotrebljiv i potpun sadržaj
Testirali smo Context API u usporedbi s alatima Firecrawl, Exa, Parallel, Keenable i Context.dev na 1000 URL-ova uzorkovanih iz stvarnih zahtjeva agenata za dohvaćanje. Skup obuhvaća 715 web-mjesta i uključuje državne i akademske izvore te stranice koje nisu na engleskom jeziku. Zatim je zaseban model-ocjenjivač ocijenio rezultate ne znajući koji ih je pružatelj proizveo.
Grafikon mjeri učinak prema tri kriterija:
- Upotrebljivost: Udio URL-ova za koje je vraćen stvarni sadržaj stranice, a ne stranica s pogreškom ili prazan rezultat.
- Odziv činjenica: Ocjenjivač prikuplja ključne činjenice pronađene na stranici kod svih pružatelja usluga, a zatim provjerava koje od njih sadrži svaki pojedini rezultat. Neuspjelo dohvaćanje dobiva nula bodova.
- Preciznost sadržaja: Udio vraćenog teksta koji čini sadržaj stranice, a ne obavijesti o kolačićima, navigacija ili oglasi, uprosječen za sve URL-ove. Neuspješno dohvaćanje dobiva ocjenu nula.
U ovoj evaluaciji Context API vratio je upotrebljiv sadržaj za 92,3 % URL-ova, obuhvatio 87,9 % ključnih činjenica i postigao preciznost sadržaja od 80,3 %.
Cijene
Context API stoji 1 USD za 1000 dohvaćenih URL-ova. Programeri plaćaju svaki URL koji vrati status ok. URL-ovi koji ne uspiju ne naplaćuju se.
Prvi koraci
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 vraća se s Markdownom stranice, odlomcima koji odgovaraju upitu, metapodacima stranice i statusom. Prije korištenja sadržaja provjerite status svakog rezultata.
Pročitajte dokumentaciju za Context API ili pogledajte API referencu.