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..c6fe385c6ca --- /dev/null +++ b/content/en/docs/refguide/modeling/application-logic/workflows/workflow-elements/ai-agent-task.md @@ -0,0 +1,71 @@ +--- +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. The anchor {#ai-agents} is also used in the product. +--- + +## 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. + +## AI Agents {#ai-agents} + +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 + +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). + +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 + +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/)