Maestro user guide

Last updated Sep 3, 2025

Guided quick-start: Model and run a process

Make sure you have access to UiPath Automation Cloud.
Make sure you have a Studio Web license with access to Maestro.
Get familiar with the concepts of projects and solutions in Studio Web.

Choose your starting point in Studio Web

Depending on how you plan to structure your work, you can either start fresh or build Maestro into an existing solution.
- Create a new project
  1. Open Studio Web.
  2. Select New Project.
  3. Choose Solution, give it a clear name (e.g., InvoiceApprovalSolution) and select Create.
    This creates a Solution container, where you can later add multiple projects—including Maestro.
- Add Maestro to a Solution (Unified Build)
  1. Inside your solution, click Add Project.
  2. Select Maestro as the project type.
  3. Name your Maestro project (e.g., InvoiceApprovalProcess) and select Create.
    This adds a standalone Maestro process to your solution, ready to be modeled
  Tip: You can also add Studio, Apps, or Rule projects to the same solution if your workflow spans different UiPath components.
Model your process

After you have your Maestro project, it's time to define the process logic using BPMN.
1. In the Maestro project, open the modeling canvas.
2. From the palette, drag a Start event onto the canvas.
3. Add a User task, Robot task, or Service call depending on your goal.
4. Use Gateways to define conditional logic or parallel flow.
5. Connect your shapes with Sequence flows to define the execution order.
6. End the process with an End event.
  
  Tip: Add descriptions and meaningful names to each step for clarity and collaboration
When your process is ready, click Save. You now have a fully modeled agentic process.
Test your process
Before publishing to production, test your process using the built-in Test Mode.
1. In your Maestro process, select the Test button.
2. In the Test configuration panel:
  - Add any required input variables.
  - Configure task behavior (e.g., assign user for manual tasks).
3. Select Run Test.
4. Monitor progress from the Test Execution View:
  - View task assignments.
  - Pause or skip tasks.
  - Inspect variables in real-time
  Tip: You can run multiple tests and iterate quickly by adjusting the process logic in the canvas and re-testing