From cae7b915e1b1c0fdfe25a78bab23e6e4afe237aa Mon Sep 17 00:00:00 2001 From: Yiyun Liao Date: Wed, 11 Mar 2026 17:36:29 +0100 Subject: [PATCH 1/3] AI Agent Task Documentation --- .../workflow-elements/ai-agent-task.md | 68 +++++++++++++++++++ 1 file changed, 68 insertions(+) create mode 100644 content/en/docs/refguide/modeling/application-logic/workflows/workflow-elements/ai-agent-task.md diff --git a/content/en/docs/refguide/modeling/application-logic/workflows/workflow-elements/ai-agent-task.md b/content/en/docs/refguide/modeling/application-logic/workflows/workflow-elements/ai-agent-task.md new file mode 100644 index 00000000000..0fd46c3e711 --- /dev/null +++ b/content/en/docs/refguide/modeling/application-logic/workflows/workflow-elements/ai-agent-task.md @@ -0,0 +1,68 @@ +--- +title: "AI Agent Task" +url: /refguide/ai-agent-task/ +weight: 85 +--- + +## Introduction + +**AI agent task** lets you assign a task to an AI Agent as a step in your workflow, instead of assigning that step to a human. + +When the workflow reaches the AI agent task, the agent performs a predefined task autonomously. The workflow then continues based on that result, for example, by routing to the next step, triggering an action, or escalating to a human reviewer. + +**AI agent task** can be used across a wide range of use cases. Some examples include assessing requests, classifying data, extracting information from unstructured text, summarizing content, and drafting outputs such as notifications or reports. + +## Prerequisites + +Before using the AI Agents Task, you need a configured agent ready to call. See How to Configure Studio Pro Agents for a step-by-step guide. + +{{% alert color="info" %}} +The Agent Editor needs to be set up in Studio Pro first. See How to Setup Studio Pro Agents to get started. +{{% /alert %}} + +## Properties + +AI agent task properties consist of the following sections: + +* [General](#general) +* [Parameters](#Parameters) +* [Outcomes](#outcomes) +* [Boundary events](#boundary-events) +* [Common](#common) + +### General Section {#general} + +#### Caption + +The **Caption** describes what happens in this element. It is displayed under the workflow element to make the workflow easier to read and understand. + +#### Microflow + +The microflow that handles execution for this AI agent task. Use it to prepare and pass the right information to the agent, call the agent, and define what happens next. + +### Parameters {#parameters} + +Parameters of the selected microflow. Depending on the selected microflow, you will see a list of its parameters. Parameters pass data to the element. To view Parameters, click the ellipsis icon next to the property name. + +### Outcomes {#outcomes} + +The outcomes depend on the return type of the selected microflow: + +* **No return type**: A single outcome. The workflow moves to the next step. +* **Boolean**: Two outcomes: true and false. The workflow moves to the next step based on the returned value. +* **Enumeration**: One outcome for each enumeration value, plus an empty outcome for when the value is unassigned. The workflow moves to the next step based on the returned value. + +### Boundary Events Section {#boundary-events} + +For more information, see [Boundary Events](/refguide/workflow-boundary-events/). + +### Common Section {#common} + +**Name** is the internal name of the element. When referring to the element in the app, you will use this name. It must be unique within the workflow, but you can have two elements with the same name in different workflows. + +## Read More + +* [Workflow Properties](/refguide/workflow-properties/) +* [How to Setup Studio Pro Agents](AddLink) +* [How to Configure Studio Pro Agents](AddLink) +* [GenAI Capabilities in Mendix](/appstore/modules/genai/) From b420e8a0d4def018489bbc6d23d39f82c5a383a3 Mon Sep 17 00:00:00 2001 From: Yiyun Liao Date: Thu, 12 Mar 2026 13:39:36 +0100 Subject: [PATCH 2/3] Add the AI Agents section --- .../workflows/workflow-elements/ai-agent-task.md | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/content/en/docs/refguide/modeling/application-logic/workflows/workflow-elements/ai-agent-task.md b/content/en/docs/refguide/modeling/application-logic/workflows/workflow-elements/ai-agent-task.md index 0fd46c3e711..05871b5d601 100644 --- a/content/en/docs/refguide/modeling/application-logic/workflows/workflow-elements/ai-agent-task.md +++ b/content/en/docs/refguide/modeling/application-logic/workflows/workflow-elements/ai-agent-task.md @@ -2,6 +2,7 @@ title: "AI Agent Task" url: /refguide/ai-agent-task/ weight: 85 +#If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details. --- ## Introduction @@ -12,13 +13,17 @@ When the workflow reaches the AI agent task, the agent performs a predefined tas **AI agent task** can be used across a wide range of use cases. Some examples include assessing requests, classifying data, extracting information from unstructured text, summarizing content, and drafting outputs such as notifications or reports. -## Prerequisites +## AI Agents {#ai-agents} -Before using the AI Agents Task, you need a configured agent ready to call. See How to Configure Studio Pro Agents for a step-by-step guide. +An AI Agent is an autonomous software system powered by large language models (LLMs) that perceives its environment, reasons, plans, and takes actions to achieve specific goals without constant human supervision. -{{% alert color="info" %}} -The Agent Editor needs to be set up in Studio Pro first. See How to Setup Studio Pro Agents to get started. -{{% /alert %}} +### Configuring Agents in Studio Pro + +Agents are configured in the Agent Editor in Studio Pro. There you define the agent's instructions, connect it to the required tools, and set its behavior. Once configured, the agent can be called from a workflow using the AI agent task. For more information, see [How to Configure Studio Pro Agents](AddLink). + +### Using Agents in Your Project + +If you do not have agents in your project yet, follow [How to Configure Studio Pro Agents](AddLink) to get started. ## Properties From feb08b25df2d78ffa9a5f5e8e82c1d379446801a Mon Sep 17 00:00:00 2001 From: Yiyun Liao Date: Thu, 12 Mar 2026 16:24:00 +0100 Subject: [PATCH 3/3] Update the AI Agents section --- .../workflows/workflow-elements/ai-agent-task.md | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/content/en/docs/refguide/modeling/application-logic/workflows/workflow-elements/ai-agent-task.md b/content/en/docs/refguide/modeling/application-logic/workflows/workflow-elements/ai-agent-task.md index 05871b5d601..c6fe385c6ca 100644 --- a/content/en/docs/refguide/modeling/application-logic/workflows/workflow-elements/ai-agent-task.md +++ b/content/en/docs/refguide/modeling/application-logic/workflows/workflow-elements/ai-agent-task.md @@ -2,7 +2,7 @@ title: "AI Agent Task" url: /refguide/ai-agent-task/ weight: 85 -#If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details. +#If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details. The anchor {#ai-agents} is also used in the product. --- ## Introduction @@ -15,15 +15,13 @@ When the workflow reaches the AI agent task, the agent performs a predefined tas ## AI Agents {#ai-agents} -An AI Agent is an autonomous software system powered by large language models (LLMs) that perceives its environment, reasons, plans, and takes actions to achieve specific goals without constant human supervision. +An AI Agent is an autonomous software system powered by large language models (LLMs). It can perceive its environment, reason, plan, and take actions to achieve specific goals without constant human supervision. ### Configuring Agents in Studio Pro -Agents are configured in the Agent Editor in Studio Pro. There you define the agent's instructions, connect it to the required tools, and set its behavior. Once configured, the agent can be called from a workflow using the AI agent task. For more information, see [How to Configure Studio Pro Agents](AddLink). +You can configure an AI agent using the Agent Editor in Studio Pro. In the editor, you define the agent's instructions, connect it to the required tools, and set its behavior. Once configured, the agent can be called from a workflow using the AI agent task. For a step-by-step guide, see [How to Configure Agents in Studio Pro](AddLink). -### Using Agents in Your Project - -If you do not have agents in your project yet, follow [How to Configure Studio Pro Agents](AddLink) to get started. +If the Agent Editor is not available in Studio Pro, make sure you first complete the [Prerequisites](AddLink) section in [How to Configure Agents in Studio Pro](AddLink). ## Properties