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

Workflow Activities

Last updated Feb 19, 2025

Run Agent

Important:

This is a preview activity.

UiPath.Activities.System.Agentic.RunAgentUiPath.Activities.System.Agentic.RunAgent

Description

The Run Agent activity initiates the execution of a predefined process on a designated agent. It is similar to the Start Job activity, which starts the execution of a job in Orchestrator. However, unlike the Start Job activity, which is a fire-and-forget type of activity, Run Agent can receive input arguments, it can be suspended, it provides outputs, and allows future interactions with its output. It also logs agent-specific details in the automation trace.

Important:

Agents must exist in your Orchestrator folder prior to configuring this activity.

Project compatibility

Windows | Cross-platform

Windows, Cross-platform Configuration

  • Activity body properties:

    Orchestrator folder path

    Select the Orchestrator folder where the agent you want to run is deployed. Only the folders you can access are displayed in the dropdown menu. If you do not select an option, your Personal Workspace is used.

    Process name

    Select the process associated to the agent you want to run. The agent-based processes are displayed. If the agent you need is not listed, select Manage processes to be redirected to your folder in Orchestrator, where you can add the missing agent-based process.

    Input

    Once you select an agent-based process, the Input field is displayed. Select it to open the Data Mapping window, where you can provide values for the process input arguments.

  • Properties panel:

    Continue on error

    Specify if the automation should continue even when the activity throws an error. This field only supports Boolean values (true, false). The default value is false. As a result, if the field is not configured and an error is thrown, the execution of the project stops. If the value is set to true, the execution of the project continues regardless of any error.

    Output

    Displays the list of output arguments for the agent-based process, as they were defined during the agent creation.

  • Description
  • Project compatibility
  • Windows, Cross-platform Configuration

Was this page helpful?

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