oz_agent_run_cloud
Launch a Warp Oz AI agent in the cloud to execute tasks from a natural-language prompt. Returns a run ID immediately for later status polling.
Instructions
Launch a Warp Oz AI agent in Warp's cloud (not on the local machine). ⚠️ CONSUMES WARP CREDITS — confirm with the user before calling. Returns the run id immediately WITHOUT waiting for completion; poll the terminal status and output with oz_run_get, or find the run later via oz_run_list. Requires the oz CLI on PATH and a Warp account with cloud credits.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prompt": "<prompt>"
},
"name": "oz_agent_run_cloud"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | AI model id to use, from `oz_list_models`. Omit to use the configured default. | |
| skill | No | Agent skill id (e.g. `5-test-agent`). Omit to auto-select from the prompt. | |
| prompt | Yes | Natural-language instruction for the cloud agent. | |
| environment | No | Cloud environment id or name to run in. Omit to use the configured default, or the first available environment. |