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.

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
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.