La Context API extreu el context complet de qualsevol pàgina web

Utilitzeu la Perplexity Context API per proporcionar als agents d’IA Markdown net, enllaços i passatges rellevants de pàgines web en memòria cau o en directe.

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

Quan algú fa una pregunta a un xatbot, és possible que un agent d’IA hagi de llegir diverses pàgines web per respondre-la. Els resultats de cerca estàndard sovint només retornen fragments. Obtenir una pàgina directament pot retornar HTML en brut, ple d’elements de navegació, bàners de galetes i anuncis. Els agents necessiten el context de la pàgina en un format que un model pugui fer servir, mentre que els desenvolupadors necessiten una manera de controlar com d’actualitzat ha de ser aquest context.

Avui llancem la Perplexity Context API, que llegeix fins a 10 URL i retorna, per a cada pàgina, Markdown net, HTML, enllaços i fragments basats en la consulta. La informació prové de l’extens índex web de Perplexity o d’una obtenció en directe. Els agents poden especificar l’actualitat de cada sol·licitud i validar la font de cada resultat.

La Context API admet diversos formats

Els agents poden iniciar una sol·licitud proporcionant una llista d’URL i especificant els formats de sortida. L’API retorna un resultat per a cada URL en el mateix ordre.

La Context API admet diversos formats de resposta:

  • Markdown: El contingut de la pàgina en Markdown net, a punt per incloure’l en el context d’un model.
  • HTML: L’HTML de la pàgina, per a aplicacions que fan la seva pròpia anàlisi.
  • Enllaços: Els enllaços de la pàgina com a URL absolutes, sense duplicats i en l’ordre de la pàgina, perquè un agent pugui decidir on anar a continuació.
  • Fragments: Els passatges de la pàgina més rellevants per a la consulta proporcionada, dins del límit de tokens que el desenvolupador estableix per a cada pàgina.

La Context API selecciona de cada pàgina els passatges rellevants per a la consulta, en lloc de generar-ne un resum. Així, el model rep la redacció original de la pàgina, però només els passatges seleccionats, de manera que hi ha menys text per processar.

Cada resultat correcte també inclou metadades com ara el títol, la descripció, l’idioma, l’autor i la data de publicació, a més de les etiquetes Open Graph de la pàgina. Per generar el Markdown, la Context API divideix la pàgina en blocs i un model classifica cada bloc com a contingut principal o com a contingut accessori. Només es conserven els blocs de contingut.

Essencial per a tasques que necessiten la visió completa

Trobar una pàgina rellevant no sempre és suficient per completar una feina. Amb la Context API, els agents poden recuperar el contingut que necessiten d’URL seleccionades per completar tasques complexes.

  • Implementar una integració d’API: Un resultat de cerca pot identificar la documentació adequada sense incloure els paràmetres necessaris, les instruccions d’autenticació ni els casos d’error. La Context API pot ajudar un agent de programació a recuperar la documentació i les referències de l’API per escriure una integració basada en aquests detalls.
  • Comparar preus actuals: Un preu publicat pot dependre de límits d’ús, condicions de facturació o requisits d’elegibilitat que no apareixen en un extracte de cerca. Un agent pot sol·licitar l’obtenció en directe de les pàgines de preus seleccionades i llegir aquestes condicions abans de fer una comparació.
  • Respondre preguntes sobre polítiques: Un extracte d’una política de devolucions pot indicar el termini de devolució estàndard però ometre les excepcions per a determinats productes o regions. Un agent d’assistència pot recuperar la pàgina de la política perquè la seva resposta tingui en compte aquestes excepcions.
  • Investigar en diverses fonts: Un extracte de cerca pot mostrar una conclusió sense la metodologia, els matisos ni l’argumentació que l’envolta. Un agent d’investigació pot recuperar els articles i informes seleccionats i després comparar les proves en lloc de basar-se només en extractes.

Control de l’actualitat i gestió fiable de les URL

Per defecte, la Context API primer comprova si l’índex web de Perplexity té una còpia de la pàgina obtinguda en els darrers dos dies. Si no n’hi ha cap, obté la pàgina en directe. Els desenvolupadors poden establir max_age_seconds en 0 per llegir sempre les pàgines en directe, per a preus, resultats esportius i notícies d’última hora. Per a material de referència que canvia poc, poden augmentar-lo. Establiu cache_only en true per a les càrregues de treball que no hagin d’activar mai cap sol·licitud en directe.

Cada resultat registra si el contingut prové d’una còpia emmagatzemada o d’una obtenció en directe, i quan es va obtenir.

Les URL d’una sol·licitud s’obtenen en paral·lel, cadascuna amb el seu propi límit de temps i el seu propi estat. Una pàgina lenta o que no funciona no fa fallar les altres. L’estat indica què ha passat amb cada URL, de manera que un agent pot tornar a intentar només les pàgines que han esgotat el temps d’espera i conservar la resta.

La Context API retorna contingut utilitzable i complet

Hem comparat la Context API amb Firecrawl, Exa, Parallel, Keenable i Context.dev en 1.000 URL extretes de sol·licituds d’obtenció reals d’agents. El conjunt abasta 715 llocs web i inclou fonts governamentals i acadèmiques, així com pàgines en idiomes diferents de l’anglès. Després, un model avaluador independent ha puntuat els resultats sense saber quin proveïdor havia generat cadascun.

El gràfic mesura el rendiment segons tres criteris:

  • Contingut utilitzable: La proporció d’URL que han retornat el contingut real de la pàgina, i no una pàgina d’error o un resultat buit.
  • Recuperació de fets: L’avaluador recull els fets clau trobats en una pàgina entre tots els proveïdors i després comprova quins conté cada resultat. Una obtenció fallida puntua zero.
  • Precisió del contingut: la proporció del text retornat que és contingut de la pàgina, i no avisos de galetes, navegació o anuncis, calculada com a mitjana de tots els URL. Una obtenció fallida puntua zero.

En aquesta avaluació, la Context API va retornar contingut utilitzable per al 92,3 % dels URL, va recuperar el 87,9 % dels fets clau i va obtenir una precisió del 80,3 % en la mètrica de precisió del contingut.

Preus

La Context API costa 1 $ per cada 1.000 URL obtingudes. Els desenvolupadors paguen per cada URL que retorna ok. Les URL que fallen no es facturen.

Primers passos

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

Cada resultat inclou el Markdown de la pàgina, els passatges que coincideixen amb la consulta, les metadades de la pàgina i un estat. Comproveu l’estat de cada resultat abans d’utilitzar-ne el contingut.

Llegiu la documentació de la Context API o consulteu la referència de l’API.

  1. Orchestrator: una API per a una inferència fiableDesenvolupadors17 de nov. del 2026
  2. Presentem la Monitor API de PerplexityDesenvolupadors16 de nov. del 2026