Avec les agents en arrière-plan, lance des agents asynchrones qui modifient et exécutent du code dans un environnement distant. Consulte leur état, envoie des relances, ou prends la main à tout moment.

​
Comment l’utiliser

Tu peux accéder aux agents en arrière-plan de deux façons :
  1. Barre latérale des agents en arrière-plan : utilise l’onglet des agents en arrière-plan dans la barre latérale native de Cursor pour voir tous les agents en arrière-plan associés à ton compte, rechercher des agents existants et en démarrer de nouveaux.
  2. Mode Agent en arrière-plan : appuie sur pour activer le mode agent en arrière-plan dans l’UI.
Après avoir envoyé un prompt, sélectionne ton agent dans la liste pour voir son statut et entrer dans la machine.

Les agents en arrière-plan nécessitent une conservation des données de l’ordre de quelques jours.

​
Configuration

Par défaut, les agents d’arrière-plan s’exécutent sur une machine isolée basée sur Ubuntu. Ils ont accès à Internet et peuvent installer des packages.

​
Connexion à GitHub

Les agents en arrière-plan clonent ton dépôt depuis GitHub et travaillent sur une branche dédiée, en poussant leurs changements vers ton dépôt pour un passage de relais fluide. Accorde des droits en lecture et en écriture à ton dépôt (ainsi qu’à tout dépôt dépendant ou sous-module). On prendra en charge d’autres fournisseurs (GitLab, Bitbucket, etc.) à l’avenir.
Configuration de la liste d’autorisation d’IP
Si ton organisation utilise la liste d’autorisation d’IP de GitHub, tu dois autoriser l’accès pour les agents en tâche de fond. Consulte la documentation d’intégration GitHub pour les instructions de configuration complètes, y compris les coordonnées et les adresses IP.

​
Configuration de l’environnement de base

Pour les cas avancés, configure toi-même l’environnement. Obtiens une instance d’IDE connectée à la machine distante. Configure ta machine, installe les outils et les packages, puis prends un snapshot. Configure les paramètres d’exécution :
  • La commande d’installation s’exécute avant le démarrage d’un agent et installe les dépendances d’exécution. Ça peut être npm install ou bazel build.
  • Les terminaux lancent des processus en arrière-plan pendant que l’agent travaille — par exemple démarrer un serveur web ou compiler des fichiers protobuf.
Pour les cas les plus avancés, utilise un Dockerfile pour configurer la machine. Le Dockerfile te permet de gérer des dépendances au niveau système : installer des versions spécifiques de compilateurs, des débogueurs, ou changer l’image d’OS de base. Ne fais pas de COPY de tout le projet — on gère l’espace de travail et on récupère le commit correct. Gère quand même l’installation des dépendances dans le script d’installation. Entre tous les secrets nécessaires pour ton environnement de dev — ils sont stockés chiffrés au repos (via KMS) dans notre base de données et fournis à l’agent en arrière-plan. La configuration de la machine se trouve dans .cursor/environment.json, que tu peux valider dans ton repo (recommandé) ou stocker en privé. Le flux de configuration te guide pour créer environment.json.

​
Commandes de maintenance

Quand tu configures une nouvelle machine, on part de l’environnement de base, puis on exécute la commande install depuis ton environment.json. C’est la commande qu’un développeur lancerait en changeant de branche — pour installer toutes les nouvelles dépendances. Pour la plupart des gens, la commande install est npm install ou bazel build. Pour garantir un démarrage rapide de la machine, on met en cache l’état du disque après l’exécution de la commande install. Conçois-la pour pouvoir s’exécuter plusieurs fois. Seul l’état du disque persiste après la commande install — les processus lancés ici ne seront plus actifs quand l’agent démarrera.

​
Commandes de démarrage

