Best Practices when Migrating from Desktop Agent 2 to Desktop Agent 3

The following page will walk you through the steps required to use your desktop agent 2 projects with the desktop agent 3.

This applies when you have automations that run using the desktop agent 2 and you want to run them using the desktop agent 3.

Why to Migrate from Desktop Agent 2 to Desktop Agent 3

Desktop agent 2 is out of maintenance and it is recommended to migrate to desktop agent 3.

What are the prerequisites?

To use your automations with the desktop agent 3, you must update your Core SDK package to version 1.26 at least. If your project contains PDF or Documentation Information Extraction activities, you must update your PDF SDK version to version 1.26 at least at well.

To update your dependencies:
  1. In the Overview page of your project, click to open the Project Properties.

  2. Select the Dependencies tab.

  3. Click Update all SDK so that all of your SDK packages are updated to the latest version.

  4. If you're using an RPA tenant: Generate a new package from your project. For more information, see Generate a Package.

    If you're using an SPA tenant: Redeploy your project. For more information, see Deploy an Automation Project without a Trigger.

You can use your project with the desktop agent 3. Note that even after doing this update your project will remain compatible with the desktop agent 2.

Which projects are supported?

You will be able to use your project with the agent 3 if it meets the following requirements:
  • Your project must be a Cloud project.

  • The Core SDK package version of your project must be updated to 1.26 or higher.

  • If your project contains PDF or Document Information Extraction activities, its PDF SDK package must be updated to version 1.26 or higher.

  • The desktop agent 2 must not be installed on your computer.

How to know if your migration from the Desktop Agent 2 to the Desktop Agent 3 was successful?

  • Your existing projects continue to work as before.

  • When errors occur, the traces are correctly generated and visible in the Cloud.