Skip to main content
A Workflow Action lets your agent invoke a Maitai Workflow (a versioned, multi-step script hosted on the platform) as a single capability.

​
When to use Workflow Actions

Use a Workflow Action when a task is too procedural for prompt-driven orchestration: deterministic multi-step logic, data transformations, or an existing workflow your team already maintains in Forge > Workflows.
  • Deterministic pipelines: The agent decides when to run the workflow; the workflow guarantees how the steps execute.
  • Reuse: The same workflow can back multiple agents, and be tested and versioned independently of any of them.

​
Configuration

  1. Add a capability with type Maitai Workflow.
  2. Select the workflow to run (or enter a workflow reference directly).
  3. Define the action’s name, description, and parameter schema like any other action, the agent passes the arguments it plans as the workflow’s input, and the workflow’s output returns to the agent as the action result.
Like all actions, Workflow Actions have an Invocation Mode, run them in the background to enrich context, or in the foreground to drive the response.