Utilisation des agents d'arrière-plan dans Cursor pour l'automatisation

Cursor 1.0 a introduit les agents d'arrière-plan - une fonctionnalité puissante qui permet aux agents IA d'exécuter des tâches en arrière-plan sans bloquer votre IDE. Ce guide explique comment configurer, gérer et exploiter les agents d'arrière-plan pour une productivité maximale.

Que sont les agents d'arrière-plan ?

Les agents d'arrière-plan permettent :

• Tâches de longue durée qui continuent pendant que vous travaillez sur d'autres choses
• Traitement parallèle de plusieurs tâches indépendantes
• Opérations asynchrones comme les tests, les builds et l'analyse
• Tâches planifiées qui s'exécutent à des moments précis

Prérequis

• Cursor version 1.0 ou plus récente
• Plan Pro ou supérieur (les agents d'arrière-plan peuvent nécessiter un niveau payant)
• Des projets avec des tâches qui peuvent s'exécuter indépendamment

Démarrer un agent d'arrière-plan

Méthode 1 : Menu contextuel

1. Ouvrez Composer (Cmd/Ctrl + I)
2. Tapez la description de votre tâche
3. Cliquez sur le menu ... (Plus d'actions)
4. Sélectionnez Exécuter en arrière-plan

Méthode 2 : Commande

@background Analysez l'ensemble de la base de code pour détecter les vulnérabilités de sécurité et rapportez les résultats.

Méthode 3 : Raccourci clavier

1. Composez votre tâche
2. Appuyez sur Cmd/Ctrl + Shift + B (si configuré)
3. L'agent démarre en arrière-plan

Cas d'utilisation des agents d'arrière-plan

1. Analyse de la base de code

[Arrière-plan] Analysez l'ensemble de la base de code et :
1. Trouvez tous les commentaires TODO
2. Identifiez l'utilisation d'API obsolètes
3. Listez les fichiers sans couverture de tests
4. Détectez les fuites de mémoire potentielles
5. Rapportez la duplication de code

Livrez un rapport de synthèse une fois terminé.

2. Exécution de tests

[Arrière-plan] Exécutez la suite de tests complète :
1. Exécutez tous les tests unitaires
2. Lancez les tests d'intégration
3. Générez le rapport de couverture
4. Sauvegardez les résultats dans test-results/

Prévenez-moi une fois terminé avec un résumé pass/échec.

3. Génération de documentation

[Arrière-plan] Générez la documentation de l'API :
1. Analysez src/ pour toutes les fonctions/classes publiques
2. Créez des JSDoc/docstrings là où ils manquent
3. Générez des documents markdown dans docs/api/
4. Créez un index de navigation

Utilisez le style existant de src/utils/helpers.ts.

4. Refonte de grandes bases de code

[Arrière-plan] Refactorisez la gestion des erreurs :
1. Trouvez tous les blocs try/catch
2. Standardisez les messages d'erreur
3. Ajoutez une journalisation d'erreurs structurée
4. Créez des classes d'erreur personnalisées

Appliquez les modifications dans toute la base de code.

Gestion des agents d'arrière-plan

Afficher les agents actifs

1. Ouvrez le panneau Agents d'arrière-plan :

   • Affichage > Apparence > Afficher les agents d'arrière-plan
   • Ou utilisez l'icône de la barre latérale

2. Voyez tous les agents en cours d'exécution avec :

   • La description de la tâche
   • L'heure de début
   • L'état actuel
   • L'indicateur de progression

États des agents

État	Description	Action
En cours	L'agent travaille activement	Surveiller la progression
En pause	L'agent a été mis en pause manuellement	Reprendre ou annuler
Terminé	La tâche s'est terminée avec succès	Voir les résultats
Échoué	La tâche a rencontré une erreur	Consulter les logs
Annulé	La tâche a été arrêtée par l'utilisateur	Redémarrer si nécessaire

Contrôler les agents

# Mettre un agent en pause
cursor agent:pause <agent-id>

# Reprendre un agent
cursor agent:resume <agent-id>

# Annuler un agent
cursor agent:cancel <agent-id>

# Voir les logs de l'agent
cursor agent:logs <agent-id>

Sortie et résultats de l'agent

Types de résultats

1. Modifications de fichiers : L'agent a modifié des fichiers

   • Réviser dans le panneau de contrôle de source
   • Voir le diff avant de commiter

2. Rapports : Résumés générés

   • Sauvegardés à l'emplacement spécifié
   • Ou affichés dans le panneau de notification

3. Notifications : Mises à jour de statut

   • Notifications de bureau une fois terminé
   • Badge sur l'icône Cursor

Accéder aux résultats

Quand un agent d'arrière-plan se termine :

1. Une notification apparaît (si activée)
2. Un badge s'affiche sur le dock/barre des tâches Cursor
3. Le panneau de résultats s'ouvre automatiquement
4. Les fichiers modifiés apparaissent dans le contrôle de source

Bonnes pratiques

Granularité des tâches

Divisez les grandes tâches en agents d'arrière-plan plus petits :

# Bon : tâches spécifiques et indépendantes
[Arrière-plan] Refactoriser la gestion des erreurs du module d'authentification
[Arrière-plan] Refactoriser la gestion des erreurs du module de paiement
[Arrière-plan] Refactoriser la gestion des erreurs du module de notification

# Moins idéal : une tâche géante
[Arrière-plan] Refactoriser toute la gestion des erreurs dans toute l'application

Gestion des ressources

Limitez les agents d'arrière-plan simultanés :

# Nombre maximal recommandé d'agents simultanés
- 2-3 pour les tâches intensives en CPU (refactorisation, analyse)
- 5+ pour les tâches liées aux E/S (documentation, rapports)

Points de contrôle

Pour les tâches longues, utilisez des points de contrôle :

[Arrière-plan] Migrer le schéma de base de données :
1. Créer une sauvegarde
2. Exécuter les scripts de migration
3. Vérifier l'intégrité des données
4. Générer un script de rollback

Sauvegarder la progression après chaque étape.
Si interrompu, reprendre depuis le dernier point de contrôle.

Surveillance et logs

Voir les logs de l'agent

1. Ouvrez le panneau Agents d'arrière-plan
2. Cliquez sur un agent terminé
3. Visualisez le log d'exécution complet
4. Consultez les horodatages et actions

Structure du log

[2026-06-25 10:00:00] Agent démarré : "Analyse de sécurité de la base de code"
[2026-06-25 10:00:05] Lecture : src/auth/login.ts
[2026-06-25 10:00:10] Lecture : src/auth/register.ts
[2026-06-25 10:00:15] Analyse terminée : 3 vulnérabilités trouvées
[2026-06-25 10:00:20] Écriture du rapport : security-report.md
[2026-06-25 10:00:25] Agent terminé avec succès

Sélection du modèle pour les agents d'arrière-plan

Différents modèles conviennent à différentes tâches d'arrière-plan :

Type de tâche	Modèle recommandé	Pourquoi
Analyse de code	Claude 3.5 Sonnet	Approfondi, précis
Refactorisation	GPT-4o	Rapide, fiable
Documentation	Gemini 1.5 Pro	Long contexte
Tests	Claude 3.5 Sonnet	Bonne détection des cas limites
Audit de sécurité	Claude 3 Opus	Analyse approfondie

Configurez le modèle par défaut dans les paramètres :

{
  "backgroundAgents": {
    "defaultModel": "claude-3-5-sonnet",
    "maxConcurrent": 3,
    "autoNotify": true
  }
}

Dépannage

Problème	Solution
L'agent ne démarre pas	Vérifiez les limites du plan ; une mise à niveau peut être nécessaire
L'agent disparaît	Vérifiez le panneau Agents d'arrière-plan pour les erreurs
Les résultats ne sont pas sauvegardés	Spécifiez le chemin de sortie dans la description de la tâche
L'agent se bloque	Annulez et redémarrez ; il attend peut-être une entrée
Utilisation élevée du CPU	Réduisez les agents simultanés ; utilisez des modèles plus légers

Exemple : Flux de travail d'arrière-plan complet

# Matin : Lancer l'analyse
[Arrière-plan] Analysez la dette technique dans la base de code.
Générez une liste priorisée des tâches de refactorisation.

# Pendant que l'agent s'exécute, continuez à coder...

# L'agent se termine
[Notification] "Analyse terminée : 12 opportunités de refactorisation trouvées"

# Consulter les résultats
Ouvrir : analysis-results/refactoring-tasks.md

# Lancer la refactorisation en arrière-plan
[Arrière-plan] Implémentez les 3 principales tâches de refactorisation de l'analyse.

# Continuer d'autres travaux...

# Réviser les modifications quand c'est pratique
Vérifier le panneau de contrôle de source pour le diff

Ressources connexes

• Cursor Agent Mode Masterclass
• MCP Multi-Agent Workflows
• Handling Large Projects with Cursor