node-sdk

Known Agents SDK est un client Node.js officiel pour interagir avec la plateforme Known Agents. Il permet aux applications serveur TypeScript ou JavaScript de collecter des analyses détaillées sur les agents IA et autres bots qui visitent un site ou appellent des points de terminaison Model Context Protocol (MCP). Fonctionnalités clés : * **Suivi des événements de visite** – Utilisez `trackPageviewOrRESTCall` dans un middleware pour enregistrer les pages vues ou les appels REST. Les événements sont mis en file d'attente et automatiquement vidés en fonction de la taille ou de l'intervalle de temps. * **Suivi des appels MCP** – Pour les services construits sur le Model Context Protocol, `trackMCPCall` enregistre la requête, la réponse et les détails de transport, en gérant automatiquement les interactions Agentic Commerce Protocol (ACP) et Universal Commerce Protocol (UCP). * **Support du commerce agentic** – Lors du traitement des réponses REST ACP ou UCP, incluez le corps de la réponse dans `trackPageviewOrRESTCall` pour capturer les données du flux d'achat. * **Génération automatique de robots.txt** – Appelez `generateRobotsTXT` avec une liste de valeurs `AgentType` pour obtenir un texte brut robots.txt qui bloque ou autorise certaines catégories de crawlers. Cette chaîne peut être régénérée selon un planning (par exemple, quotidiennement) et servie à `/robots.txt`. * **API d'identification des agents** – Identifiez et vérifiez les requêtes entrantes avec `identifyAgent` (requête unique) ou `identifyAgents` (lot). La réponse inclut le statut de vérification, les métadonnées de l'agent, les informations ASN et un score d'automatisation indiquant la probabilité que la requête soit automatisée. L'installation est simple via npm : `npm install @knownagents/sdk`. Après vous être inscrit sur knownagents.com et avoir obtenu un jeton d'accès, créez le client avec `new KnownAgents('YOUR_ACCESS_TOKEN')`. Une configuration optionnelle permet de définir `flushQueueSize` et `flushIntervalInMilliseconds` pour le lot d'événements. Le SDK nécessite TypeScript ≥ 4.7 et fonctionne sur Node.js 18 LTS ou supérieur. Pour de l'aide, ouvrez un problème sur le dépôt GitHub. Dans l'ensemble, la bibliothèque offre une solution complète côté serveur pour l'analyse des agents IA, la gestion du trafic des bots et la gestion automatisée des fichiers robots.txt, facilitant la surveillance et le contrôle des interactions pilotées par l'IA avec vos services web.