Maestro BPMN

Prepare and configure the Maestro BPMN node, read its output, and choose between a BPMN process and an Autonomous agent.

Invokes a Business Process Model and Notation (BPMN) process that is already deployed in your organization, such as an agent or agentic automation built elsewhere, and returns its result. Use this node to reuse a deployed process as a step in your workflow, rather than authoring an agent inline with the Autonomous Agent node.

Before you start: deploy a process

The BPMN process node has no process of its own. It lists the BPMN processes deployed in your organization, so one must be deployed before it appears under the node.

• The Add node panel lists deployed processes under BPMN process, each as its own node.
• If nothing is deployed, the category appears but is empty.

How it works

Deployed processes are loaded from your organization, the same way connector nodes and Extract models are. Adding one to the canvas creates a node bound to that specific process. When it runs, Maestro Automate invokes the process, waits for it to complete, and returns its result before continuing.

Configuration

Field	Required	Description
Process	Yes	The deployed BPMN process to invoke. Chosen when you add the node from the Add node panel.
Input	No	Values mapped to the process's input schema, bound to workflow data with expressions such as $vars.start.output.request.

Output variables

Variable	Description
output	The process's result, structured according to its output schema. Access fields with $vars.<node>.output.<field>.
error	Populated if the node fails. Error handling describes the error shape.

Choosing between an Autonomous Agent and a BPMN process

Use…	When you want to…
Autonomous Agent	Author the agent inline on the canvas: set its model, prompts, tools, and context here.
BPMN process	Reuse an agent or agentic automation that is already deployed in your organization.

Notes

• To test without invoking the real process, use Mock output on the node and supply a sample result.
• The BPMN process node supports an error handle. Connect it to route failures instead of stopping the workflow.
• The list of processes reflects what is deployed in your organization at design time. Deploy the process, then reopen the Add node panel to see it.

Next steps

• Autonomous Agent: author an agent inline instead of reusing a deployed one.
• Error handling: route failures from the node.
• Output mocking: test without invoking the real process.
• Community: ask questions and share workflows with other builders on the UiPath Forum.