Après avoir exécuté install, la machine démarre et on exécute la commande start, puis on lance les terminals. Ça démarre les processus qui doivent rester actifs quand l’agent tourne. La commande start peut souvent être passée. Utilise-la si ton environnement de dev dépend de Docker — mets sudo service docker start dans la commande start. Les terminals sont pour le code de l’app. Ils tournent dans une session tmux accessible pour toi et pour l’agent. Par exemple, beaucoup de dépôts web mettent npm run watch comme terminal.

​
La spécification de environment.json

Le fichier environment.json peut être de la forme : 
{
  "snapshot": "POPULATED_FROM_SETTINGS",
  "install": "npm install",
  "terminals": [
    {
      "name": "Run Next.js",
      "command": "npm run dev"
    }
  ]
}
La spécification est formellement définie ici.

​
Modèles

Seuls les modèles compatibles avec le Max Mode sont disponibles pour les agents en arrière-plan.

​
Tarification

En savoir plus sur la tarification de Background Agent.

​
Sécurité

Les Background Agents sont disponibles en mode confidentialité. On n’entraîne jamais nos modèles sur ton code et on ne conserve ton code que pour exécuter l’agent. En savoir plus sur le mode confidentialité. Ce que tu dois savoir :
  1. Accorde des privilèges lecture/écriture à notre application GitHub pour les dépôts que tu veux modifier. On s’en sert pour cloner le dépôt et y apporter des changements.
  2. Ton code s’exécute dans notre infrastructure AWS, dans des VM isolées, et il est stocké sur les disques des VM tant que l’agent est actif.
  3. L’agent a accès à Internet.
  4. L’agent exécute automatiquement toutes les commandes du terminal, ce qui lui permet d’itérer sur les tests. Ça diffère de l’agent au premier plan, qui demande l’approbation de l’utilisateur pour chaque commande. L’exécution automatique introduit un risque d’exfiltration de données : des attaquants pourraient mener des attaques de prompt injection et pousser l’agent à téléverser du code vers des sites malveillants. Voir l’explication d’OpenAI sur les risques de prompt injection pour les agents en arrière-plan.
  5. Si le mode confidentialité est désactivé, on collecte les prompts et les environnements de développement pour améliorer le produit.
  6. Si tu désactives le mode confidentialité au démarrage d’un agent en arrière-plan, puis que tu l’actives pendant son exécution, l’agent continue avec le mode confidentialité désactivé jusqu’à la fin de son run.

​
Paramètres du tableau de bord

Les admins d’espace de travail peuvent configurer des paramètres supplémentaires depuis l’onglet Background Agents du tableau de bord.

​
Paramètres par défaut

  • Modèle par défaut – le modèle utilisé quand une exécution n’en spécifie pas. Choisis n’importe quel modèle qui prend en charge Max Mode.
  • Dépôt par défaut – s’il est vide, les agents te demanderont de choisir un dépôt. Indiquer un dépôt ici permet de passer cette étape.
  • Branche de base – la branche depuis laquelle les agents créent un fork lors de la création de pull requests. Laisse vide pour utiliser la branche par défaut du dépôt.

​
Paramètres de sécurité

Toutes les options de sécurité nécessitent des privilèges admin.
  • Restrictions utilisateur – choisis Aucune (tous les membres peuvent lancer des agents en arrière-plan) ou Liste autorisée. Avec Liste autorisée, tu indiques précisément quels coéquipiers peuvent créer des agents.
  • Suivis d’équipe – quand c’est activé, n’importe qui dans l’espace de travail peut ajouter des messages de suivi à un agent lancé par quelqu’un d’autre. Désactive cette option pour limiter les suivis au propriétaire de l’agent et aux admins.
  • Afficher le résumé de l’agent – détermine si Cursor affiche les images de diff de fichiers et les extraits de code de l’agent. Désactive cette option si tu préfères ne pas exposer les chemins de fichiers ou du code dans la barre latérale.
  • Afficher le résumé de l’agent dans les canaux externes – étend le réglage précédent à Slack ou à tout canal externe que tu as connecté.
Les modifications sont enregistrées instantanément et s’appliquent immédiatement aux nouveaux agents.