maestro
latest
false
UiPath logo, featuring letters U and I in white

Maestro user guide

Last updated Oct 20, 2025

Using agents in Maestro

How agents work in Maestro

Agents are represented in Maestro BPMN workflows as Service Tasks. When your process calls a Service Task, Maestro invokes the corresponding agent with the required input parameters for the specific process instance.

Agents return output data to Maestro, which is used to determine the next steps in the workflow. You can configure agents to report the tools used, decisions made, and trace data to support debugging and transparency.

Agents can be:

  • Built directly within the UiPath Platform (low-code or coded)
  • Connected via external APIs or Integration Service
  • Triggered through events or signals based on workflow logic

Watch a real-world example: UiPath Maestro: The brain behind seamless, transparent loan automation.

Connecting agents via Integration Service

UiPath Integration Service provides ready-made and custom connectors to integrate external systems into your automations:
  • Prebuilt connectors for services like Salesforce, Microsoft 365, and Google Workspace
  • Custom connector builder to expose any REST API to UiPath Platform
  • Unified credential and connection management

Use Integration Service to enable Maestro to send/receive data from agents or systems not natively hosted in UiPath. Learn more about Integration Service.

Using external agents

Maestro is vendor-neutral. You can orchestrate work across your preferred external AI agents—without rebuilding your processes—by using UiPath Integration Service connectors.

You can orchestrate:

  • Proprietary AI services
  • External decision engines
  • Microservices or bots hosted on other platforms

Maestro invokes these agents by calling REST endpoints and expects a response payload with structured data.

Connecting external agents via Integration Service

At design time, add a Service task, choose Start and wait for external agent, and configure the agent activity from the selected connector. At runtime, Maestro sends the prompt and context to the agent and waits for the response. You map that response to variables to drive gateways, assignments, and subsequent actions.

The following links show how to connect an external agent, run it from a Maestro process, and capture its output for routing and decisions:

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo
Trust and Security
© 2005-2025 UiPath. All rights reserved.