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.
Outil MCP public
execute_cloud_skill
Objectif
Exécuter un composant de script déclaré à partir d'un Cloud Skill actif via le moteur isolé SandboxExecutionEngine.
Quand l'utiliser
- Exécuter un composant de script Python ou Bash déterministe d'une compétence après avoir sélectionné la révision prévue.
- Transmettre un objet d'entrée JSON délimité et exploiter le résultat d'exécution typé, y compris le statut et les données de sortie.
- Utiliser la procédure réutilisable de la compétence comme composant exécutable plutôt que de copier du code dans un prompt d'agent.
Quand NE PAS l'utiliser
- N'exécutez pas de composant de référence, d'exemple, de modèle, de document ou d'artefact ; seul type='script' est accepté.
- Ne vous fiez pas à un fallback local non sécurisé en production : sans pilote d'isolation bubblewrap fonctionnel, le comportement par défaut est un échec fermé SANDBOX_UNAVAILABLE.
- Ne l'utilisez pas pour des commandes hôtes arbitraires, des accès réseau ou des tâches sans limites ; le bac à sable applique des contrôles d'espace de noms, d'environnement, de délai d'expiration, de processus, de mémoire et de sortie.
- N'omettez pas l'épinglage de révision lorsqu'une exécution reproductible est requise ; une révision explicite évite d'exécuter un instantané publié différent.
Périmètre requis
- memory:write est requis sur la surface MCP car l'exécution est une opération de compétence autorisée.
- La compétence doit être résolue dans le périmètre personnel ou d'équipe authentifié ; les identifiants de compétences hors périmètre renvoient ACCESS_DENIED.
Paramètres
| Nom | Type | Description |
|---|---|---|
script_path | string | Chemin logique ou ID du composant de script à exécuter. |
slug | string · par défaut : empty | Slug de compétence utilisé pour résoudre la compétence active. |
skill_id | string · par défaut : empty | Identifiant stable de compétence alternatif au slug. |
revision_id | string · par défaut : 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 · par défaut : empty object | Valeurs compatibles JSON encodées vers le stdin du script. |
timeout_seconds | integer · par défaut : 30 | Délai d'expiration de l'exécution contraint par ExecutionLimits entre 1 et 60 secondes. |
Schéma de retour
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.
Exemples
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
})Erreurs
- 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.
Outils associés
- recall_cloud_skill — Découvrir la compétence et épingler la révision/ressource avant l'exécution.
- save_cloud_skill — Créer la procédure et le composant de script qui peuvent être exécutés.
- recall_context — Assembler un contexte d'agent délimité autour de la tâche d'exécution.
Source : Cloud Skills