- Introduction
- Process modeling
- Process implementation
- Process operations
- Process monitoring
- Process optimization
- Licensing
- Reference information
Maestro user guide
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.
- 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.
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.
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.
Prefer Integration Service connectors when they exist. Use API workflows when you need API-level connectivity (early APIs, evolving schemas, or streaming responses). Define requests and outputs declaratively, parse JSON without custom code, and pass results into your Maestro process.
- Connector: Supported system, stable schema, managed authentication, best long-term choice.
- API Workflow: New or unsupported API, changing response shapes, or streaming-only output.
- Snowflake Cortex - API workflow: Handle the Cortex Agent’s streaming output, assemble it into a usable response, and return structured JSON for downstream automation.
- Databricks Genie - API workflow: Start a conversation, poll message status until COMPLETED, extract the generated SQL (attachment_id), execute it, and return the answer.
