# execute_cloud_skill

Execute um componente de script declarado de um Cloud Skill ativo pelo mecanismo de execução isolada.

- Canonical: https://docs.xmemo.dev/pt-br/docs/tools/execute-cloud-skill
- Locale: pt-BR
- Content-Locale: pt-BR
- Canonical-Content-Digest: aba94d94556b98106266c559e78f7c9d3f934fda4c6f83458f67a7a938bb42c9
- Edition-Digest: aa633def8e912a8e6ec081458c773e1ed9075a904965d6e2b03fac64aa69ce28
- Source-Revision: sha256:23bbbd009c5356d1653ef90add53c2a5821b45798e2ded6d766cdffe5bd291f5

## Tool Reference: `execute_cloud_skill`

### Purpose

Execute um componente de script declarado de um Cloud Skill ativo pelo SandboxExecutionEngine isolado.

### Parameters

- `script_path` (string, optional): Caminho lógico ou ID do componente de script a executar.
- `slug` (string, optional, default: empty): Slug do skill usado para resolver o skill ativo.
- `skill_id` (string, optional, default: empty): Identidade estável do skill como alternativa ao slug.
- `revision_id` (string, optional, default: empty): Fixação opcional da revisão; caso contrário, a revisão publicada e depois a revisão mais recente são selecionadas.
- `input_args` (object, optional, default: empty object): Valores compatíveis com JSON codificados na entrada padrão do script.
- `timeout_seconds` (integer, optional, default: 30): Tempo limite de execução limitado por ExecutionLimits a 1–60 segundos.

### Returns

Um JSON CloudSkillResponseEnvelope com kind='execution' e data contendo execution_id, skill_id, revision_id, script_path, runtime, status, exit_code, stdout, stderr, flags de truncamento, output_data opcional, duration_ms, memory_peak_bytes, cpu_time_ms, timestamps e error_kind.

### Errors

- ACCESS_DENIED, SKILL_NOT_FOUND ou SKILL_ARCHIVED: o skill não pode ser resolvido no escopo do chamador.
- REVISION_NOT_FOUND: a revisão solicitada não pertence ao skill ou não existe uma revisão ativa.
- SCRIPT_NOT_FOUND ou INVALID_COMPONENT_TYPE: o caminho não existe ou nomeia um componente que não é script.
- SANDBOX_UNAVAILABLE: o host não possui um driver de isolamento bubblewrap funcional e o fallback inseguro está desabilitado.
- EXECUTION_TIMEOUT, RESOURCE_EXHAUSTED ou SCRIPT_EXECUTION_ERROR: o watchdog, os limites de recursos ou o status de saída do script encerraram a execução.

### Examples

#### Execute um componente de script fixado



```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): Descubra o skill e fixe a revisão/recurso antes de executar.
- [save_cloud_skill](/docs/tools/save-cloud-skill): Crie o procedimento e o componente de script que podem ser executados.
- [recall_context](/docs/tools/recall-context): Monte o contexto limitado do agente em torno da tarefa de execução.

## Execute pelo caminho do script e pela revisão

Escolha um skill ativo, fixe uma revisão quando a reprodutibilidade for importante e informe um componente cujo tipo seja script. A execução exige memory:write e retorna um envelope de execução tipado.