execute_cloud_skill

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.

Ferramenta MCP pública

execute_cloud_skill

Finalidade

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

Quando usar

Execute um componente de script Python ou Bash determinístico de um skill depois de selecionar a revisão pretendida.
Passe um objeto de entrada JSON limitado e consuma o resultado de execução tipado, incluindo status e dados de saída.
Use o procedimento reutilizável do skill como componente executável em vez de copiar código para um prompt do agente.

Quando NÃO usar

Não execute um componente de referência, exemplo, template, documento ou artefato; somente type='script' é aceito.
Não dependa de fallback local inseguro em produção: sem um driver de isolamento bubblewrap funcional, o padrão é SANDBOX_UNAVAILABLE com falha fechada.
Não use para comandos arbitrários do host, acesso à rede ou tarefas sem limite; o sandbox aplica controles de namespace, ambiente, tempo limite, processo, memória e saída.
Não omita a fixação da revisão quando a execução reproduzível for importante; uma revisão explícita evita executar um snapshot publicado diferente.

Escopo necessário

memory:write é obrigatório na superfície MCP porque a execução é uma operação autorizada de skill.
O skill precisa ser resolvido dentro do escopo pessoal ou de equipe autenticado; IDs de skill fora do escopo retornam ACCESS_DENIED.

Parâmetros

Nome	Tipo	Descrição
`script_path`	string	Caminho lógico ou ID do componente de script a executar.
`slug`	string · padrão: empty	Slug do skill usado para resolver o skill ativo.
`skill_id`	string · padrão: empty	Identidade estável do skill como alternativa ao slug.
`revision_id`	string · padrão: 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 · padrão: empty object	Valores compatíveis com JSON codificados na entrada padrão do script.
`timeout_seconds`	integer · padrão: 30	Tempo limite de execução limitado por ExecutionLimits a 1–60 segundos.

Esquema de retorno

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.

Exemplos

Execute um componente de script fixado

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
})

Erros

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.

recall_cloud_skill — Descubra o skill e fixe a revisão/recurso antes de executar.
save_cloud_skill — Crie o procedimento e o componente de script que podem ser executados.
recall_context — Monte o contexto limitado do agente em torno da tarefa de execução.

Origem: Cloud Skills