Skip to Content

Install and Set Up Desktop Agent 3

Install and set up the Desktop Agent 3 to run your automations
You will learn
  • How to install the Desktop Agent 3
  • How to register a tenant in the Desktop Agent 3
pbujnickaPaulina BujnickaFebruary 27, 2024
Created by
celineaudinsap
November 20, 2022
Contributors
celineaudinsap
pbujnicka
khushiyadavsap

Prerequisites

  • Step 1

    The Desktop Agent 3 is an on-premise component of SAP Build Process Automation that is installed locally on user desktops. It executes automation projects that launch and run applications of various kinds, reads information from screens, enters data, clicks options, and processes data.

    The very first time you launch the Desktop Agent 3 on your workstation, you will be prompted to log in. If you are unsure of your login details, please ask an administrator.

  • Step 2

    CAUTION: If you are a P user, you will have to download the Desktop Agent 3 from the SAP Development Tools. Please choose option Manually.

  • Step 3

    When you install the Desktop Agent 3, it will automatically set up the SAP Build Process Automation web browser extension for Google Chrome and Edge.

    To prevent issues during the installation, please close all the Chrome or Edge tabs opened on your machine.

    The minimum version of the Desktop Agent supported by SAP Build Process Automation is 3.7.41.

    1. Open the downloaded file. Select Next to begin the installation process.

      Desktop Agent 3 Installation

      You can open the file with administrator rights, and install the service, only if your use case requires it. For example, using the agent in unattended mode in production. It is not required for following the tutorials.

    2. Wait for the installation process to complete.

      Desktop Agent 3 Installation
    3. Once the installation is successfully completed, choose Finish and launch the Desktop Agent 3.

      A Google Chrome extension and an Edge add-on are installed when you install the Desktop Agent but you have to enable them (at least the Google Chrome extension).

    4. On Google Chrome, select Manage extensions under Extensions.

      Manage extensions
    5. Enable SAP Build Process Automation extension.

      Enable extension
    6. Do the same for the Edge extension.

      Enable extension
  • Step 4

    Once the installation steps of the SAP Build Process Automation setup wizard are completed, you need to register your agent and connect it to a SAP Build Process Automation tenant in order to execute automations.

    The Agent icon will be available on your System Tray, when the Desktop Agent 3 is installed.

    Once you have completed the installation process of the SAP Build Process Automation setup, what needs to be done in order to execute automations?

  • Step 5
    1. Navigate back to Control Tower. Select Environments under Tenant Configuration.

      Environment
    2. Choose Create Environment.

    3. In the Create Environment window do the following:

      • Give your environment a name
      • Select a color
      • You may enter a short description
      • Choose Create
      Create Environment
    4. Select the created environment to add your agent in it.

      Select environment
    5. Select Agent Management > Add Agent.

    6. In the Add Agent window, select your agent and choose Add agent.

      Agent Management Add
    7. Your agent is now added and ready to run.

      Agent Management List

Back to top