Context API extrae el contexto completo de cualquier página web
Usa Perplexity Context API para proporcionar a los agentes de IA Markdown limpio, enlaces y pasajes relevantes de páginas web en caché o en tiempo real.

Cuando alguien le hace una pregunta a un chatbot, es posible que un agente de IA tenga que leer varias páginas web para responderla. Los resultados de búsqueda estándar suelen devolver solo fragmentos. Obtener una página directamente puede devolver HTML sin procesar, lleno de menús de navegación, banners de cookies y anuncios. Los agentes necesitan el contexto de la página en un formato que un modelo pueda usar, mientras que los desarrolladores necesitan una forma de controlar lo actualizado que debe estar ese contexto.
Hoy lanzamos Perplexity Context API, que lee hasta 10 URL y devuelve, para cada página, Markdown limpio, HTML, enlaces y fragmentos basados en la consulta. La información procede del amplio índice web de Perplexity o de una obtención en tiempo real. Los agentes pueden especificar el grado de actualidad de cada solicitud y validar la fuente de cada resultado.
Context API admite diversos formatos
Los agentes pueden iniciar una solicitud proporcionando una lista de URL y especificando los formatos de salida. La API devuelve un resultado por cada URL en el mismo orden.
Context API admite diversos formatos de respuesta:
- Markdown: el contenido de la página en Markdown limpio, listo para incorporarlo al contexto de un modelo.
- HTML: el HTML de la página, para aplicaciones que realizan su propio análisis.
- Enlaces: los enlaces de la página como URL absolutas, sin duplicados y en el orden en que aparecen en la página, para que un agente pueda decidir adónde ir a continuación.
- Fragmentos: los pasajes de la página más relevantes para una consulta proporcionada, dentro del límite de tokens que el desarrollador establezca para cada página.
Context API selecciona de cada página los pasajes relevantes para la consulta, en lugar de generar un resumen. Así, el modelo recibe la redacción original de la página, pero solo los pasajes seleccionados, por lo que hay menos texto que procesar.
Cada resultado correcto también incluye metadatos como el título, la descripción, el idioma, el autor y la fecha de publicación, además de las etiquetas Open Graph de la página. Para generar el Markdown, Context API divide la página en bloques y un modelo clasifica cada bloque como contenido principal o texto repetitivo. Solo se conservan los bloques de contenido.
Imprescindible para tareas que requieren una visión completa
Encontrar una página relevante no siempre basta para completar un trabajo. Con Context API, los agentes pueden recuperar el contenido que necesitan de determinadas URL para completar tareas complejas.
- Implementar una integración de API: un resultado de búsqueda puede identificar la documentación adecuada sin incluir los parámetros necesarios, las instrucciones de autenticación ni los casos de error. Context API puede ayudar a un agente de programación a recuperar la documentación y las referencias de la API para escribir una integración basada en esos detalles.
- Comparar precios actuales: un precio publicado puede depender de límites de uso, condiciones de facturación o requisitos de elegibilidad que no aparecen en un extracto de búsqueda. Un agente puede solicitar la obtención en tiempo real de determinadas páginas de precios y leer esas condiciones antes de hacer una comparación.
- Responder preguntas sobre políticas: un extracto de una política de devoluciones puede indicar el plazo de devolución estándar, pero omitir las excepciones para determinados productos o regiones. Un agente de soporte puede recuperar la página de la política para que su respuesta tenga en cuenta esas excepciones.
- Investigar en múltiples fuentes: un extracto de búsqueda puede mostrar un hallazgo sin la metodología, los matices ni el razonamiento que lo acompaña. Un agente de investigación puede recuperar los artículos e informes seleccionados y luego comparar las pruebas en lugar de basarse solo en extractos.
Controla el grado de actualidad y gestiona las URL de forma fiable
De forma predeterminada, la Context API comprueba primero si el índice web de Perplexity contiene una copia de la página obtenida en los últimos dos días. Si no la hay, obtiene la página en tiempo real. Los desarrolladores pueden establecer max_age_seconds en 0 para leer siempre las páginas en tiempo real, en el caso de precios, resultados deportivos y noticias de última hora. Para material de referencia que rara vez cambia, pueden aumentarlo. Establece cache_only en true para las cargas de trabajo que nunca deban activar una solicitud en tiempo real.
Cada resultado registra si el contenido procede de una copia almacenada o de una obtención en tiempo real, y cuándo se obtuvo.
Las URL de una solicitud se obtienen en paralelo, cada una con su propio límite de tiempo y su propio estado. Una página lenta o rota no hace fallar a las demás. El estado indica qué ha ocurrido con cada URL, de modo que un agente puede reintentar solo las páginas que agotaron el tiempo de espera y conservar el resto.
Context API devuelve contenido utilizable y completo
Comparamos Context API con Firecrawl, Exa, Parallel, Keenable y Context.dev en 1000 URL tomadas como muestra de solicitudes de obtención reales realizadas por agentes. El conjunto abarca 715 sitios e incluye fuentes gubernamentales y académicas, así como páginas en idiomas distintos del inglés. Después, un modelo evaluador independiente puntuó los resultados sin saber qué proveedor había generado cada uno.
El gráfico mide el rendimiento según tres criterios:
- Utilizable: el porcentaje de URL que devolvieron el contenido real de la página, y no una página de error o un resultado vacío.
- Recuperación de datos: el evaluador recopila los datos clave encontrados en una página entre todos los proveedores y, a continuación, comprueba cuáles contiene cada resultado. Una obtención fallida puntúa cero.
- Precisión del contenido: La proporción del texto devuelto que corresponde al contenido de la página, y no a avisos de cookies, elementos de navegación o anuncios, promediada entre todas las URL. Una recuperación fallida puntúa cero.
En esta evaluación, la Context API devolvió contenido utilizable para el 92,3 % de las URL, recuperó el 87,9 % de los datos clave y obtuvo una precisión del contenido del 80,3 %.
Precios
Context API cuesta 1 USD por cada 1000 URL obtenidas. Los desarrolladores pagan por cada URL que devuelve ok. Las URL que fallan no se facturan.
Primeros pasos
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 incluye el Markdown de la página, los pasajes que coinciden con la consulta, los metadatos de la página y un estado. Comprueba el estado de cada resultado antes de usar su contenido.
Lee la documentación de Context API o consulta la referencia de la API.