A Context API bármely weboldalról kinyeri a teljes kontextust

A Perplexity Context API segítségével tiszta Markdownt, linkeket és releváns részleteket biztosíthat az MI-ügynököknek gyorsítótárazott vagy élő weboldalakról.

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

Amikor valaki kérdést tesz fel egy chatbotnak, előfordulhat, hogy egy MI-ügynöknek több weboldalt is el kell olvasnia a válaszhoz. A hagyományos keresési találatok gyakran csak kivonatokat adnak vissza. Egy oldal közvetlen lekérése nyers HTML-t eredményezhet, amely tele van navigációs elemekkel, cookie-bannerekkel és hirdetésekkel. Az ügynököknek az oldal kontextusára olyan formátumban van szükségük, amelyet egy modell fel tud használni, a fejlesztőknek pedig arra, hogy szabályozhassák, mennyire legyen friss ez a kontextus.

Ma bemutatjuk a Perplexity Context API-t, amely legfeljebb 10 URL-t olvas be, és minden oldalhoz tiszta Markdownt, HTML-t, linkeket és lekérdezésalapú kivonatokat ad vissza. Az információk a Perplexity hatalmas webes indexéből vagy élő lekérésből származnak. Az ügynökök minden kérésnél megadhatják a kívánt frissességet, és ellenőrizhetik az egyes eredmények forrását.

A Context API számos formátumot támogat

Az ügynökök úgy indíthatnak kérést, hogy megadják az URL-ek listáját és a kimeneti formátumokat. Az API minden URL-hez visszaad egy eredményt, ugyanabban a sorrendben.

A Context API számos válaszformátumot támogat:

  • Markdown: Az oldal tartalma tiszta Markdown formátumban, készen arra, hogy egy modell kontextusába kerüljön.
  • HTML: Az oldal HTML-kódja azoknak az alkalmazásoknak, amelyek maguk végzik az elemzést.
  • Linkek: Az oldalon található linkek abszolút URL-ként, ismétlődések nélkül és az oldalon szereplő sorrendben, hogy az ügynök eldönthesse, merre haladjon tovább.
  • Kivonatok: Az oldal azon részletei, amelyek a legrelevánsabbak a megadott lekérdezéshez, a fejlesztő által oldalanként beállított tokenkorláton belül.

A Context API nem összefoglalót generál, hanem minden oldalról a lekérdezés szempontjából releváns részleteket választja ki. Így a modell az oldal eredeti szövegezését kapja meg, de csak a kiválasztott részleteket, ezért kevesebb szöveget kell feldolgoznia.

Minden sikeres eredmény metaadatokat is tartalmaz, például a címet, a leírást, a nyelvet, a szerzőt és a közzététel dátumát, valamint az oldal Open Graph-címkéit. A Markdown előállításához a Context API blokkokra bontja az oldalt, egy modell pedig pontozással eldönti, hogy az egyes blokkok fő tartalmat vagy sablonos töltelékszöveget tartalmaznak. Csak a tartalmi blokkok maradnak meg.

Nélkülözhetetlen a teljes képet igénylő feladatokhoz

Egy releváns oldal megtalálása nem mindig elég egy feladat elvégzéséhez. A Context API segítségével az ügynökök a kiválasztott URL-ekről lekérhetik az összetett feladatok elvégzéséhez szükséges tartalmat.

  • API-integráció megvalósítása: Egy keresési találat rámutathat a megfelelő dokumentációra anélkül, hogy tartalmazná a szükséges paramétereket, a hitelesítési utasításokat vagy a hibaeseteket. A Context API segíthet egy kódoló ügynöknek lekérni a dokumentációt és az API-referenciákat, hogy ezek alapján írja meg az integrációt.
  • Aktuális árak összehasonlítása: Egy feltüntetett ár függhet olyan használati korlátoktól, számlázási feltételektől vagy jogosultsági feltételektől, amelyek hiányoznak a keresési kivonatból. Az ügynök élő lekérést kérhet a kiválasztott árazási oldalakról, és az összehasonlítás előtt elolvashatja ezeket a feltételeket.
  • Szabályzattal kapcsolatos kérdések megválaszolása: Egy visszaküldési szabályzatból származó kivonat megadhatja a szokásos visszaküldési határidőt, de kihagyhatja az egyes termékekre vagy régiókra vonatkozó kivételeket. Egy ügyfélszolgálati ügynök lekérheti a szabályzat oldalát, hogy a válasza figyelembe vegye ezeket a kivételeket.
  • Kutatás több forrásból: Egy keresési kivonat felszínre hozhat egy megállapítást a módszertan, a kikötések vagy a tágabb érvelés nélkül. Egy kutatóügynök lekérheti a kiválasztott cikkeket és jelentéseket, majd összevetheti a bizonyítékokat ahelyett, hogy csak a kivonatokra hagyatkozna.

