Context API henter ut full kontekst fra hvilken som helst nettside
Bruk Perplexity Context API til å gi AI-agenter ren Markdown, lenker og relevante avsnitt fra bufrede eller direkte hentede nettsider.

Når noen stiller en chatbot et spørsmål, kan en AI-agent måtte lese flere nettsider for å svare. Vanlige søkeresultater gir ofte bare utdrag. Henter man en side direkte, kan man få rå HTML full av navigasjon, informasjonskapselbannere og annonser. Agenter trenger sidens kontekst i et format en modell kan bruke, mens utviklere trenger en måte å styre hvor fersk denne konteksten må være.
I dag lanserer vi Perplexity Context API, som leser opptil 10 URL-er og returnerer ren Markdown, HTML, lenker og spørringsbaserte utdrag for hver side. Informasjonen kommer fra Perplexitys omfattende nettindeks eller fra en direkte henting. Agenter kan angi hvor ferske dataene skal være for hver forespørsel, og validere kilden til hvert resultat.
Context API støtter en rekke formater
Agenter kan starte en forespørsel ved å oppgi en liste med URL-er og angi utdataformatene. API-et returnerer ett resultat for hver URL i samme rekkefølge.
Context API støtter en rekke svarformater:
- Markdown: Sideinnholdet som ren Markdown, klart til å legges inn i en modells kontekst.
- HTML: Sidens HTML, for applikasjoner som gjør sin egen parsing.
- Lenker: Lenkene på siden som absolutte URL-er, uten duplikater og i samme rekkefølge som på siden, slik at en agent kan avgjøre hvor den skal gå videre.
- Utdrag: De avsnittene på siden som er mest relevante for en gitt spørring, innenfor tokengrensen utvikleren har satt for hver side.
Context API velger ut avsnitt fra hver side som er relevante for spørringen, i stedet for å generere et sammendrag. Dermed får modellen sidens opprinnelige ordlyd, men bare de utvalgte avsnittene, så det blir mindre tekst å behandle.
Hvert vellykket resultat inneholder også metadata som tittel, beskrivelse, språk, forfatter og publiseringsdato, i tillegg til sidens Open Graph-tagger. For å bygge Markdown-innholdet deler Context API en side inn i blokker, og en modell vurderer om hver blokk er hovedinnhold eller standardtekst. Bare innholdsblokkene beholdes.
Avgjørende for oppgaver som krever hele bildet
Det er ikke alltid nok å finne en relevant side for å få jobben gjort. Med Context API kan agenter hente innholdet de trenger fra utvalgte URL-er for å fullføre komplekse oppgaver.
- Implementere en API-integrasjon: Et søkeresultat kan peke på riktig dokumentasjon uten å inkludere de nødvendige parameterne, autentiseringsinstruksjonene eller feiltilfellene. Context API kan hjelpe en kodeagent med å hente dokumentasjonen og API-referansene, slik at den kan skrive en integrasjon basert på disse detaljene.
- Sammenligne gjeldende priser: En oppgitt pris kan avhenge av bruksgrenser, faktureringsvilkår eller kvalifikasjonskrav som mangler i et søkeutdrag. En agent kan be om direkte henting av utvalgte prissider og lese disse vilkårene før den gjør en sammenligning.
- Svare på spørsmål om vilkår: Et utdrag fra returvilkårene kan oppgi den vanlige returfristen, men utelate unntak for bestemte produkter eller regioner. En kundestøtteagent kan hente siden med vilkårene, slik at svaret tar hensyn til disse unntakene.
- Undersøkelser på tvers av flere kilder: Et søkeutdrag kan vise et funn uten metodikken, forbeholdene eller den omkringliggende argumentasjonen. En forskningsagent kan hente de utvalgte artiklene og rapportene og deretter sammenligne belegget i stedet for å stole utelukkende på utdrag.
Styr hvor ferskt innholdet er, og håndter URL-er pålitelig
Som standard sjekker Context API først Perplexitys nettindeks etter en kopi av siden som er hentet i løpet av de siste to dagene. Finnes det ingen, hentes siden direkte. Utviklere kan endre max_age_seconds til 0 for alltid å lese sidene direkte, for eksempel for priser, kampresultater og siste nytt. For referansemateriale som sjelden endres, kan de øke verdien. Sett cache_only til true for arbeidsbelastninger som aldri skal utløse en direkte forespørsel.
Hvert resultat registrerer om innholdet kom fra en lagret kopi eller en direkte henting, og når det ble hentet.
URL-er i en forespørsel hentes parallelt, hver med sitt eget tidsbudsjett og sin egen status. Én treg eller ødelagt side får ikke de andre til å mislykkes. Statusen viser hva som skjedde med hver URL, slik at en agent bare kan prøve på nytt for sidene som fikk tidsavbrudd, og beholde resten.
Context API returnerer brukbart, komplett innhold
Vi testet Context API mot Firecrawl, Exa, Parallel, Keenable og Context.dev på 1000 URL-er trukket ut fra ekte hentingsforespørsler fra agenter. Utvalget dekker 715 nettsteder og inkluderer offentlige og akademiske kilder samt sider på andre språk enn engelsk. En separat vurderingsmodell poengsatte deretter resultatene uten å vite hvilken leverandør som hadde produsert hvert av dem.
Diagrammet måler ytelse etter tre kriterier:
- Brukbart: Andelen URL-er som returnerte sidens faktiske innhold, ikke en feilside eller et tomt resultat.
- Faktagjenkalling: Vurderingsmodellen samler nøkkelfaktaene som finnes på en side på tvers av alle leverandører, og sjekker deretter hvilke av dem hvert resultat inneholder. En mislykket henting gir null poeng.
- Innholdspresisjon: Andelen av den returnerte teksten som er sideinnhold, og ikke cookievarsler, navigasjon eller annonser, i gjennomsnitt for alle URL-er. En mislykket henting gir null poeng.
I denne evalueringen returnerte Context API brukbart innhold for 92,3 % av URL-ene, fant 87,9 % av nøkkelfaktaene og oppnådde en innholdspresisjon på 80,3 %.
Priser
Context API koster 1 USD per 1000 hentede URL-er. Utviklere betaler for hver URL som returnerer ok. URL-er som mislykkes, 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, avsnittene som samsvarer med spørringen, sidens metadata og en status. Sjekk statusen til hvert resultat før du bruker innholdet.
Les dokumentasjonen for Context API eller se API-referansen.