Context API iegūst pilnu kontekstu no jebkuras tīmekļa lapas

Izmantojiet Perplexity Context API, lai nodrošinātu MI aģentiem tīru Markdown, saites un atbilstošus teksta posmus no kešatmiņā saglabātām vai reāllaika tīmekļa lapām.

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

Kad kāds uzdod jautājumu tērzēšanas robotam, MI aģentam, lai atbildētu, var nākties izlasīt vairākas tīmekļa lapas. Standarta meklēšanas rezultāti bieži sniedz tikai fragmentus. Tieši ielādējot lapu, var tikt atgriezts neapstrādāts HTML, kas ir pilns ar navigāciju, sīkfailu baneriem un reklāmām. Aģentiem lapas konteksts ir nepieciešams formātā, ko modelis var izmantot, savukārt izstrādātājiem ir vajadzīgs veids, kā kontrolēt, cik svaigam šim kontekstam jābūt.

Šodien mēs laižam klajā Perplexity Context API, kas nolasa līdz 10 URL un katrai lapai atgriež tīru Markdown, HTML, saites un uz vaicājumu balstītus fragmentus. Informācija tiek iegūta no Perplexity plašā tīmekļa indeksa vai reāllaika ielādes. Aģenti var norādīt katra pieprasījuma svaigumu un pārbaudīt katra rezultāta avotu.

Context API atbalsta dažādus formātus

Aģenti var sākt pieprasījumu, norādot URL sarakstu un izvades formātus. API atgriež rezultātu katram URL tādā pašā secībā.

Context API atbalsta dažādus atbildes formātus:

  • Markdown: Lapas saturs tīrā Markdown formātā, gatavs ievietošanai modeļa kontekstā.
  • HTML: Lapas HTML kods lietojumprogrammām, kas veic pašas savu parsēšanu.
  • Saites: Lapā esošās saites kā absolūti URL, bez dublikātiem un lapas secībā, lai aģents varētu izlemt, kurp doties tālāk.
  • Fragmenti: Lapas teksta posmi, kas visatbilstošākie norādītajam vaicājumam, nepārsniedzot izstrādātāja katrai lapai iestatīto tokenu ierobežojumu.

Context API no katras lapas atlasa vaicājumam atbilstošus teksta posmus, nevis ģenerē kopsavilkumu. Tādējādi modelis saņem lapas oriģinālo formulējumu, taču tikai atlasītos posmus, tāpēc apstrādājamā teksta ir mazāk.

Katrs veiksmīgs rezultāts ietver arī metadatus, piemēram, virsrakstu, aprakstu, valodu, autoru un publicēšanas datumu, kā arī lapas Open Graph tagus. Lai izveidotu Markdown, Context API sadala lapu blokos, un modelis novērtē katru bloku kā pamatsaturu vai šablona tekstu. Tiek saglabāti tikai satura bloki.

Būtiski uzdevumiem, kuros nepieciešams pilns priekšstats

Ar atbilstošas lapas atrašanu ne vienmēr pietiek, lai paveiktu darbu. Izmantojot Context API, aģenti var iegūt nepieciešamo saturu no atlasītiem URL, lai izpildītu sarežģītus uzdevumus.

  • API integrācijas ieviešana: Meklēšanas rezultāts var norādīt uz pareizo dokumentāciju, taču neietvert nepieciešamos parametrus, autentifikācijas norādījumus vai kļūdu gadījumus. Context API var palīdzēt programmēšanas aģentam iegūt dokumentāciju un API atsauces materiālus, lai uz šīs informācijas pamata izveidotu integrāciju.
  • Aktuālo cenu salīdzināšana: Norādītā cena var būt atkarīga no lietojuma ierobežojumiem, norēķinu noteikumiem vai atbilstības nosacījumiem, kuru meklēšanas izvilkumā nav. Aģents var pieprasīt atlasītu cenu lapu reāllaika ielādi un izlasīt šos nosacījumus pirms salīdzināšanas.
  • Atbildes uz jautājumiem par noteikumiem: Preču atgriešanas noteikumu izvilkumā var būt norādīts standarta atgriešanas termiņš, bet izlaisti izņēmumi konkrētiem produktiem vai reģioniem. Atbalsta aģents var iegūt noteikumu lapu, lai tā atbildē tiktu ņemti vērā šie izņēmumi.
  • Izpēte, izmantojot vairākus avotus: Meklēšanas izvilkumā var parādīties kāds atklājums bez metodoloģijas, atrunām vai plašākas argumentācijas. Izpētes aģents var iegūt atlasītos rakstus un pārskatus un pēc tam salīdzināt pierādījumus, nevis paļauties tikai uz izvilkumiem.

