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

Maestro user guide

Last updated Aug 12, 2025

Using agents in Maestro

UiPath Maestro enables the orchestration of complex, long-running business processes where agents—both human and AI—act as key participants. By integrating agents into BPMN-modeled workflows, organizations can design adaptive, resilient automations with full visibility into how each task is executed.

This section introduces how agents operate within Maestro, how to configure UiPath and external agents, and how to connect external systems using Integration Service.

short

Benefits of agent orchestration

Using agents in Maestro brings several operational advantages:

  • End-to-end visibility: Monitor the full lifecycle of every process instance and the contribution of each agent.

  • Resilience by design: Automate retries, escalations, or reroutes for error handling.

  • Dynamic task assignment and scalability: Ensure optimal resource usage by routing tasks to the right agents or users. This ensures that work is distributed efficiently and that your automation scales with your business needs

  • Human-AI collaboration: Seamlessly transition tasks between AI and human agents within the same process.

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.

Using UiPath agents

You can integrate two types of UiPath-native agents into Maestro:
  • Low-Code UiPath agents: Use UiPath Studio Web or Agent Builder to create agents that require minimal code. These agents are published to Orchestrator and integrated into Maestro processes without additional configuration. Learn more about UiPath agents.
  • Coded UiPath agents: For more advanced use cases, developers can build agents using frameworks like LangChain or LangGraph in Python. Once packaged and deployed to Orchestrator, these agents behave like native UiPath components. Learn more about Coded UiPath agents.

Using external agents

Maestro supports agents built outside the UiPath Platform. These agents are connected using secure APIs or platform 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 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.

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.