Présentation de l’API Monitor de Perplexity

Suivez les évolutions du web et les modifications de pages avec l’API Monitor de Perplexity. Recevez les mises à jour pertinentes via 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 des informations sur le web doivent savoir quand et comment elles ont changé. Un agent commercial doit savoir quand un compte annonce une levée de fonds. Un agent de programmation a besoin d’une alerte lorsqu’une API publie une modification incompatible. Une équipe produit doit suivre les changements apportés à la page de tarifs d’un concurrent.

La plupart des équipes assurent cette surveillance en exécutant des recherches planifiées et en maintenant du code personnalisé pour supprimer les doublons et identifier 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 l’API Monitor pour assurer la surveillance du web à grande échelle. Monitor peut surveiller l’ensemble du web pour repérer les nouveautés sur un sujet ou suivre les modifications d’une page précise. Il effectue des vérifications selon une planification et envoie un webhook lorsqu’il trouve une mise à jour pertinente.

Une surveillance pour tous les cas d’usage et tous les secteurs

Les développeurs peuvent définir et créer un moniteur en langage naturel. Chaque moniteur comporte une requête de recherche ou une liste de pages, ainsi qu’un objectif facultatif qui peut être formulé en langage naturel. L’exemple ci-dessous montre comment détecter de nouveaux tours de financement dans le secteur des infrastructures d’IA, avec pour objectif d’identifier les entreprises ayant levé des fonds de série A ou B.

Monitor prend en charge à la fois la surveillance de sujets larges et la vérification 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 nouveautés sur un sujet, une entreprise ou une question. Monitor exécute la requête via Perplexity Search sur les résultats web et d’actualités.
  • Surveiller des pages : Suivez les modifications apportées à 10 pages spécifiées au maximum, comme une page de tarifs, un journal des modifications ou une page de politique. La vérification initiale enregistre une référence. Les exécutions suivantes renvoient un diff textuel de ce qui a changé.

Perplexity Decider vérifie chaque résultat par rapport à un objectif donné. Les résultats de Web Monitor doivent passer les quatre vérifications suivantes : pertinence, légitimité de la source, nouveauté de l’information et fraîcheur. Pour les modifications de Page Monitor, Decider vérifie si la modification est significative au regard de 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 également mettre à jour l’objectif sans recréer le moniteur. Les développeurs peuvent modifier à tout moment 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, tous les jours ou toutes les semaines, ou selon une planification cron personnalisée. Chaque exécution reprend là où la précédente s’est arrêtée, et Monitor gère la déduplication des résultats d’une exécution à l’autre.

Les mises à jour pertinentes sont envoyées via des webhooks signés, avec de nouvelles tentatives automatiques en cas d’échec temporaire de livraison. Ces webhooks peuvent déclencher des flux de travail d’agents, par exemple pour analyser un compte après l’annonce d’une levée de fonds ou recommander des modifications de tarifs après une mise à jour d’un concurrent. Les moniteurs peuvent également vous avertir lorsqu’ils sont automatiquement mis en pause.

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

Des résultats plus récents et plus pertinents

Nous avons testé Monitor face à des fournisseurs d’API de recherche sur 60 sujets issus de requêtes de production de la Search API, notamment l’actualité des entreprises, les lancements technologiques et la réglementation. Chaque moniteur a surveillé les nouvelles informations sur son sujet pendant huit heures. Un modèle distinct a ensuite évalué les résultats en matière de pertinence et de date de 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 fonctionne dans 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’usage en production :

  • Ingénierie GTM : Surveillez les annonces de levées de fonds, les recrutements de dirigeants et les lancements de produits pour déclencher la recherche sur les comptes, les mises à jour du CRM et une prospection au bon moment grâce à des flux de travail d’agents connectés.
  • Recherche actions : Suivez les publications de résultats, les révisions de prévisions, les annonces d’acquisitions et les informations défavorables dans les médias, afin de résumer les évolutions et de signaler leurs implications potentielles pour la thèse d’investissement d’un analyste.
  • Veille concurrentielle : Suivez de près l’activité des concurrents en matière de tarifs, de lancements de produits et de journaux des modifications pour signaler les changements et mettre à jour les synthèses concurrentielles.
  • Veille réglementaire : Surveillez les annonces et les pages de lignes directrices des autorités de régulation afin que les agents puissent résumer les changements et les transmettre aux équipes de conformité pour examen.

Tarifs et disponibilité

Les moniteurs web coûtent 1 $ pour 1 000 exécutions réussies. Les moniteurs de pages coûtent 1 $ pour 1 000 URL récupérées, car une seule exécution peut récupérer de nombreuses pages. Une exécution correspond à une vérification planifiée ou à la demande.

L’API Monitor est disponible dès aujourd’hui via l’API et l’API Console, avec la même clé 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 l’API Monitor ou créez un moniteur dans l’API Console.