# execute_cloud_skill

Exécutez un composant de script déclaré à partir d'un Cloud Skill actif via le moteur d'exécution isolé.

- Canonical: https://docs.xmemo.dev/fr/docs/tools/execute-cloud-skill
- Locale: fr-FR
- Content-Locale: fr-FR
- Canonical-Content-Digest: aba94d94556b98106266c559e78f7c9d3f934fda4c6f83458f67a7a938bb42c9
- Edition-Digest: 2c54e2c5f44fa386b94f5396c89c2bd452bac402f6fe0bd8709978ce9080d0d6
- Source-Revision: sha256:23bbbd009c5356d1653ef90add53c2a5821b45798e2ded6d766cdffe5bd291f5

## Tool Reference: `execute_cloud_skill`

### Purpose

Exécuter un composant de script déclaré à partir d'un Cloud Skill actif via le moteur isolé SandboxExecutionEngine.

### Parameters

- `script_path` (string, optional): Chemin logique ou ID du composant de script à exécuter.
- `slug` (string, optional, default: empty): Slug de compétence utilisé pour résoudre la compétence active.
- `skill_id` (string, optional, default: empty): Identifiant stable de compétence alternatif au slug.
- `revision_id` (string, optional, default: empty): Épinglage facultatif de la révision ; sinon la révision publiée, puis la dernière révision, est sélectionnée.
- `input_args` (object, optional, default: empty object): Valeurs compatibles JSON encodées vers le stdin du script.
- `timeout_seconds` (integer, optional, default: 30): Délai d'expiration de l'exécution contraint par ExecutionLimits entre 1 et 60 secondes.

### Returns

Une enveloppe JSON CloudSkillResponseEnvelope avec kind='execution' et data contenant execution_id, skill_id, revision_id, script_path, runtime, status, exit_code, stdout, stderr, des indicateurs de troncature, des données output_data facultatives, duration_ms, memory_peak_bytes, cpu_time_ms, des horodatages et error_kind.

### Errors

- ACCESS_DENIED, SKILL_NOT_FOUND ou SKILL_ARCHIVED : la compétence ne peut pas être résolue dans le périmètre de l'appelant.
- REVISION_NOT_FOUND : la révision demandée n'appartient pas à la compétence ou aucune révision active n'existe.
- SCRIPT_NOT_FOUND ou INVALID_COMPONENT_TYPE : le chemin est absent ou désigne un composant qui n'est pas un script.
- SANDBOX_UNAVAILABLE : l'hôte ne dispose pas d'un pilote d'isolation bubblewrap fonctionnel et le fallback non sécurisé est désactivé.
- EXECUTION_TIMEOUT, RESOURCE_EXHAUSTED ou SCRIPT_EXECUTION_ERROR : le chien de garde (watchdog), les limites de ressources ou l'état de sortie du script ont mis fin à l'exécution.

### Examples

#### Exécuter un composant de script épinglé



```typescript
execute_cloud_skill({
  slug: "deployment-procedure",
  revision_id: "revision-id-from-root-recall",
  script_path: "scripts/check.py",
  input_args: { environment: "staging" },
  timeout_seconds: 30
})
```

### Related Tools

- [recall_cloud_skill](/docs/tools/recall-cloud-skill): Découvrir la compétence et épingler la révision/ressource avant l'exécution.
- [save_cloud_skill](/docs/tools/save-cloud-skill): Créer la procédure et le composant de script qui peuvent être exécutés.
- [recall_context](/docs/tools/recall-context): Assembler un contexte d'agent délimité autour de la tâche d'exécution.

## Exécuter par chemin de script et révision

Choisissez une compétence active, épinglez une révision lorsque la reproductibilité importe, et désignez un composant dont le type est script. L'exécution requiert memory:write et renvoie une enveloppe d'exécution typée.