A Context API extrae o contexto completo de calquera páxina web

Usa a Perplexity Context API para proporcionarlles aos axentes de IA Markdown limpo, ligazóns e pasaxes relevantes de páxinas web en caché ou en directo.

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

Cando alguén lle fai unha pregunta a un chatbot, un axente de IA pode ter que ler varias páxinas web para respondela. Os resultados de busca estándar adoitan devolver só fragmentos. Obter unha páxina directamente pode devolver HTML en bruto, cheo de navegación, avisos de cookies e anuncios. Os axentes necesitan o contexto da páxina nun formato que poida usar un modelo, mentres que os desenvolvedores necesitan un xeito de controlar canto de recente debe ser ese contexto.

Hoxe lanzamos a Perplexity Context API, que le ata 10 URL e devolve Markdown limpo, HTML, ligazóns e fragmentos baseados en consultas para cada páxina. A información procede do amplo índice web de Perplexity ou dunha obtención en directo. Os axentes poden especificar a actualidade de cada solicitude e validar a orixe de cada resultado.

A Context API admite diversos formatos

Os axentes poden iniciar unha solicitude proporcionando unha lista de URL e especificando os formatos de saída. A API devolve un resultado para cada URL na mesma orde.

A Context API admite diversos formatos de resposta:

  • Markdown: O contido da páxina en Markdown limpo, listo para incorporar ao contexto dun modelo.
  • HTML: O HTML da páxina, para aplicacións que realizan a súa propia análise.
  • Ligazóns: As ligazóns da páxina como URL absolutos, sen duplicados e na orde da páxina, para que un axente poida decidir onde ir despois.
  • Fragmentos: As pasaxes da páxina máis relevantes para a consulta proporcionada, dentro do límite de tokens establecido polo desenvolvedor para cada páxina.

A Context API selecciona de cada páxina as pasaxes relevantes para a consulta, en lugar de xerar un resumo. Deste xeito, o modelo recibe a redacción orixinal da páxina, pero só as pasaxes seleccionadas, polo que hai menos texto que procesar.

Cada resultado satisfactorio tamén inclúe metadatos como o título, a descrición, o idioma, o autor e a data de publicación, ademais das etiquetas Open Graph da páxina. Para construír o Markdown, a Context API divide a páxina en bloques e un modelo clasifica cada bloque como contido principal ou texto de recheo. Só se conservan os bloques de contido.

Esencial para tarefas que necesitan a visión completa

Atopar unha páxina relevante non sempre abonda para completar un traballo. Coa Context API, os axentes poden recuperar o contido que necesitan dos URL seleccionados para completar tarefas complexas.

  • Implementar unha integración de API: Un resultado de busca pode identificar a documentación correcta sen incluír os parámetros necesarios, as instrucións de autenticación nin os casos de erro. A Context API pode axudar a un axente de programación a recuperar a documentación e as referencias da API para escribir unha integración baseada neses detalles.
  • Comparar prezos actuais: Un prezo publicado pode depender de límites de uso, condicións de facturación ou requisitos de elixibilidade que non aparecen nun fragmento de busca. Un axente pode solicitar unha obtención en directo das páxinas de prezos seleccionadas e ler esas condicións antes de facer unha comparación.
  • Responder preguntas sobre políticas: Un fragmento dunha política de devolucións pode indicar o prazo de devolución estándar pero omitir as excepcións para determinados produtos ou rexións. Un axente de asistencia pode recuperar a páxina da política para que a súa resposta teña en conta esas excepcións.
  • Investigar en varias fontes: Un fragmento de busca pode mostrar un achado sen a metodoloxía, os matices nin a argumentación que o rodea. Un axente de investigación pode recuperar os artigos e informes seleccionados e despois comparar as probas en lugar de depender só de fragmentos.

Control da actualidade e xestión fiable dos URL

De forma predeterminada, a Context API comproba primeiro se o índice web de Perplexity ten unha copia da páxina obtida nos últimos dous días. Se non a hai, obtén a páxina en directo. Os desenvolvedores poden cambiar max_age_seconds a 0 para ler sempre as páxinas en directo, no caso de prezos, marcadores e noticias de última hora. Para material de referencia que cambia poucas veces, poden aumentalo. Establece cache_only en true para cargas de traballo que nunca deban activar unha solicitude en directo.

Cada resultado rexistra se o contido procede dunha copia almacenada ou dunha obtención en directo, e cando se obtivo.

Os URL dunha solicitude obtéñense en paralelo, cada un co seu propio tempo límite e o seu propio estado. Unha páxina lenta ou rota non fai fallar as demais. O estado indica que pasou con cada URL, para que un axente poida reintentar só as páxinas que esgotaron o tempo de espera e conservar o resto.

A Context API devolve contido utilizable e completo

Probamos a Context API fronte a Firecrawl, Exa, Parallel, Keenable e Context.dev con 1000 URL tomados como mostra de solicitudes de obtención reais de axentes. O conxunto abrangue 715 sitios e inclúe fontes gobernamentais e académicas, así como páxinas en idiomas distintos do inglés. Despois, un modelo xuíz independente puntuou os resultados sen saber que provedor xerara cada un.

O gráfico mide o rendemento segundo tres criterios:

  • Utilizable: A proporción de URL que devolveron o contido real da páxina, e non unha páxina de erro ou un resultado baleiro.
  • Recuperación de feitos: O xuíz recompila os feitos clave atopados nunha páxina en todos os provedores e despois comproba cales deles contén cada resultado. Unha obtención fallida puntúa cero.
  • Precisión do contido: a proporción do texto devolto que é contido da páxina, e non avisos de cookies, navegación ou anuncios, calculada como media de todos os URL. Unha recuperación fallida puntúa cero.

Nesta avaliación, a Context API devolveu contido utilizable para o 92,3 % dos URL, recuperou o 87,9 % dos datos clave e obtivo un 80,3 % en precisión do contido.

Prezos

A Context API custa 1 $ por cada 1000 URL obtidos. Os desenvolvedores pagan por cada URL que devolve ok. Os URL que fallan non se facturan.

Primeiros pasos

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 resultado inclúe o Markdown da páxina, as pasaxes que coinciden coa consulta, os metadatos da páxina e un estado. Comproba o estado de cada resultado antes de usar o seu contido.

Le a documentación da Context API ou consulta a referencia da API.

  1. Orchestrator: unha API para unha inferencia fiableDesenvolvedoresNov 17, 2026
  2. Presentamos a Monitor API de PerplexityDesenvolvedoresNov 16, 2026