Pārvaldiet satura svaigumu un uzticami apstrādājiet URL

Pēc noklusējuma Context API vispirms pārbauda, vai Perplexity tīmekļa indeksā ir pēdējo divu dienu laikā ielādēta lapas kopija. Ja tādas nav, tā ielādē lapu reāllaikā. Izstrādātāji var mainīt max_age_seconds uz 0, lai vienmēr nolasītu lapas reāllaikā, piemēram, cenām, sporta rezultātiem un jaunākajām ziņām. Atsauces materiāliem, kas mainās reti, šo vērtību var palielināt. Iestatiet cache_only uz true darba slodzēm, kurām nekad nevajadzētu izraisīt reāllaika pieprasījumu.

Katrā rezultātā ir norādīts, vai saturs iegūts no saglabātas kopijas vai reāllaika ielādes, kā arī tā ielādes laiks.

Pieprasījumā norādītie URL tiek ielādēti paralēli, katram ar savu laika budžetu un savu statusu. Viena lēna vai bojāta lapa neizraisa pārējo kļūmi. Statuss norāda, kas notika ar katru URL, tāpēc aģents var atkārtoti mēģināt ielādēt tikai tās lapas, kurām iestājās noildze, un paturēt pārējās.

Context API atgriež lietojamu un pilnīgu saturu

Mēs salīdzinājām Context API ar Firecrawl, Exa, Parallel, Keenable un Context.dev, izmantojot 1000 URL, kas atlasīti no reāliem aģentu ielādes pieprasījumiem. Kopa aptver 715 vietnes un ietver valdības un akadēmiskos avotus, kā arī lapas, kas nav angļu valodā. Pēc tam atsevišķs vērtētājmodelis novērtēja rezultātus, nezinot, kurš pakalpojumu sniedzējs katru no tiem ir izveidojis.

Diagrammā veiktspēja novērtēta pēc trim kritērijiem:

  • Lietojamība: To URL īpatsvars, kuriem tika atgriezts lapas faktiskais saturs, nevis kļūdas lapa vai tukšs rezultāts.
  • Faktu pārklājums: Vērtētājs apkopo galvenos lapā atrastos faktus no visu pakalpojumu sniedzēju rezultātiem un pēc tam pārbauda, kuri no tiem ir ietverti katrā izvadē. Neveiksmīga ielāde tiek novērtēta ar nulli.
  • Satura precizitāte: Atgrieztā teksta īpatsvars, ko veido lapas saturs, nevis sīkfailu paziņojumi, navigācija vai reklāmas, vidēji visiem URL. Neizdevusies ielāde tiek novērtēta ar nulli.

Šajā novērtējumā Context API atgrieza izmantojamu saturu 92,3 % URL, ieguva 87,9 % galveno faktu un sasniedza 80,3 % satura precizitātes rādītājā.

Cenas

Context API izmaksā 1 $ par 1000 ielādētiem URL. Izstrādātāji maksā par katru URL, kas atgriež statusu ok. Par neveiksmīgiem URL maksa netiek iekasēta.

Darba sākšana

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

Katrs rezultāts tiek atgriezts ar lapas Markdown, vaicājumam atbilstošajiem teksta posmiem, lapas metadatiem un statusu. Pirms rezultāta satura izmantošanas pārbaudiet tā statusu.

Izlasiet Context API dokumentāciju vai skatiet API atsauces materiālus.

  1. Orchestrator: viens API uzticamai inferenceiIzstrādātāji2026. g. 17. nov.
  2. Iepazīstinām ar Perplexity Monitor APIIzstrādātāji2026. g. 16. nov.