Context API získá úplný kontext z jakékoli webové stránky
Pomocí Perplexity Context API poskytněte AI agentům čistý Markdown, odkazy a relevantní pasáže z webových stránek v mezipaměti nebo načtených živě.

Když někdo položí chatbotovi otázku, AI agent možná bude muset k odpovědi přečíst několik webových stránek. Standardní výsledky vyhledávání často vracejí jen úryvky. Přímé načtení stránky může vrátit surové HTML plné navigace, cookie lišt a reklam. Agenti potřebují kontext stránky ve formátu, se kterým model dokáže pracovat, zatímco vývojáři potřebují způsob, jak určit, nakolik aktuální tento kontext musí být.
Dnes spouštíme Perplexity Context API, které načte až 10 URL adres a pro každou stránku vrátí čistý Markdown, HTML, odkazy a úryvky založené na dotazu. Informace pocházejí z rozsáhlého webového indexu Perplexity nebo z živého načtení. Agenti mohou u každého požadavku určit požadovanou aktuálnost a ověřit zdroj každého výsledku.
Context API podporuje řadu formátů
Agenti mohou zahájit požadavek zadáním seznamu URL adres a určením výstupních formátů. API vrátí výsledek pro každou URL adresu ve stejném pořadí.
Context API podporuje řadu formátů odpovědí:
- Markdown: Obsah stránky jako čistý Markdown, připravený k vložení do kontextu modelu.
- HTML: HTML kód stránky pro aplikace, které provádějí vlastní parsování.
- Odkazy: Odkazy na stránce jako absolutní URL adresy, bez duplicit a v pořadí, v jakém se na stránce vyskytují, aby se agent mohl rozhodnout, kam pokračovat dál.
- Úryvky: Pasáže stránky nejrelevantnější k zadanému dotazu, v rámci limitu tokenů, který vývojář nastaví pro každou stránku.
Context API místo generování shrnutí vybírá z každé stránky pasáže, které jsou relevantní k dotazu. Model tak dostane původní znění stránky, ale pouze vybrané pasáže, takže musí zpracovat méně textu.
Každý úspěšný výsledek obsahuje také metadata, jako je název, popis, jazyk, autor a datum publikování, a navíc tagy Open Graph dané stránky. Při sestavování Markdownu Context API rozdělí stránku na bloky a model každý blok ohodnotí buď jako hlavní obsah, nebo jako šablonový balast. Zachovány zůstanou pouze bloky s obsahem.
Nezbytné pro úkoly, které vyžadují úplný obraz
Najít relevantní stránku ne vždy stačí k dokončení práce. Díky Context API mohou agenti z vybraných URL adres získat obsah, který potřebují k dokončení složitých úkolů.
- Implementace integrace API: Výsledek vyhledávání může odkazovat na správnou dokumentaci, aniž by obsahoval potřebné parametry, pokyny k ověřování nebo chybové stavy. Context API může programovacímu agentovi pomoci získat dokumentaci a reference API, aby na základě těchto podrobností napsal integraci.
- Porovnávání aktuálních cen: Uvedená cena může záviset na limitech využití, platebních podmínkách nebo podmínkách nároku, které v úryvku z vyhledávání chybí. Agent si může vyžádat živé načtení vybraných stránek s ceníky a přečíst si tyto podmínky ještě před porovnáním.
- Odpovídání na dotazy k zásadám: Úryvek ze zásad vracení zboží může uvádět standardní lhůtu pro vrácení, ale vynechat výjimky pro konkrétní produkty nebo regiony. Agent zákaznické podpory může načíst stránku se zásadami, aby jeho odpověď tyto výjimky zohlednila.
- Výzkum napříč více zdroji: Úryvek z vyhledávání může zachytit zjištění bez metodiky, výhrad nebo souvisejících argumentů. Výzkumný agent může načíst vybrané články a zprávy a poté porovnat důkazy, místo aby se spoléhal pouze na úryvky.
Řízení aktuálnosti a spolehlivé zpracování URL adres
Context API ve výchozím nastavení nejprve zkontroluje, zda webový index Perplexity obsahuje kopii stránky načtenou během posledních dvou dnů. Pokud ne, načte stránku živě. Vývojáři mohou změnit max_age_seconds na 0, aby vždy četli živé stránky, například u cen, sportovních výsledků nebo nejnovějších zpráv. U referenčních materiálů, které se mění jen zřídka, mohou hodnotu zvýšit. U úloh, které by nikdy neměly spustit živý požadavek, nastavte cache_only na true.
U každého výsledku je zaznamenáno, zda obsah pochází z uložené kopie, nebo z živého načtení, a kdy byl načten.
URL adresy v požadavku se načítají paralelně, každá s vlastním časovým limitem a vlastním stavem. Jedna pomalá nebo nefunkční stránka nezpůsobí selhání ostatních. Stav udává, co se s každou URL adresou stalo, takže agent může zopakovat pouze stránky, u nichž vypršel časový limit, a ostatní si ponechat.
Context API vrací použitelný a úplný obsah
Context API jsme otestovali v porovnání s Firecrawl, Exa, Parallel, Keenable a Context.dev na 1 000 URL adresách vybraných ze skutečných požadavků agentů na načtení stránek. Sada zahrnuje 715 webů, včetně vládních a akademických zdrojů a neanglických stránek. Samostatný hodnoticí model poté ohodnotil výstupy, aniž by věděl, který poskytovatel který z nich vytvořil.
Graf měří výkon podle tří kritérií:
- Použitelnost: Podíl URL adres, které vrátily skutečný obsah stránky, nikoli chybovou stránku nebo prázdný výsledek.
- Úplnost faktů: Hodnoticí model shromáždí klíčová fakta nalezená na stránce napříč všemi poskytovateli a poté zkontroluje, která z nich obsahuje každý výstup. Neúspěšné načtení získá nulové skóre.
- Přesnost obsahu: Podíl vráceného textu, který tvoří obsah stránky, a nikoli oznámení o cookies, navigace nebo reklamy, zprůměrovaný přes všechny URL adresy. Neúspěšné načtení získá nulové skóre.
V tomto hodnocení vrátilo Context API použitelný obsah pro 92,3 % URL adres, zachytilo 87,9 % klíčových faktů a v přesnosti obsahu dosáhlo skóre 80,3 %.
Ceny
Context API stojí 1 USD za 1 000 načtených URL adres. Vývojáři platí za každou URL adresu, která vrátí stav ok. Za URL adresy, jejichž načtení selže, se neúčtuje.
Začínáme
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ýsledek obsahuje Markdown stránky, pasáže odpovídající dotazu, metadata stránky a stav. Před použitím obsahu každého výsledku zkontrolujte jeho stav.
Přečtěte si dokumentaci ke Context API nebo si prohlédněte referenci API.