Webinar

October 12, 2021 12:00 PM EDT
The future of RPA: Migrating to Gen-2 toolsOctober 12, 2021 12:00 PM EDT
Are you wondering if it is worth the time and money to switch RPA platforms? Join our RPA experts as they discuss all things migration & Gen-2 tools.

Installing and linking Robocorp Workforce Agent

Downloading the latest version of Robocorp Workforce Agent

  1. While logged into Control Room, click on the Environments menu item in the top bar.
  2. Select the correct installation package for your operating system and download it.

Installation under Windows

  1. Find the .exe version of the installer you downloaded on your machine and execute it.
  2. Read and accept the Robocorp End User License Agreement.
  3. Choose whether you want to install for your user only or for all users on the machine, in which case you will be asked for admin credentials.
  4. Choose the installation location.
  5. Wait for the installer to complete.
  6. Finish the installation. With the Run Robocorp Workforce Agent ticked, the application will start directly.

Installation under macOS

  1. Find the .dmg version of the installer you downloaded on your machine and launch it.
  2. Read and accept the Robocorp End User License Agreement.
  3. In the next window, drag the Robocorp Workforce Agent icon into the Applications folder shortcut: Robocorp Workforce Agent - Dragging to application folder
  4. Find the Robocorp Workforce Agent icon in your Application folder and launch it by double-clicking it.

Now you are ready to link and start your Robocorp Workforce Agent.

Installation under Linux

Robocorp Workforce Agent for Linux is distributed as an AppImage package. We recommended setting up desktop integration for AppImage.

  1. Find the .AppImage version of the installer you downloaded on your machine.
  2. Make the downloaded file executable:
    • NOTE: If you have set up desktop integration, you do not need to do this step.
    • Via the UI (Gnome): Right-click on the downloaded file, select Properties, switch to the Permissions tab, and select the Allow executing file as program checkbox. You can now close the dialog. Robocorp Workforce Agent Linux set package executable
    • Via the Terminal: Open a terminal, change to the directory containing the AppImage file:
      • cd <my directory>, and execute the command chmod +x robocorp-workforce-agent-linux.AppImage
  3. Run the robocorp-workforce-agent-linux.AppImage file either by double-clicking it or via the Terminal.
  4. Read and accept the Robocorp End User License Agreement.
  5. The application will start.

Now you are ready to link and start your Robocorp Workforce Agent.

Before Robocorp Workforce Agent can start executing your workforce processes, you need to link it to Control Room.

You can do it in two ways, either using your Control Room credentials or by providing it with an access token. This procedure is the same for all platform versions.

Linking Robocorp Workforce Agent using your Control Room Credentials

  1. Click on the Login to Robocorp Cloud button on the main screen in Robocorp Workforce Agent: Robocorp Workforce Agent - Linking with credentials
  2. You will see the familiar Control Room login screen. Log into Control Room with your credentials. Robocorp Workforce Agent - Linking with credentials - Login
  3. Choose the workspace you want to associate Robocorp Workforce Agent with: Robocorp Workforce Agent - Linking with credentials - Choose workspace
  4. Give a name to your Robocorp Workforce Agent and confirm by clicking the Link Robocorp Workforce Agent button: Robocorp Workforce Agent -  Linking with credentials - Give a name to Robocorp Workforce Agent
  5. Your Robocorp Workforce Agent is now linked.

Linking Robocorp Workforce Agent using an access token

  1. In Control Room, switch to the workspace you want to link Robocorp Workforce Agent to.
  2. While logged into Control Room, click on the Environments menu item in the top bar.
  3. Click on the Generate link token button: Click generate link token button
  4. A token will be generated and displayed for you. Copy it to the clipboard: View and copy token
  5. In Robocorp Workforce Agent, click on the Link Token tab, paste your token in the Robocorp Cloud Link Token field, and assign a name to the Robocorp Workforce Agent: Provide token to Robocorp Workforce Agent
  6. Your Robocorp Workforce Agent is now linked.

Successfully linked Robocorp Workforce Agents displayed in Control Room

Once Robocorp Workforce Agent is linked, it will be displayed in the Environments page of the relevant workspace:

Robocorp Workforce Agent in the Control Room UI

Your Robocorp Workforce Agent is now ready to be assigned to your robots.

Follow the instructions on the Using Robot Assistants in Control Room page.

Starting and stopping Robocorp Workforce Agent

Once you have linked Robocorp Workforce Agent to Control Room, you can start it and stop using the UI. You can check the console output log on the main screen. Robocorp Workforce Agent start and stop

Unlinking a linked Robocorp Workforce Agent

To unlink a linked Robocorp Workforce Agent:

  1. Click on the dropdown on the top right, and select Unlink Environment: Unlink Robocorp Workforce Agent
  2. Confirm in the next screen: Confirm Robocorp Workforce Agent unlinking
  3. Robocorp Workforce Agent is now unlinked.

Once you have unlinked Robocorp Workforce Agent, you can link it again, but it will be considered a new Runtime Environment in Control Room, and you will need to clear the old Environment from Control Room manually.

August 18, 2021