A frissesség szabályozása és az URL-ek megbízható kezelése

Alapértelmezés szerint a Context API először a Perplexity webes indexében keresi az oldalnak az elmúlt két napban lekért másolatát. Ha ilyen nincs, élőben kéri le az oldalt. Árak, sporteredmények és friss hírek esetén a fejlesztők a max_age_seconds értékét 0 értékre módosíthatják, hogy mindig az élő oldalakat olvassák be. A ritkán változó referenciaanyagoknál növelhetik ezt az értéket. Azoknál a munkaterheléseknél, amelyek soha nem indíthatnak élő kérést, a cache_only értékét true-ra kell állítani.

Minden eredmény rögzíti, hogy a tartalom tárolt másolatból vagy élő lekérésből származik-e, és hogy mikor történt a lekérés.

A kérésben szereplő URL-ek lekérése párhuzamosan történik, mindegyikhez saját időkeret és saját állapot tartozik. Egy lassú vagy hibás oldal nem okozza a többi sikertelenségét. Az állapot jelzi, mi történt az egyes URL-ekkel, így az ügynök csak az időtúllépés miatt sikertelen oldalakat próbálhatja újra, a többit pedig megtarthatja.

A Context API használható, teljes tartalmat ad vissza

A Context API-t a Firecrawl, az Exa, a Parallel, a Keenable és a Context.dev szolgáltatással vetettük össze 1000 olyan URL-en, amelyeket valós ügynöki lekérési kérésekből vettünk mintaként. A készlet 715 webhelyet fed le, és kormányzati, tudományos, valamint nem angol nyelvű oldalakat is tartalmaz. Ezután egy különálló bírálómodell pontozta a kimeneteket anélkül, hogy tudta volna, melyiket melyik szolgáltató állította elő.

A diagram három szempont szerint méri a teljesítményt:

  • Használhatóság: Azon URL-ek aránya, amelyeknél az oldal valódi tartalma érkezett vissza, nem pedig hibaoldal vagy üres eredmény.
  • Tényfelidézés: A bíráló az összes szolgáltató kimenetéből összegyűjti az oldalon található kulcsfontosságú tényeket, majd minden egyes kimenetnél ellenőrzi, hogy ezek közül melyeket tartalmazza. A sikertelen lekérés nulla pontot kap.
  • Tartalmi pontosság: A visszaadott szöveg azon aránya, amely valódi oldaltartalom, nem pedig cookie-értesítés, navigáció vagy hirdetés, az összes URL-re átlagolva. A sikertelen lekérés nulla pontot kap.

Ebben az értékelésben a Context API az URL-ek 92,3%-ánál adott vissza használható tartalmat, a kulcsfontosságú tények 87,9%-át nyerte ki, tartalmi pontosságban pedig 80,3%-os eredményt ért el.

Árazás

A Context API díja 1 USD 1000 lekért URL-enként. A fejlesztők minden olyan URL után fizetnek, amely ok állapottal tér vissza. A sikertelen URL-ekért nem számítunk fel díjat.

Első lépések

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

Minden eredmény tartalmazza az oldal Markdown-változatát, a lekérdezésnek megfelelő részleteket, az oldal metaadatait és egy állapotot. A tartalom felhasználása előtt ellenőrizze az egyes eredmények állapotát.

Olvassa el a Context API dokumentációját, vagy tekintse meg az API-referenciát.

  1. Orchestrator: egy API a megbízható következtetéshezFejlesztők2026. nov. 17.
  2. Bemutatjuk a Perplexity Monitor API-játFejlesztők2026. nov. 16.