Un agent utile dans une équipe ne suit pas nécessairement les mêmes règles dans une autre. Les événements à surveiller, les outils autorisés et les critères de validation varient selon les projets. Avec son Agent SDK, Cursor propose de définir ces agents comme des projets logiciels, plutôt que de limiter leur comportement à une consigne isolée dans une conversation.
L’annonce du 20 octobre présente un SDK disponible généralement, utilisé également pour les agents gérés de Cursor. Les instructions, outils, connexions et évaluations sont organisés dans le code du projet. Le cadre prend en charge des événements, des évaluations et la relecture d’événements, avec un déploiement sur l’infrastructure Cursor ou sur celle de l’équipe. Ces possibilités décrivent le cadre fourni ; elles ne garantissent pas la fiabilité de tous les agents que l’on construira avec lui.
Une politique doit pouvoir être examinée
L’intérêt d’une définition dans un projet logiciel tient notamment à la traçabilité des changements. Une instruction modifiée, un nouvel outil ou une connexion ajoutée peuvent être relus et discutés dans le même cadre que les autres évolutions du projet.
Cela ne rend pas une politique correcte par magie. Il faut encore expliquer ce que l’agent doit faire et ce qui dépasse son périmètre. Les mots généraux comme « gérer », « vérifier » ou « améliorer » peuvent recouvrir des actions très différentes si l’équipe ne les précise pas.
Un bon point de départ consiste à choisir une tâche limitée et un résultat observable. La question ne sera alors pas seulement de savoir si l’agent répond, mais s’il respecte les règles et produit l’effet attendu dans les situations prévues.
Dans la présentation du SDK, les consignes sont écrites en Markdown et les outils définis par des fonctions TypeScript. Cette organisation rapproche la définition de l’agent des pratiques habituelles de versionnement et de revue employées pour les autres parties d’un projet logiciel.
Les évaluations font partie du produit
Cursor met en avant la prise en charge des évaluations et de la relecture d’événements. Ces mécanismes peuvent aider à comparer le comportement de l’agent lorsque son projet évolue. Ils demandent toutefois de disposer de cas représentatifs et de critères compréhensibles.
Notre dossier pour évaluer un assistant IA métier avec un jeu de questions donne une méthode pour dépasser la démonstration séduisante. Pour un agent qui agit, les tests doivent également examiner les outils appelés, les limites respectées et le résultat des actions, selon le périmètre choisi.
Il est utile d’inclure des situations incomplètes ou ambiguës. Une demande habituelle peut être bien traitée tandis qu’un événement inhabituel révèle un comportement indésirable. La qualité du système se mesure aussi à sa manière de demander une précision, de s’arrêter ou de laisser la décision à une personne.
Le lieu d’exécution change les responsabilités à organiser
Le SDK permet un déploiement sur l’infrastructure de Cursor ou un fonctionnement sur celle de l’équipe. Ce choix ne se résume pas à la facilité du lancement. Les accès, le suivi, les secrets et l’exploitation doivent être examinés dans l’environnement retenu.
Une tâche récurrente a besoin d’un responsable identifiable. Si elle échoue, produit un résultat inattendu ou rencontre un changement dans un service connecté, quelqu’un doit pouvoir comprendre ce qui s’est passé. Le simple fait que l’agent continue à fonctionner ne signifie pas que son résultat reste utile.
Les journaux et les outils de suivi doivent donc être pensés avec les usages. Ils doivent permettre d’examiner le comportement sans exposer inutilement des informations sensibles. Le bon niveau de détail dépend de la tâche et des contraintes de l’organisation.
Commencer petit permet de tester les limites.
Avant d’automatiser un processus entier, une équipe peut définir une première étape où le résultat sera relu. Cela permet de comparer les attentes et le comportement réel, puis d’ajuster les instructions et les évaluations à partir d’exemples concrets.
Il faut également prévoir les reprises et les exceptions. Que se passe-t-il si le même événement arrive deux fois, si une information manque ou si l’outil externe ne répond pas ? Ces questions appartiennent au projet dès le départ, pas seulement à une phase de dépannage après le lancement.
L’Agent SDK illustre ainsi une évolution des assistants vers des systèmes intégrés au travail des équipes. Le cadre donne des moyens de les construire et de les suivre. Leur valeur dépendra ensuite de la précision de la tâche, des limites définies et des preuves réunies sur leur comportement réel.
