Présentation de la Monitor API de Perplexity

Suivez l’évolution du Web et les modifications de pages avec la Monitor API de Perplexity. Recevez les mises à jour pertinentes au moyen d’un webhook.

Monitor API illustration with orange light beams and dotted patterns on a dark background.

Le Web change à chaque seconde. Les applications ou les agents qui interrogent l’information sur le Web doivent savoir quand et comment elle a changé. Un agent de ventes doit savoir quand un compte annonce un financement. Un agent de codage a besoin d’une alerte lorsqu’une API publie un changement incompatible. Une équipe produit doit suivre les modifications apportées à la page de tarification d’un concurrent.

La plupart des équipes assurent cette surveillance en exécutant des recherches planifiées et en maintenant du code personnalisé pour éliminer les doublons et repérer les changements. Cela fonctionne pour quelques requêtes, mais devient plus difficile à maintenir à l’échelle de centaines de sujets et de pages.

Aujourd’hui, nous lançons la Monitor API pour gérer la surveillance du Web à grande échelle. Monitor peut surveiller l’ensemble du Web pour repérer les nouveaux développements sur un sujet, ou suivre les modifications apportées à une page précise. Il effectue ses vérifications selon un horaire et envoie un webhook lorsqu’il trouve une mise à jour pertinente.

Une surveillance adaptée à divers cas d’utilisation et secteurs

Les développeurs peuvent définir et créer un moniteur en langage courant. Chaque moniteur comporte une requête de recherche ou une liste de pages, ainsi qu’un objectif facultatif qui peut être précisé en langage courant. L’exemple ci-dessous montre comment détecter de nouvelles rondes de financement dans le secteur de l’infrastructure d’IA, dans le but de repérer les entreprises qui ont obtenu un financement de série A ou B.

Monitor prend en charge à la fois la surveillance de sujets généraux et les vérifications de pages précises. Le mode dépend de la nécessité, pour une application, de découvrir de nouvelles informations sur le Web ou de suivre une source connue :

  • Surveiller le Web : Suivez les nouveaux développements concernant un sujet, une entreprise ou une question. Monitor exécute la requête au moyen de Perplexity Search dans les résultats Web et les actualités.
  • Surveiller des pages : Suivez les modifications apportées à un maximum de 10 pages précises, comme une page de tarification, un journal des modifications ou une page de politique. La vérification initiale enregistre un état de référence. Les exécutions suivantes renvoient un diff textuel de ce qui a changé.

Perplexity Decider vérifie chaque résultat en fonction d’un objectif donné. Les résultats de Web Monitor doivent réussir les quatre vérifications suivantes : pertinence, légitimité de la source, nouveauté de l’information et fraîcheur. Pour les modifications détectées par Page Monitor, Decider vérifie si la modification est significative par rapport à l’objectif.

Une mise à jour n’est envoyée que si chaque vérification atteint son seuil, et chaque mise à jour comprend un score de confiance. Les seuils sont réglables pour chaque vérification. Les développeurs peuvent aussi mettre à jour l’objectif sans recréer le moniteur. Les développeurs peuvent modifier en tout temps ce qui est considéré comme pertinent en mettant à jour l’objectif, sans recréer le moniteur.

Planification et livraison flexibles

Les moniteurs s’exécutent à intervalle fixe, par exemple toutes les 15 minutes, toutes les heures, chaque jour ou chaque semaine, ou selon un horaire cron personnalisé. Chaque exécution reprend là où la précédente s’est terminée, et Monitor gère la déduplication des résultats d’une exécution à l’autre.

Les mises à jour pertinentes sont livrées au moyen de webhooks signés, avec de nouvelles tentatives automatiques en cas d’échecs de livraison temporaires. Ces webhooks peuvent déclencher des flux de travail d’agents, par exemple faire des recherches sur un compte après une annonce de financement ou recommander des modifications de prix après une mise à jour d’un concurrent. Les moniteurs peuvent aussi vous aviser lorsqu’ils sont mis en pause automatiquement.

Mettez en pause, reprenez ou exécutez des moniteurs sur demande, depuis l’API ou l’API Console.

Plus de résultats récents et pertinents

Nous avons comparé Monitor à des fournisseurs d’API de recherche sur 60 sujets tirés de requêtes réelles de la Search API en production, notamment des nouvelles d’entreprises, des lancements technologiques et de la réglementation. Chaque moniteur a surveillé les nouvelles informations sur son sujet pendant huit heures. Un modèle distinct a ensuite vérifié la pertinence des résultats et le moment de leur publication.

Dans cette évaluation, Perplexity a fourni le plus grand nombre de résultats récents et pertinents, sur l’éventail de sujets le plus large. Bon nombre de ces résultats n’ont été renvoyés par aucun autre fournisseur.

Monitor s’adapte à différents secteurs

Monitor aide les équipes à créer des applications et des agents qui agissent en fonction des nouvelles informations. Voici quelques cas d’utilisation en production :

  • Ingénierie GTM : Surveillez les annonces de financement, les embauches de cadres et les lancements de produits pour déclencher des recherches sur les comptes, des mises à jour du CRM et une prospection au moment opportun grâce à des flux de travail d’agents connectés.
  • Recherche sur les actions : Suivez les publications de résultats, les changements de prévisions, les annonces d’acquisition et les mentions négatives dans les médias afin de résumer les développements et de signaler les répercussions possibles sur la thèse d’investissement d’un analyste.
  • Veille concurrentielle : Gardez un œil sur les activités des concurrents en matière de prix, de lancements de produits et de journaux des modifications afin de signaler les changements et de mettre à jour les synthèses concurrentielles.
  • Surveillance réglementaire : Surveillez les annonces et les pages d’orientation des organismes de réglementation afin que les agents puissent résumer les changements et les acheminer aux équipes de conformité pour examen.

Tarification et disponibilité

Les moniteurs Web coûtent 1 $ par tranche de 1 000 exécutions réussies. Les moniteurs de pages coûtent 1 $ par tranche de 1 000 URL récupérées, puisqu’une seule exécution peut récupérer de nombreuses pages. Une exécution correspond à une vérification planifiée ou sur demande.

La Monitor API est offerte dès aujourd’hui au moyen de l’API et de l’API Console, avec la même clé d’API que Search, Context et Agent API.

Premiers pas

Shell
text
curl --request POST https://api.perplexity.ai/v1/monitors \ --header "Authorization: Bearer $PERPLEXITY_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "name": "AI infra funding", "targets": [ {"type": "search", "query": "AI infrastructure funding rounds"} ], "goal": "New Series A or B announcements", "schedule": {"type": "interval", "interval": "1d"}, "webhook": {"url": "https://agent.example.com/hooks"} }'

Chaque exécution qui trouve des mises à jour pertinentes les envoie à votre webhook : de nouveaux résultats avec un titre, un extrait et un score de confiance, ou un diff textuel pour les modifications de pages. Ajoutez des métadonnées pour acheminer chaque mise à jour vers le bon utilisateur, le bon espace de travail ou le bon agent.

Consultez la documentation de la Monitor API ou créez un moniteur dans l’API Console.