Agents Cloud

Les agents cloud utilisent les mêmes principes de base des agents, mais s’exécutent dans des VM isolées dans le cloud avec des environnements de développement complets, plutôt que sur votre machine locale. L’environnement de développement est similaire à celui de votre ordinateur portable : dépôts clonés, dépendances installées, secrets, commandes de démarrage et accès réseau.

Des environnements de développement efficaces fournissent aux agents tout le contexte nécessaire sur votre base de code et votre organisation, afin qu’ils puissent tester et vérifier leur travail.

Pourquoi utiliser les Agents cloud ?

Vous pouvez exécuter autant d’agents que vous le souhaitez en parallèle, et ils n’exigent pas que votre machine locale soit connectée à Internet.

Parce qu’ils ont accès à leur propre machine virtuelle, les agents cloud peuvent créer, tester et interagir avec le logiciel modifié. Ils peuvent aussi utiliser des ordinateurs pour contrôler le bureau et le navigateur. Les agents cloud prennent en charge les serveurs MCP, ce qui leur donne accès à des outils externes et à des sources de données comme des bases de données, des API et des services tiers.

Les agents cloud peuvent aussi s’exécuter dans des environnements multi-repo. Utilisez-en un lorsqu’une tâche s’étend sur des dépôts distincts de frontend, backend, d’infrastructure ou de bibliothèques partagées. L’agent peut inspecter l’ensemble de l’espace de travail, effectuer des modifications coordonnées et ouvrir des pull requests dans les repos qu’il modifie.

Comment y accéder

Vous pouvez lancer des agents cloud où que vous travailliez :

1. Cursor pour iOS : Lancez et gérez des agents depuis l’application Cursor pour iOS
2. Cursor Web : Lancez et gérez des agents depuis cursor.com/agents sur n’importe quel appareil
3. Cursor Desktop : Sélectionnez Cloud dans le menu déroulant sous l’entrée de l’agent
4. Slack : Utilisez la commande @cursor pour lancer un agent
5. GitHub ou Bitbucket : Ajoutez le commentaire @cursor sur une PR ou une issue GitHub, ou sur une PR Bitbucket, pour lancer un agent
6. Linear : Utilisez la commande @cursor pour lancer un agent
7. API : Utilisez l’API pour lancer un agent

Utiliser Cursor dans Slack

En savoir plus sur la configuration et l’utilisation de l’intégration Slack, y compris le lancement d’agents et la réception de notifications.

Fonctionnement

Connexion au fournisseur de dépôt

Les agents cloud clonent votre dépôt depuis GitHub, GitLab, Azure DevOps Services ou Bitbucket Cloud et travaillent sur une branche distincte, puis envoient les modifications vers votre dépôt pour le relais.

Vous devez disposer de droits de lecture et d’écriture sur votre dépôt ainsi que sur tous les dépôts dépendants ou sous-modules.

Environnements

Les agents ne sont performants qu’à la hauteur des environnements dans lesquels ils s’exécutent. Un agent capable d’écrire du code, mais pas d’exécuter des tests, d’interroger des services ou d’accéder à des API, ne peut pas mener son travail jusqu’au bout.

Ne pas configurer un environnement de développement pour vos agents cloud, c’est comme ne pas donner d’ordinateur à vos ingénieurs. C’est pourquoi la configuration de l’environnement est l’étape la plus importante pour améliorer l’efficacité des agents cloud. Elle permet aux agents cloud de travailler comme des ingénieurs : écrire du code, tester et vérifier leur travail, et livrer des logiciels.

Vous pouvez configurer des environnements avec une configuration guidée par l’agent, un instantané enregistré ou un Dockerfile dans .cursor/environment.json. Voir installation de l’agent cloud pour commencer. Les builds préparent chaque environnement en arrière-plan afin que les agents démarrent avec les dépôts et les dépendances prêts.

Le tableau de bord des agents cloud affiche l’environnement et le build utilisés par un agent, ainsi que les détails de l’environnement et l’historique des versions. Sur la page de l’agent, survolez le nom du dépôt en haut de la page pour examiner l’environnement utilisé pour cette exécution. Voir installation de l’agent cloud pour plus de détails sur la configuration.

Contrôles de l’exécution et de l’environnement

Cursor gère le provisionnement des VM, l’isolation, les instantanés, le démarrage, les artefacts et la capacité de chaque agent cloud. Vous pouvez ajouter des secrets, restreindre les domaines autorisés en sortie, vous connecter à des réseaux privés avec Tailscale ou un client similaire, et utiliser la connectivité privée pour les chemins de gestion de versions pris en charge.

