Invoke Agentic Action
The Invoke Agentic Action action runs a user-defined Agentic Action. The selected Agentic Action uses AI to choose from its configured tools, call them in the order needed, and return a final response.
When to Use This Action
Use this action when:
- A task requires decisions based on runtime context
- The exact sequence of tool calls cannot be defined in advance
- You want to reuse an Agentic Action from a Hosted Mailbox, Remote Mailbox, Scheduled Task, Form, Macro, or another Agentic Action
Don't use this action when the required steps and their order are already known. Configure those actions directly or use a Macro for deterministic, reusable automation. For a single AI request that does not need tools, use Prompt AI.
How It Works
- The action sends your prompt to the selected Agentic Action.
- The Agentic Action evaluates the prompt and its configured instructions.
- It calls configured tools as needed.
- It continues until it produces a final response or reaches the execution limit.
- The action stores the final response in the variable you configure.
Configuration
| Field | Description |
|---|---|
| Agentic Action | Select the Agentic Action to run. Configure its instructions, tools, and response format before using this action. |
| Prompt | Enter the task or question for the Agentic Action. This field supports text expressions such as {{email.subject}}. |
| Expanded Response | Wrap the final response in a Response property. Enable this when later steps need to reference {{custom.<variableName>.Response}}. |
Returned Variables
Configure Store the results in Variable to use the response in later steps.
| Setting | Returned value |
|---|---|
| Expanded Response disabled | The Agentic Action's simple text response or structured object. |
| Expanded Response enabled | An object whose Response property contains the simple text response or structured object. |
For structured responses, the returned object follows the output schema configured on the selected Agentic Action.
Constraints
- Each run supports up to 100 AI turns, including tool calls.
- Tool availability depends on the selected Agentic Action's configuration.
- No external AI account or API key is required.
FAQs
Why did the Agentic Action choose a different tool sequence than expected?
Agentic Actions choose tools at runtime and are non-deterministic. Refine the Agentic Action's instructions and tool selection when it needs clearer boundaries. Use a Macro or direct action sequence when every step must run in a fixed order.