Présentation du Agent SDK

Le Agent SDK de Cursor est un framework destiné à coder, tester et déployer des agents capables d’intervenir automatiquement sur les événements du cycle de vie logiciel (pull‑request, conformité, incident). Il se veut une alternative aux solutions propriétaires qui imposent leurs propres flux, en offrant aux équipes la possibilité de définir leurs propres règles dans du code.

Architecture et mécanismes d'exécution

Chaque agent est structuré comme un petit projet Node.js. Les fonctions d'outils sont écrites en TypeScript, tandis que les prompts sont stockés en Markdown, ce qui permet de versionner l’ensemble dans le même dépôt Git que le reste du code. Au moment du déploiement, le SDK compile le projet, génère une URL unique et lance l'agent comme un single Node process pouvant être empaqueté dans un conteneur Docker. Cette approche garantit une isolation simple mais impose que la scalabilité repose sur la réplication du conteneur.

import { homedir } from "node:os";
import { join } from "node:path";
import { defineAgent } from "@cursor/agent-sdk";
export default defineAgent({
  name: "Robo",
  model: {
    id: "composer-2.5",
    params: [
      { id: "effort", value: "high" },
      { id: "fast", value: "true" },
    ],
  },
  local: { cwd: join(homedir(), ".cache", "factory", "robo") },
});

Processus de développement et validation

L’SDK intègre nativement des evals et la relecture d’événements. Ces outils permettent de reproduire les flux réels (ex. webhook GitHub) et de vérifier que l’agent réagit conformément aux politiques définies, avant toute mise en production. Le projet de la PGA Tour, cité comme cas d’usage, utilise ces evals pour itérer rapidement sur chaque composant de leur « software factory ». Le fait que chaque modification passe par le même pipeline de revue que le code applicatif renforce la traçabilité et la conformité.

Déploiement et scénarios d'usage

Le déploiement s’effectue avec une seule commande : agent-sdk deploy. La commande compile le code, crée l’URL d’accès et démarre l’agent sur l’infrastructure de Cursor, tout en offrant une interface de gestion des secrets et des intégrations via le tableau de bord. Les équipes peuvent toutefois choisir l’auto‑hébergement : chaque agent fonctionne comme un processus Node unique, compatible avec les orchestrateurs de conteneurs classiques (Kubernetes, Docker Swarm). Parmi les exemples concrets, le kb‑reviewer a été développé en une journée pour comparer chaque PR à une base de connaissances interne, et le Security Reviewer s’appuie sur les mêmes primitives pour appliquer des politiques de sécurité sur GitHub, GitLab ou Bitbucket.