Consultez Sécurité et réseau des agents cloud pour voir l’ensemble des contrôles d’environnement et de réseau. Si vous vous demandez s’il vaut mieux passer à l’auto-hébergement, consultez pourquoi la plupart des équipes commencent avec Cursor Cloud.

Modèles

Les agents cloud utilisent une sélection de modèles triés sur le volet. Vous pouvez sélectionner la taille de la fenêtre de contexte pour les modèles pris en charge.

Prise en charge de MCP

Les agents cloud peuvent utiliser des serveurs MCP (Model Context Protocol) configurés pour votre équipe. Ajoutez et gérez les serveurs MCP via le menu déroulant MCP dans cursor.com/agents.

Les transports HTTP et stdio sont pris en charge. OAuth est pris en charge pour les serveurs MCP qui en ont besoin. Voir fonctionnalités de l’agent cloud pour les détails de configuration.

Les agents cloud incluent également un Cursor Cloud MCP intégré pour exécuter des diagnostics, notamment des transcriptions, des événements d’exécution, des détails sur l’environnement et des journaux d’installation.

Prise en charge des hooks

Les agents cloud exécutent les hooks basés sur des commandes à partir de .cursor/hooks.json dans votre dépôt. Avec les forfaits Enterprise, ils exécutent aussi les hooks d'équipe et les hooks gérés par l'entreprise.

Cela permet de garder actifs les formateurs, les scripts d'audit et les vérifications de règles lorsque le travail s'exécute dans le cloud. Les hooks pris en charge incluent les hooks d'outil et de fichier (preToolUse, beforeShellExecution, afterFileEdit), ainsi que les hooks de cycle de vie (beforeSubmitPrompt, subagentStart / subagentStop, preCompact, afterAgentResponse / afterAgentThought et stop).

Les hooks ne s'exécutent pas pendant les premiers tours d'exploration dans un environnement en lecture seule ; ils démarrent dès que l'agent dispose d'un environnement accessible en écriture. Certains hooks sont spécifiques à l'IDE (hooks Tab, workspaceOpen). Les hooks au niveau utilisateur de ~/.cursor/hooks.json ne sont pas non plus disponibles, car les VM cloud n'ont pas accès à votre répertoire personnel local.

Voir Hooks : prise en charge des agents cloud pour la matrice de prise en charge complète et plus de détails.

Artefacts et contrôle du bureau à distance

Les agents cloud produisent des PR prêtes à être fusionnées, accompagnées d’artefacts pour illustrer leurs modifications. Vous pouvez aussi contrôler le bureau à distance de l’agent pour utiliser le logiciel modifié.

• Artefacts : les agents produisent des captures d’écran, des vidéos et des logs afin que vous puissiez voir exactement ce qui a changé et comment l’agent a vérifié son travail.
• Contrôle du bureau à distance : prenez le contrôle du bureau de l’agent pour tester vous-même le logiciel dans un environnement de développement complet sans avoir à récupérer la branche en local. Redonnez le contrôle à l’agent pour qu’il continue à travailler.

Voir fonctionnalités de l’agent cloud pour en savoir plus sur les artefacts, l’utilisation de l’ordinateur et le contrôle du bureau à distance.

Partager des agents avec votre équipe

Envoyez l’URL d’un agent à un coéquipier : il pourra ouvrir l’exécution pour voir la conversation, les modifications de code et les artefacts produits par l’agent.

Les agents sont visibles par les membres de l’équipe Cursor dans laquelle ils ont été lancés. Cursor vérifie également l’accès au dépôt de chaque personne qui les consulte : pour ouvrir l’agent d’un coéquipier, connectez votre propre compte de contrôle de version dans Integrations et assurez-vous d’avoir accès au dépôt dans lequel l’agent a travaillé. L’appartenance à l’équipe seule ne suffit pas à accorder l’accès.

La consultation est en lecture seule. Pour permettre aux membres de l’équipe d’envoyer des messages de suivi et de poursuivre le travail, un administrateur d’équipe peut activer les messages de suivi d’équipe.

Pages associées

• En savoir plus sur les fonctionnalités de l’agent cloud.
• En savoir plus sur l’installation de l’agent cloud.
• En savoir plus sur les builds de l’agent cloud.
• En savoir plus sur la sécurité de l’agent cloud.
• En savoir plus sur les tokens OIDC.
• En savoir plus sur les paramètres de l’agent cloud.

Facturation

Les agents cloud sont facturés selon la tarification de l’API pour le modèle sélectionné. Vous pouvez sélectionner la taille de la fenêtre de contexte, et une fenêtre de contexte plus grande peut augmenter l’usage des tokens et les coûts. Il vous sera demandé de définir une limite de dépenses lorsque vous commencerez à les utiliser.

Dépannage

Historique des appellations

Les agents cloud s’appelaient auparavant agents d’arrière-plan.