---
title: "AI Agents as Toolbox Step"
slug: "ai-agents-as-toolbox-step"
updated: 2026-06-02T20:10:44Z
published: 2026-06-02T20:10:44Z
canonical: "documentation.decisions.com/ai-agents-as-toolbox-step"
stale: true
---

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

# AI Agents as Toolbox Step

| Step Details |
| --- |
| **Introduced in Version** | 9.26 |
| **Last Modified in Version** | 9.26 |
| **Location** | AI > Agents |

This step represents a configured **AI Agent** and allows it to be executed directly within a Flow. For every AI Agent created in a project, a corresponding step is automatically generated and made available under **AI > Agents** in the toolbox.

The step uses the Agent’s predefined configuration (system prompt, prompt, provider, model, and max iterations) and allows those values to be configured directly or overridden at runtime through inputs.

---

## How It Works

- AI Agents are created and configured within a Decisions project.
- For every Agent created, a corresponding step is automatically generated.
- These steps appear in the Flow Designer toolbox under **AI > Agents**.
- Each Agent has its own unique step tied to its configuration.

NoteAgent names must be unique. Each unique Agent produces a corresponding step in the toolbox.

---

## Properties

#### Configuration

The Configuration section controls whether Agent properties are provided as static settings or dynamic inputs.

| Property | Description | Type |
| --- | --- | --- |
| Override Properties as Inputs | Enables selected properties to be exposed as inputs instead of being configured in Settings. | Boolean |
| System Prompt | Checkbox to expose System Prompt as an input. | Boolean |
| Prompt | Checkbox to expose Prompt as an input. | Boolean |
| Provider | Checkbox to expose Provider as an input. | Boolean |
| Model | Checkbox to expose the Model as an input. | Boolean |
| Max Iterations | Checkbox to expose Max Iterations as an input. | Boolean |

#### Settings

These properties are used when corresponding Configuration options are **unchecked**.

| Property | Description | Data Type |
| --- | --- | --- |
| System Prompt | Select or create a system prompt to control Agent behavior. | Pick / Create |
| Prompt | Select or create the prompt used by the Agent. | Pick / Create |
| Provider | Select the AI provider. | Dropdown |
| Model | Select the model based on the chosen provider. | Dropdown |
| Max Iterations | Maximum number of iterations the Agent can run. | Int32 |

#### Inputs

When a Configuration checkbox is **enabled**, the selected properties appear here as input mappings and are removed from Settings.

| Property | Description | Data Type |
| --- | --- | --- |
| System Prompt | Overrides the configured system prompt. | String |
| Prompt | Overrides the configured prompt. | String |
| Provider | Overrides the configured provider. | String |
| Model | Overrides the configured model. | String |
| Max Iterations | Overrides the iteration limit. | Int32 |

#### Outputs

| Output | Description | Data Type |
| --- | --- | --- |
| Response (Done) | Returned when the Agent completes successfully. | String |
| Reason (Error) | An error message is returned if execution fails. | String |

---

## Use Case

| Use Case | Description |
| --- | --- |
| Reusable AI Logic | Create an Agent once and reuse it across multiple flows. |
| Simplified Flow Design | Use a preconfigured Agent instead of configuring AI settings in each step. |
| Dynamic Behavior | Override Agent properties at runtime using flow inputs. |

---

## Example

1. [**Create an AI Agent**](https://documentation.decisions.com/docs/create-ai-agent)

Configure an Agent in **[Designer Project] > Manage > Integrations > AI > Agents > Add Agent**.
2. **Add Agent Step**

Drag the corresponding Agent step from **AI > Agents** into a flow.
3. **Configure Properties**

Set values in Settings or enable overrides in Configuration to pass values dynamically.
4. **Run the Flow**

The Agent executes using the configured or overridden values and returns a response.

### Overriding Behavior

- When **Override Properties as Inputs** is enabled, selected properties become dynamic inputs.
- These inputs can be mapped from flow data at runtime.
- When disabled, all properties must be configured statically in Settings.

ExampleEnable override for System Prompt and provide a runtime value like "Respond in a formal tone" to dynamically alter Agent behavior.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1780430964708.png)![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1778711920860.png)

---

## Step Changes

| Description | Version | Release Date | Developer Task |
| --- | --- | --- | --- |
| Removed the "Decisions.AI" prefix from LLM provider names in the provider picker and updated the default Max Iterations value to 5. | 9.27 | June 2026 | [DT-047294] |
| Introduced dynamically generated AI Agent steps available in the Flow Designer toolbox. | [9.26](https://documentation.decisions.com/v99/docs/version-926x-release-notes) | June 2026 | [DT-045792] |