リファレンスMCP ツールexecute_cloud_skill

Tool Reference

execute_cloud_skill

activeなCloud Skillの宣言済みscript componentを、分離されたexecution engineで実行します。

script pathとrevisionを指定して実行する

activeなskillを選び、再現性が重要な場合はrevisionをpinし、typeがscriptのcomponentを指定します。実行にはmemory:writeが必要で、typed execution envelopeが返されます。

公開 MCP ツール

execute_cloud_skill

用途

activeなCloud Skillの宣言済みscript componentを、分離されたSandboxExecutionEngineで実行します。

適用シーン

  • 意図したrevisionを選択した後、skillのdeterministicなPythonまたはBash script componentを実行する場合。
  • boundedなJSON input objectを渡し、statusやoutput dataを含むtyped execution resultを受け取る場合。
  • codeをagent promptにコピーする代わりに、skillの再利用可能なprocedureをexecutable componentとして使う場合。

非推奨シーン

  • reference、example、template、document、artifact componentは実行しないでください。受け付けるのはtype='script'だけです。
  • productionでunsafe local fallbackに依存しないでください。動作するbubblewrap isolation driverがなければ、defaultはfail-closedのSANDBOX_UNAVAILABLEです。
  • 任意のhost command、network access、unbounded jobには使わないでください。sandboxはnamespace、environment、timeout、process、memory、outputを制御します。
  • 再現可能な実行が重要な場合はrevision pinningを省略しないでください。明示的なrevisionにより別のpublished snapshotの実行を防げます。

必須スコープ

  • 実行は認可されたskill operationであるため、MCP surfaceではmemory:writeが必要です。
  • skillは認証済みpersonalまたはteam scope内で解決される必要があり、cross-scope skill IDはACCESS_DENIEDを返します。

パラメーター

名前型説明
script_pathstring実行するscript componentのlogical pathまたはcomponent IDです。
slugstring · デフォルト: emptyactive skillの解決に使うskill slugです。
skill_idstring · デフォルト: emptyslugの代わりに使うstableなskill identityです。
revision_idstring · デフォルト: empty任意のrevision pinです。省略時はpublished revision、次にlatest revisionが選択されます。
input_argsobject · デフォルト: empty objectscriptのstdinに渡すJSON-compatible valueです。
timeout_secondsinteger · デフォルト: 30ExecutionLimitsによって1–60秒に制限されるexecution timeoutです。

返却スキーマ

kind='execution'と、execution_id、skill_id、revision_id、script_path、runtime、status、exit_code、stdout、stderr、truncation flags、任意のoutput_data、duration_ms、memory_peak_bytes、cpu_time_ms、timestamps、error_kindを含むdataを持つJSON CloudSkillResponseEnvelopeです。

使用例

pinned script componentを1つ実行する
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
})

エラー

  • ACCESS_DENIED、SKILL_NOT_FOUND、またはSKILL_ARCHIVED: callerのscopeでskillを解決できません。
  • REVISION_NOT_FOUND: requested revisionがskillに属していないか、active revisionがありません。
  • SCRIPT_NOT_FOUNDまたはINVALID_COMPONENT_TYPE: pathが存在しないか、script以外のcomponentを指定しています。
  • SANDBOX_UNAVAILABLE: hostに動作するbubblewrap isolation driverがなく、unsafe fallbackも無効です。
  • EXECUTION_TIMEOUT、RESOURCE_EXHAUSTED、またはSCRIPT_EXECUTION_ERROR: watchdog、resource limit、またはscriptのexit statusによって実行が終了しました。
  • recall_cloud_skill — 実行前にskillをdiscoveryし、revision/resourceをpinします。
  • save_cloud_skill — 実行できるprocedureとscript componentを作成します。
  • recall_context — 実行taskに関するbounded agent contextを組み立てます。

出典: Cloud Skills