> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trymaitai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflow Action

> Run a Maitai Workflow as an agent capability

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](/build/agents/capabilities/api_action#invocation-mode), run them in the background to enrich context, or in the foreground to drive the response.