Agent → Execute
AI-generatedSummary
Execute an AI coding agent on a selected CloudCLI environment
Inputs
- agentEnvironmentId (required) — The running environment to execute the agent on
- message (required) — Task description for the AI agent
- provider — AI coding agent to use
- additionalOptions — Additional execution options
- returnFormat — How to return streaming events
Output shape
array of execution result objects, each with a json field (event data or raw response)
When
returnFormatismultiple, each event is returned as a separate item; otherwise a single item with aneventsarray is returned. Errors includeerrorandparse_errorfields.
Examples
Example 1: Review a GitHub PR
Select an environment, set message "Review security of PR #123", choose provider "claude", optional GitHub token, returnFormat single
Example 2: Create a project branch and PR
Enable createBranch and createPR, provide GitHub token, set message, choose provider, returnFormat single