Context API získa úplný kontext z akejkoľvek webovej stránky

Pomocou Perplexity Context API poskytnite AI agentom čistý Markdown, odkazy a relevantné pasáže z webových stránok vo vyrovnávacej pamäti alebo načítaných naživo.

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

Keď niekto položí chatbotu otázku, AI agent si na odpoveď možno bude musieť prečítať niekoľko webových stránok. Štandardné výsledky vyhľadávania často vracajú iba úryvky. Priame načítanie stránky môže vrátiť nespracovaný HTML kód plný navigácie, bannerov so súbormi cookie a reklám. Agenti potrebujú kontext stránky vo formáte, s ktorým dokáže model pracovať, a vývojári zase potrebujú spôsob, ako určiť, aký aktuálny musí tento kontext byť.

Dnes spúšťame Perplexity Context API, ktoré prečíta až 10 URL adries a pre každú stránku vráti čistý Markdown, HTML, odkazy a úryvky na základe dopytu. Informácie pochádzajú z rozsiahleho webového indexu Perplexity alebo z načítania v reálnom čase. Agenti môžu pri každej požiadavke určiť požadovanú aktuálnosť a overiť zdroj každého výsledku.

Context API podporuje rôzne formáty

Agenti môžu odoslať požiadavku tak, že zadajú zoznam URL adries a určia výstupné formáty. API vráti výsledok pre každú URL adresu v rovnakom poradí.

Context API podporuje rôzne formáty odpovedí:

  • Markdown: Obsah stránky ako čistý Markdown pripravený na vloženie do kontextu modelu.
  • HTML: HTML kód stránky pre aplikácie, ktoré používajú vlastné parsovanie.
  • Odkazy: Odkazy na stránke ako absolútne URL adresy bez duplikátov a v poradí, v akom sú na stránke, aby sa agent mohol rozhodnúť, kam pokračovať ďalej.
  • Úryvky: Pasáže stránky, ktoré sú najrelevantnejšie pre zadaný dopyt, v rámci limitu tokenov, ktorý vývojár nastavil pre každú stránku.

Context API namiesto generovania zhrnutia vyberá z každej stránky pasáže relevantné pre dopyt. Model tak dostane pôvodné znenie stránky, ale iba vybrané pasáže, takže musí spracovať menej textu.

Každý úspešný výsledok obsahuje aj metadáta, ako je názov, popis, jazyk, autor a dátum zverejnenia, ako aj značky Open Graph stránky. Pri vytváraní Markdownu Context API rozdelí stránku na bloky a model ohodnotí každý blok ako hlavný obsah alebo šablónový text. Zachovajú sa iba bloky s obsahom.

Nevyhnutné pre úlohy, ktoré vyžadujú úplný obraz

Nájsť relevantnú stránku nie vždy stačí na splnenie zadania. Vďaka Context API môžu agenti z vybraných URL adries získať obsah, ktorý potrebujú na zvládnutie zložitých úloh.

  • Implementácia integrácie API: Výsledok vyhľadávania môže nájsť správnu dokumentáciu, ale bez požadovaných parametrov, pokynov na autentifikáciu či chybových stavov. Context API môže pomôcť programovaciemu agentovi získať dokumentáciu a referenčné materiály k API, aby na základe týchto podrobností napísal integráciu.
  • Porovnávanie aktuálnych cien: Uvedená cena môže závisieť od limitov používania, fakturačných podmienok alebo podmienok nároku, ktoré vo výňatku z vyhľadávania chýbajú. Agent si môže vyžiadať načítanie vybraných cenníkových stránok v reálnom čase a pred porovnaním si tieto podmienky prečítať.
  • Odpovedanie na otázky o pravidlách: Výňatok z pravidiel vrátenia tovaru môže uvádzať štandardnú lehotu na vrátenie, ale vynechať výnimky pre konkrétne produkty alebo regióny. Agent zákazníckej podpory môže získať stránku s pravidlami, aby jeho odpoveď tieto výnimky zohľadňovala.
  • Výskum naprieč viacerými zdrojmi: Výňatok z vyhľadávania môže priniesť zistenie bez metodiky, výhrad alebo súvisiacej argumentácie. Výskumný agent môže získať vybrané články a správy a potom porovnať dôkazy namiesto toho, aby sa spoliehal iba na výňatky.

Riaďte aktuálnosť a spoľahlivo spracúvajte URL adresy

Context API v predvolenom nastavení najprv skontroluje, či webový index Perplexity obsahuje kópiu stránky načítanú za posledné dva dni. Ak nie, načíta stránku v reálnom čase. Vývojári môžu zmeniť max_age_seconds na 0, aby sa pri cenách, výsledkoch zápasov a najnovších správach vždy čítali stránky v reálnom čase. Pri referenčných materiáloch, ktoré sa menia zriedka, môžu túto hodnotu zvýšiť. Pre úlohy, ktoré by nikdy nemali spustiť požiadavku v reálnom čase, nastavte cache_only na hodnotu true.

Každý výsledok zaznamenáva, či obsah pochádza z uloženej kópie alebo z načítania v reálnom čase, a kedy bol načítaný.

URL adresy v požiadavke sa načítavajú paralelne, každá s vlastným časovým limitom a vlastným stavom. Jedna pomalá alebo nefunkčná stránka nespôsobí zlyhanie ostatných. Stav ukazuje, čo sa stalo s každou URL adresou, takže agent môže zopakovať iba stránky, pri ktorých vypršal časový limit, a ostatné si ponechať.

Context API vracia použiteľný a úplný obsah

Context API sme porovnali so službami Firecrawl, Exa, Parallel, Keenable a Context.dev na 1 000 URL adresách vybraných zo skutočných požiadaviek agentov na načítanie stránok. Súbor pokrýva 715 webových lokalít a zahŕňa vládne a akademické zdroje aj neanglické stránky. Samostatný hodnotiaci model potom ohodnotil výstupy bez toho, aby vedel, ktorý poskytovateľ ktorý z nich vytvoril.

Graf meria výkon podľa troch kritérií:

  • Použiteľnosť: Podiel URL adries, pri ktorých sa vrátil skutočný obsah stránky, a nie chybová stránka alebo prázdny výsledok.
  • Úplnosť faktov: Hodnotiaci model zhromaždí kľúčové fakty nájdené na stránke u všetkých poskytovateľov a potom overí, ktoré z nich obsahuje každý výstup. Neúspešné načítanie získa nulové skóre.
  • Presnosť obsahu: Podiel vráteného textu, ktorý tvorí obsah stránky, a nie oznámenia o súboroch cookie, navigácia či reklamy, spriemerovaný naprieč všetkými URL adresami. Neúspešné načítanie získa nulové skóre.

V tomto hodnotení rozhranie Context API vrátilo použiteľný obsah pre 92,3 % URL adries, získalo 87,9 % kľúčových faktov a v presnosti obsahu dosiahlo 80,3 %.

Ceny

Context API stojí 1 $ za 1 000 načítaných URL adries. Vývojári platia za každú URL adresu, ktorá vráti stav ok. Neúspešné URL adresy sa neúčtujú.

Začíname

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

Každý výsledok obsahuje Markdown stránky, pasáže zodpovedajúce dopytu, metadáta stránky a stav. Pred použitím obsahu výsledku skontrolujte jeho stav.

Prečítajte si dokumentáciu k Context API alebo si pozrite referenčnú príručku API.

  1. Orchestrator: jedno API pre spoľahlivú inferenciuVývojári17. 11. 2026
  2. Predstavujeme Monitor API od PerplexityVývojári16. 11. 2026