Context API extrait le contexte complet de n’importe quelle page Web
Utilisez Perplexity Context API pour fournir aux agents d’IA du Markdown propre, des liens et des passages pertinents provenant de pages Web en cache ou en direct.

Lorsqu’une personne pose une question à un robot conversationnel, un agent d’IA peut avoir besoin de lire plusieurs pages Web pour y répondre. Les résultats de recherche standards ne renvoient souvent que des extraits. Récupérer une page directement peut renvoyer du HTML brut, rempli de menus de navigation, de bandeaux de témoins et de publicités. Les agents ont besoin du contexte de la page dans un format exploitable par un modèle, tandis que les développeurs ont besoin d’un moyen de contrôler le degré de fraîcheur requis pour ce contexte.
Nous lançons aujourd’hui Perplexity Context API, qui lit jusqu’à 10 URL et renvoie, pour chaque page, du Markdown propre, du HTML, des liens et des extraits basés sur une requête. Les informations proviennent du vaste index Web de Perplexity ou d’une récupération en direct. Les agents peuvent préciser la fraîcheur de chaque requête et valider la source de chaque résultat.
Context API prend en charge divers formats
Les agents peuvent lancer une requête en fournissant une liste d’URL et en précisant les formats de sortie. L’API renvoie un résultat pour chaque URL, dans le même ordre.
Context API prend en charge divers formats de réponse :
- Markdown : Le contenu de la page en Markdown propre, prêt à être intégré au contexte d’un modèle.
- HTML : Le code HTML de la page, pour les applications qui effectuent leur propre analyse syntaxique.
- Liens : Les liens de la page sous forme d’URL absolues, sans doublons et dans l’ordre de la page, afin qu’un agent puisse décider où aller ensuite.
- Extraits : Les passages de la page les plus pertinents pour une requête fournie, dans la limite de jetons fixée par le développeur pour chaque page.
Context API sélectionne dans chaque page les passages pertinents pour la requête, plutôt que de générer un résumé. Ainsi, le modèle reçoit le libellé original de la page, mais uniquement les passages sélectionnés, ce qui réduit la quantité de texte à traiter.
Chaque résultat réussi comprend aussi des métadonnées comme le titre, la description, la langue, l’auteur et la date de publication, ainsi que les balises Open Graph de la page. Pour générer le Markdown, Context API divise la page en blocs, et un modèle évalue chaque bloc pour déterminer s’il s’agit de contenu principal ou de texte passe-partout. Seuls les blocs de contenu sont conservés.
Essentiel pour les tâches qui exigent une vue d’ensemble
Trouver une page pertinente ne suffit pas toujours pour mener une tâche à bien. Grâce à Context API, les agents peuvent récupérer le contenu dont ils ont besoin à partir d’URL sélectionnées pour accomplir des tâches complexes.
- Mettre en œuvre une intégration d’API : Un résultat de recherche peut indiquer la bonne documentation sans inclure les paramètres requis, les instructions d’authentification ni les cas d’erreur. Context API peut aider un agent de programmation à récupérer la documentation et les références de l’API afin d’écrire une intégration fondée sur ces détails.
- Comparer les prix actuels : Un prix affiché peut dépendre de limites d’utilisation, de modalités de facturation ou de conditions d’admissibilité absentes d’un extrait de recherche. Un agent peut demander une récupération en direct de certaines pages de tarification et lire ces conditions avant d’établir une comparaison.
- Répondre aux questions sur les politiques : Un extrait d’une politique de retour peut indiquer le délai de retour standard, mais omettre les exceptions visant certains produits ou certaines régions. Un agent de soutien peut récupérer la page de la politique afin que sa réponse tienne compte de ces exceptions.
- Effectuer des recherches dans plusieurs sources : Un extrait de recherche peut faire ressortir une conclusion sans la méthodologie, les réserves ni l’argumentation qui l’entourent. Un agent de recherche peut récupérer les articles et les rapports sélectionnés, puis comparer les données probantes plutôt que de se fier uniquement aux extraits.
Contrôlez la fraîcheur et gérez les URL de manière fiable
Par défaut, Context API vérifie d’abord si l’index Web de Perplexity contient une copie de la page récupérée au cours des deux derniers jours. Si ce n’est pas le cas, l’API récupère la page en direct. Les développeurs peuvent définir max_age_seconds sur 0 pour toujours lire les pages en direct, notamment pour les prix, les résultats sportifs et les dernières nouvelles. Pour les documents de référence qui changent rarement, ils peuvent augmenter cette valeur. Définissez cache_only sur true pour les charges de travail qui ne doivent jamais déclencher de requête en direct.
Chaque résultat indique si le contenu provient d’une copie stockée ou d’une récupération en direct, ainsi que le moment où il a été récupéré.
Les URL d’une requête sont récupérées en parallèle, chacune avec son propre délai et son propre statut. Une page lente ou défectueuse ne fait pas échouer les autres. Le statut indique ce qui s’est passé pour chaque URL, de sorte qu’un agent peut relancer uniquement les pages qui ont dépassé le délai et conserver les autres.
Context API renvoie un contenu exploitable et complet
Nous avons comparé Context API à Firecrawl, Exa, Parallel, Keenable et Context.dev sur 1 000 URL échantillonnées à partir de véritables requêtes de récupération d’agents. L’ensemble couvre 715 sites et comprend des sources gouvernementales et universitaires ainsi que des pages dans d’autres langues que l’anglais. Un modèle évaluateur distinct a ensuite noté les résultats sans savoir quel fournisseur avait produit chacun d’eux.
Le graphique mesure la performance selon trois critères :
- Exploitable : La proportion d’URL pour lesquelles le contenu réel de la page a été renvoyé, plutôt qu’une page d’erreur ou un résultat vide.
- Rappel des faits : L’évaluateur recueille les faits clés trouvés sur une page auprès de l’ensemble des fournisseurs, puis vérifie lesquels figurent dans chaque résultat. Une récupération échouée obtient un score de zéro.
- Précision du contenu : la proportion du texte renvoyé qui correspond au contenu de la page, et non à des avis sur les témoins, à des éléments de navigation ou à des publicités, en moyenne sur l’ensemble des URL. Une récupération qui échoue obtient un score de zéro.
Dans cette évaluation, la Context API a renvoyé du contenu exploitable pour 92,3 % des URL, a récupéré 87,9 % des faits clés et a obtenu un score de 80,3 % en précision du contenu.
Tarification
Context API coûte 1 $ par tranche de 1 000 URL récupérées. Les développeurs paient pour chaque URL qui renvoie le statut ok. Les URL en échec ne sont pas facturées.
Pour commencer
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"]
}'Chaque résultat est renvoyé avec le Markdown de la page, les passages qui correspondent à la requête, les métadonnées de la page et un statut. Vérifiez le statut de chaque résultat avant d’utiliser son contenu.
Consultez la documentation de Context API ou la référence de l’API.