# Cursor Agent - Nœud de workflow | Docs - nodulz

Source: https://nodulz.com/fr/docs/nodes/ai_cursor

Language: fr

Agents cloud Cursor sur vos dépôts Git

## Utilisation et spécificités

Choisissez création d’agent, suivi, lecture d’agent ou conversation. La clé doit accéder aux dépôts sélectionnés. waitForCompletion et timeoutMs règlent l’attente des opérations longues.

Type technique : `ai_cursor`. Runtime : `nodulz`.

## Identifiants et prérequis

- [Créer et configurer l’identifiant : cursor](/docs/credentials/cursor)

Créez l’identifiant dans la rubrique Identifiants de votre instance nodulz, puis sélectionnez-le dans le nœud. Les identifiants disponibles dépendent du propriétaire et du partage. Consultez le [guide des identifiants](/docs/credentials) pour les accès et la rotation.

## Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

| Paramètre | Type | Par défaut | Valeurs / limites |
| --- | --- | --- | --- |
| `credentialId` | `string` | - | - |
| `operation` | `enum` | `"create_agent"` | `create_agent`, `follow_up`, `get_agent`, `list_conversation` |
| `promptText` | `string` | `""` | - |
| `images` | `array` | `[]` | - |
| `images[].sourceType` | `enum` | `"url"` | `url`, `base64` |
| `images[].sourceMode` | `enum` | `"manual"` | `manual`, `node`, `file` |
| `images[].source` | `string` | `""` | - |
| `images[].mimeType` | `string` | `"image/png"` | - |
| `modelId` | `string` | `""` | - |
| `modelParamsJson` | `string` | `""` | - |
| `agentName` | `string` | `""` | - |
| `repos` | `array` | `[]` | - |
| `repos[].url` | `string` | `""` | - |
| `repos[].startingRef` | `string` | `"main"` | - |
| `repos[].prUrl` | `string` | `""` | - |
| `workOnCurrentBranch` | `boolean` | `false` | - |
| `autoCreatePR` | `boolean` | `false` | - |
| `mcpServersJson` | `string` | `""` | - |
| `agentId` | `string` | `""` | - |
| `runId` | `string` | `""` | - |
| `waitForCompletion` | `boolean` | `true` | - |
| `timeoutMs` | `number` | `600000` | -; ≥ 1000 |

## Aide de configuration

| Réglage | Rôle et conseils |
| --- | --- |
| `credentialId`<br>Identifiant IA | Clé API enregistrée sur la page Identifiants pour ce fournisseur. |
| `operation`<br>Opération | Action Cursor Cloud Agents à exécuter. |
| `promptText`<br>Prompt | Instructions envoyées à l'agent Cursor. |
| `agentId`<br>ID agent | Identifiant de l'agent Cursor pour un follow-up ou une lecture. |
| `agentName`<br>Nom de l'agent | Nom affiché pour le nouvel agent Cursor. |
| `modelId`<br>Modèle | Identifiant du modèle chez le fournisseur (ex. gpt-4o, claude-3-5-sonnet). |
| `modelParamsJson`<br>Paramètres modèle (JSON) | Paramètres modèle JSON transmis à l'API Cursor. |
| `workOnCurrentBranch`<br>Pousser sur la branche courante | Pousse les commits sur la branche courante au lieu d'une branche dédiée. |
| `autoCreatePR`<br>Créer une PR automatiquement | Ouvre automatiquement une pull request après les modifications. |
| `mcpServersJson`<br>Serveurs MCP (JSON) | Configuration JSON des serveurs MCP disponibles pour l'agent. |
| `waitForCompletion`<br>Attendre la fin de l'exécution | Attend la fin de l'exécution avant de continuer le workflow. |
| `timeoutMs`<br>Timeout (ms) | Délai maximal d'attente en millisecondes. |
| `runId`<br>ID run (optionnel) | Identifiant d'exécution optionnel pour filtrer ou reprendre. |

## Exemples

- Prompt

## Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

```json
{
  "operation": "create_agent",
  "promptText": "",
  "images": [],
  "modelId": "",
  "modelParamsJson": "",
  "agentName": "",
  "repos": [],
  "workOnCurrentBranch": false,
  "autoCreatePR": false,
  "mcpServersJson": "",
  "agentId": "",
  "runId": "",
  "waitForCompletion": true,
  "timeoutMs": 600000
}
```

## Vérification

Testez le nœud avec des données représentatives. Contrôlez sa sortie dans l’inspecteur et les logs, puis utilisez le mapping de l’éditeur pour les champs des nœuds suivants. Un test de déclencheur avec payload simulé ne valide pas la livraison du service externe.

Voir aussi : [Expressions et données](/docs/expressions), [Exécutions](/docs/executions), [Catalogue des nœuds](/docs/nodes).

## Pour aller plus loin

- [Fonctionnalités - nodulz](https://nodulz.com/fr/product/overview)
- [Catalogue des nœuds - nodulz](https://nodulz.com/fr/product/catalog)
- [Serveur MCP - nodulz](https://nodulz.com/fr/product/mcp)
- [Tarifs - nodulz](https://nodulz.com/fr/pricing)
- [Cas d’usage et automatisations - nodulz](https://nodulz.com/fr/use-cases)
- [Choisissez ce que vos workflows peuvent faire. - nodulz](https://nodulz.com/fr/compare)
- [Documentation - nodulz](https://nodulz.com/fr/docs)