Robot User Guide
Last updated Jul 1, 2024


The Robot Agent (UiPath.Agent.exe, Robot Tray) is the actual user interface of the Robot. It is a WPF application which displays the available jobs in a system tray window. As a client of the Robot service, it can request to start or stop jobs, and change settings through a WCF channel, based on user input.

Note: Starting with the v2020.10 release, the UiPath Assistant has become the default user interface of the robot.

After you install and run the Robot, an icon is displayed in the system tray. Clicking this icon displays the Robot Agent, while right-clicking it brings up the Options menu.

The Robot Agent enables you to:

  • View all the available automation processes:

    • If the Robot is connected to Orchestrator, processes from the environments and folders the Robot is a part of are displayed.
    • If the Robot is not connected to Orchestrator, processes from the %ProgramData%\UiPath\Packages folder are displayed. The Packages folder can be specified, as explained on the Command Line Parameters page.
  • Start and stop a process, as depicted below. Once a process is started, the execution status is displayed, with the possibility to Pause, Resume, or Stop the execution. The Pause button can be disabled for a process from the Studio Process Settings window. You can use the Report Status activity to have custom status messages displayed during execution. Please note that, upon trigger, the process is paused after the current activity is executed. You can set global keyboard shortcuts from the User Preferences window to pause/resume, or stop processes.
  • View and manage running Foreground and Background processes.

  • View and download processes that have a newer version available, or that need to be downloaded and unpacked locally, and view the installation status, as depicted below:

  • View the status connection to Orchestrator, as follows:

    • Connected, licensed - when a Robot exists and is licensed. The following tooltip message is displayed on mouse hover: "Robot is connected and license is acquired.".
    • Connected, unlicensed - when a Robot exists, but is not licensed. The following tooltip message is displayed on mouse hover: "There are no available licenses on the server.".
    • Robot unavailable - this status is displayed along with one of the following tooltip messages on mouse hover, in the following cases:
    1. "An Orchestrator Robot definition must exist for this user." - if a Machine that hosts the Robot is not defined on Orchestrator. For example, if you deployed your Robots using the ConnectionString without first defining the Robots in Orchestrator.
    2. “Robot does not exist.” - when no Robot is defined.
    3. “There are no available licenses on the server.” - currently, all the available licenses in Orchestrator are consumed.
    4. “Robot already connected to machine ‘Machine_Name’.” - a floating Robot is already in use on a different machine.
    5. "The machine key is linked to another machine!" - the key you used to connect to Orchestrator belongs to another machine in Orchestrator.
  • Search for available processes.

  • Open the Orchestrator Settings window.
  • Open the User Preferences window.
  • Open logs.
  • Resize the tray by dragging its edges.

For more information, see the field descriptions for the Robot Agent.

The Robot system tray icon color indicates its connection status with Orchestrator, as follows:

  • docs image - when the connection is established.
  • docs image - when not connected.
  • docs image - when an error is encountered, such as the UiPath Robot service being stopped.

Additionally, hovering over the icon displays its status.

Closing the Robot Agent does not close the Robot service. When in User Mode, closing the Robot Agent also closes the Robot service.

If an exception is thrown during a process execution, the Runtime execution error window is displayed. It contains a summary of the error, as well as the call stack as details.

Was this page helpful?

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