Context API udtrækker den fulde kontekst fra enhver webside
Brug Perplexity Context API til at give AI-agenter ren Markdown, links og relevante passager fra cachelagrede eller live websider.

Når nogen stiller en chatbot et spørgsmål, kan en AI-agent have brug for at læse flere websider for at besvare det. Almindelige søgeresultater returnerer ofte kun uddrag. Henter man en side direkte, kan man få rå HTML, der er fyldt med navigation, cookiebannere og annoncer. Agenter har brug for sidens kontekst i et format, som en model kan bruge, mens udviklere har brug for en måde at styre, hvor opdateret den kontekst skal være.
I dag lancerer vi Perplexity Context API, som læser op til 10 URL'er og returnerer ren Markdown, HTML, links og forespørgselsbaserede uddrag for hver side. Oplysningerne kommer fra Perplexitys omfattende webindeks eller en live-hentning. Agenter kan angive aktualiteten for hver anmodning og validere kilden til hvert resultat.
Context API understøtter en række formater
Agenter kan starte en anmodning ved at angive en liste over URL'er og de ønskede outputformater. API'et returnerer et resultat for hver URL i samme rækkefølge.
Context API understøtter en række svarformater:
- Markdown: Sidens indhold som ren Markdown, klar til at blive placeret i en models kontekst.
- HTML: Sidens HTML til applikationer, der selv står for parsingen.
- Links: Sidens links som absolutte URL'er uden dubletter og i sidens rækkefølge, så en agent kan beslutte, hvor den skal gå hen som det næste.
- Uddrag: De passager på siden, der er mest relevante for en given forespørgsel, inden for den tokengrænse, som udvikleren har fastsat for hver side.
Context API udvælger de passager fra hver side, der er relevante for forespørgslen, i stedet for at generere et resumé. Modellen får dermed sidens oprindelige ordlyd, men kun de udvalgte passager, så der er mindre tekst at behandle.
Hvert vellykket resultat indeholder også metadata som titel, beskrivelse, sprog, forfatter og udgivelsesdato samt sidens Open Graph-tags. For at opbygge Markdown-indholdet opdeler Context API en side i blokke, og en model vurderer, om hver blok er hovedindhold eller standardtekst. Kun indholdsblokkene bevares.
Afgørende for opgaver, der kræver det fulde billede
Det er ikke altid nok at finde en relevant side for at løse en opgave. Med Context API kan agenter hente det indhold, de har brug for, fra udvalgte URL'er for at udføre komplekse opgaver.
- Implementering af en API-integration: Et søgeresultat kan pege på den rigtige dokumentation uden at indeholde de nødvendige parametre, godkendelsesinstruktioner eller fejltilfælde. Context API kan hjælpe en kodningsagent med at hente dokumentationen og API-referencerne, så den kan skrive en integration ud fra disse detaljer.
- Sammenligning af aktuelle priser: En angivet pris kan afhænge af forbrugsgrænser, faktureringsvilkår eller betingelser for berettigelse, som mangler i et søgeuddrag. En agent kan anmode om en live-hentning af udvalgte prissider og læse disse betingelser, før den foretager en sammenligning.
- Besvarelse af spørgsmål om politikker: Et uddrag af en returpolitik kan angive den almindelige returperiode, men udelade undtagelser for bestemte produkter eller regioner. En supportagent kan hente siden med politikken, så dens svar tager højde for disse undtagelser.
- Forskning på tværs af flere kilder: Et søgeuddrag kan fremhæve et resultat uden metoden, forbeholdene eller den omgivende argumentation. En forskningsagent kan hente de udvalgte artikler og rapporter og derefter sammenligne belæggene i stedet for kun at forlade sig på uddrag.
Styr aktualiteten, og håndter URL'er pålideligt
Som standard tjekker Context API først Perplexitys webindeks for en kopi af siden, der er hentet inden for de seneste to dage. Hvis der ikke findes en, henter API'et siden live. Udviklere kan ændre max_age_seconds til 0 for altid at læse siderne live, f.eks. til priser, sportsresultater og seneste nyheder. For referencemateriale, der sjældent ændres, kan de hæve værdien. Sæt cache_only til true for arbejdsbelastninger, der aldrig må udløse en live-anmodning.
Hvert resultat registrerer, om indholdet kom fra en gemt kopi eller en live-hentning, og hvornår det blev hentet.
URL'erne i en anmodning hentes parallelt, hver med sit eget tidsbudget og sin egen status. Én langsom eller defekt side får ikke de andre til at fejle. Statussen viser, hvad der skete med hver URL, så en agent kun behøver at prøve de sider igen, der fik timeout, og kan beholde resten.
Context API returnerer brugbart og komplet indhold
Vi testede Context API mod Firecrawl, Exa, Parallel, Keenable og Context.dev på 1.000 URL'er udtaget fra rigtige hentningsanmodninger fra agenter. Sættet dækker 715 websteder og omfatter offentlige og akademiske kilder samt sider på andre sprog end engelsk. En separat dommermodel bedømte derefter outputtene uden at vide, hvilken udbyder der havde produceret hvert enkelt.
Diagrammet måler ydeevnen ud fra tre kriterier:
- Brugbart: Andelen af URL'er, der returnerede sidens faktiske indhold og ikke en fejlside eller et tomt resultat.
- Faktadækning: Dommermodellen samler de vigtigste fakta, der er fundet på en side på tværs af alle udbydere, og kontrollerer derefter, hvilke af dem hvert output indeholder. En mislykket hentning giver nul point.
- Indholdspræcision: Andelen af den returnerede tekst, der er sideindhold og ikke cookiemeddelelser, navigation eller reklamer, beregnet som gennemsnit over alle URL’er. En mislykket hentning giver nul point.
I denne evaluering returnerede Context API brugbart indhold for 92,3 % af URL’erne, genfandt 87,9 % af de vigtigste fakta og opnåede en præcision på 80,3 % for indholdspræcision.
Priser
Context API koster 1 $ pr. 1.000 hentede URL'er. Udviklere betaler for hver URL, der returnerer ok. URL'er, der fejler, faktureres ikke.
Kom i gang
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"]
}'Hvert resultat returneres med sidens Markdown, de passager, der matcher forespørgslen, sidens metadata og en status. Kontrollér status for hvert resultat, før du bruger dets indhold.
Læs dokumentationen til Context API, eller se API-referencen.