Agents Cloud Cursor
Connectez AI SmartTalk avec Agents Cloud Cursor pour lancer des assistants de codage AI autonomes directement depuis vos conversations ou flux de travail. Les Agents Cloud Cursor peuvent lire des dépôts, générer du code, créer des commits et ouvrir des pull requests automatiquement.
Aperçu
L'intégration des Agents Cloud Cursor vous permet de :
- Lancer des agents de codage AI sur vos dépôts GitHub
- Automatiser la génération de code grâce à des instructions en langage naturel
- Créer des pull requests automatiquement lorsque les tâches sont terminées
- Surveiller l'avancement des agents et consulter l'historique des conversations
- Ajouter des instructions de suivi aux agents en cours d'exécution
- Déclencher des tâches de codage depuis des flux de travail SmartFlow
Prérequis
Avant de commencer, assurez-vous d'avoir :
- Un compte AI SmartTalk actif
- Un compte Cursor avec accès aux Agents Cloud
- Une clé API Cursor (obtenue depuis votre tableau de bord Cursor)
- Des dépôts GitHub accessibles depuis votre compte Cursor
Configuration étape par étape
Étape 1 : Obtenez votre clé API Cursor
- Allez sur votre tableau de bord des Agents Cloud Cursor
- Accédez à vos paramètres API
- Générez une nouvelle clé API pour AI SmartTalk
- Copiez la clé API
Étape 2 : Accédez à l'intégration Cursor
- Connectez-vous à votre compte AI SmartTalk
- Accédez à Administration → Mes Assistants → [Nom de votre Assistant]
- Cliquez sur Connecteurs dans la barre latérale gauche
- Localisez Agents Cloud Cursor et cliquez dessus
Étape 3 : Configurez la connexion
- Cliquez sur Configurer la Configuration
- Entrez votre Clé API Cursor
- Cliquez sur Enregistrer la Configuration
- AI SmartTalk valide automatiquement votre clé API
Étape 4 : Synchronisez les dépôts
Une fois connecté, AI SmartTalk synchronise automatiquement les dépôts GitHub accessibles depuis votre compte Cursor. Vous pouvez également actualiser manuellement la liste des dépôts à tout moment.
Tableau de bord
Une fois connecté, le tableau de bord de l'intégration Cursor fournit un aperçu complet :
Aperçu des Statistiques
| Métrique | Description |
|---|---|
| Total des Agents | Nombre d'agents lancés |
| En cours d'exécution | Agents actuellement actifs |
| Terminés | Agents complétés |
| Modèles Disponibles | Modèles AI disponibles pour les agents |
Assistants Récents
Le tableau de bord liste vos agents les plus récents avec :
- ID de l'Agent pour référence
- Statut : En cours d'exécution, Terminé, Échoué, Création, ou Annulé
- Dépôt sur lequel l'agent travaille
- Date de création
- Actions rapides : Voir Détails et Voir PR
Le tableau de bord se rafraîchit automatiquement toutes les 30 secondes lorsque des agents sont en cours d'exécution.
Lancer un Agent
Depuis le Tableau de Bord
- Cliquez sur Lancer un Nouvel Assistant
- Remplissez le formulaire de lancement :
| Champ | Requis | Description |
|---|---|---|
| Dépôt | Oui | Sélectionnez un dépôt GitHub dans le menu déroulant |
| Description de la Tâche | Oui | Décrivez ce que l'agent doit faire en langage naturel |
| Branche | Non | Branche Git sur laquelle travailler (par défaut : main) |
| Modèle AI | Non | Sélectionnez un modèle AI spécifique pour l'agent |
| Création automatique de PR | Non | Créer automatiquement une pull request une fois terminé (par défaut : activé) |
| Nom de la Branche | Non | Nom de branche personnalisé pour la pull request |
- Cliquez sur Lancer l'Agent
Exemples de Description de Tâche
- "Ajouter des tests unitaires pour le module d'authentification"
- "Refactoriser le pool de connexions à la base de données pour utiliser le recyclage des connexions"
- "Corriger le bug où les sessions utilisateur expirent prématurément sur mobile"
- "Ajouter des définitions de type TypeScript pour tous les objets de réponse API"
- "Créer un point de terminaison API REST pour les préférences utilisateur"
Gestion des Agents
Voir les Détails de l'Agent
Cliquez sur Voir Détails sur n'importe quel agent pour voir :
Onglet Aperçu :
- ID de l'Agent et statut actuel
- Informations sur le dépôt et la branche
- Lien de la pull request (si créée)
- Résumé du travail effectué
- Horodatage de création
Onglet Conversation :
- Historique complet des messages du travail de l'agent
- Instructions de l'utilisateur et réponses AI
- Journal de progression étape par étape
Ajouter des Instructions de Suivi
Vous pouvez envoyer des instructions supplémentaires à un agent en cours d'exécution :
- Ouvrez les détails de l'agent
- Entrez votre instruction de suivi (par exemple, "Ajoutez également une gestion des erreurs pour le cas limite lorsque l'utilisateur n'est pas trouvé")
- L'agent continue son travail avec le nouveau contexte
Supprimer un Agent
Pour nettoyer les ressources :
- Cliquez sur l'action de suppression sur la carte de l'agent
- Confirmez la suppression
- L'agent et ses ressources sont supprimés
Intégration SmartFlow
Les Agents Cloud Cursor peuvent être utilisés comme actions dans les flux de travail SmartFlow, permettant des scénarios d'automatisation puissants.
Actions SmartFlow Disponibles
| Action | Description |
|---|---|
| Lancer un Agent de Codage | Démarrer un agent sur un dépôt avec des instructions spécifiques |
| Ajouter un Suivi | Envoyer des instructions supplémentaires à un agent en cours d'exécution |
| Obtenir le Statut de l'Agent | Vérifier l'avancement et le statut d'un agent |
| Supprimer un Agent | Retirer un agent et nettoyer les ressources |
Exemple : Correction Automatique sur Rapport de Bug
Trigger: Service de Chat (lorsqu'un utilisateur signale un bug)
Actions:
1. Demande AI:
Prompt: Extraire la description du bug et le dépôt affecté
2. Lancer Agent Cursor:
Dépôt: {{extracted_repository}}
Tâche: "Corriger ce bug : {{bug_description}}"
Création automatique de PR: true
3. Envoyer un Message:
Texte: "J'ai lancé un agent de codage pour corriger cela. Je vous informerai lorsque la PR sera prête."
4. Attendre / Interroger:
Vérifier le Statut de l'Agent périodiquement
5. Envoyer un Message:
Texte: "La correction est prête ! Consultez la PR ici : {{pr_url}}"
Exemple : Améliorations de Code Planifiées
Trigger: Flux de Travail Planifié (hebdomadaire)
Actions:
1. Lancer Agent Cursor:
Dépôt: my-org/my-app
Tâche: "Réviser et mettre à jour toutes les dépendances obsolètes"
Branche: chore/update-deps
Création automatique de PR: true
Pour des paramètres d'action SmartFlow détaillés, voir Actions SmartFlow Cursor.
Cas d'Utilisation
Bot de Support Développeur
Permettez aux utilisateurs de demander des modifications de code via le chat :
- "Pouvez-vous ajouter une validation d'entrée au formulaire d'inscription ?"
- "Veuillez créer un script de migration pour les nouveaux champs utilisateur"
Correction Automatisée de Bugs
Déclenchez des agents de codage à partir de rapports de bugs ou d'alertes de surveillance pour générer automatiquement des PR de correction.
Automatisation de la Revue de Code
Lancez des agents pour examiner le code, ajouter des tests ou améliorer la documentation en fonction des retours de PR.
Maintenance Planifiée
Configurez des flux de travail récurrents pour mettre à jour les dépendances, exécuter des corrections de linting ou générer des rapports.
Dépannage
| Problème | Solution |
|---|---|
| "Clé API invalide" | Régénérez votre clé API depuis le tableau de bord Cursor |
| "Dépôt non trouvé" | Cliquez sur Rafraîchir pour resynchroniser les dépôts. Assurez-vous que le dépôt est accessible depuis votre compte Cursor |
| Agent bloqué dans "Création" | L'agent peut être en file d'attente. Attendez quelques minutes et vérifiez à nouveau le statut |
| Agent échoué | Ouvrez les détails de l'agent pour voir la conversation et les messages d'erreur |
| PR non créée | Vérifiez que la création automatique de PR était activée et que l'agent a été complété avec succès |
| Aucun dépôt disponible | Assurez-vous que votre compte Cursor a des dépôts GitHub connectés |
Gestion de l'Intégration
| Action | Comment |
|---|---|
| Connecter | Entrez la clé API dans la configuration de l'intégration |
| Voir le tableau de bord | Ouvrez la page d'intégration Cursor |
| Synchroniser les dépôts | Cliquez sur Rafraîchir pour mettre à jour la liste des dépôts |
| Déconnecter | Supprimez la clé API de la configuration |
Meilleures Pratiques
- Rédigez des descriptions de tâches claires : Plus vos instructions sont spécifiques, meilleur sera le résultat de l'agent.
- Utilisez des branches appropriées : Ne lancez pas les agents directement sur
main— laissez-les créer des PR pour révision. - Activez la création automatique de PR : Facilite la révision et la fusion du travail des agents.
- Surveillez les agents en cours d'exécution : Vérifiez le tableau de bord régulièrement ou configurez des notifications SmartFlow.
- Révisez avant de fusionner : Révisez toujours les PR générées par les agents avant de les fusionner en production.
- Commencez petit : Commencez par des tâches bien définies avant d'essayer de grandes refactorisations.