Healing Agent user guide

Last updated May 9, 2025

Setup

Activity-level configuration

Before starting setup procedures, ensure you meet the Healing Agent Prerequisites.

You can also filter Healing Agent features at the activity level, for each individual activity:

Disabled—Disables Healing Agent.
Inherit job settings—Inherits all settings from Orchestrator.
Recommendation only—Healing Agent only provides recommendations, and does not heal the automation.
Same as app/browser—Inherits the AppCard settings.

If you disable all settings in Orchestrator, modifying settings at the activity level does not affect Healing Agent.

Unattended setup

Note:

You must have the role permission of Automation Developer or higher, as well as the following permissions:

Process.Edit
MediaExecution.View
MediaExecution.Create
MediaExecution.Delete

Healing Agent is currently available only for processes executed as jobs.

In Studio, open an existing project or create a new one.
1. If you have not done so already, update to version 25.10.2 or later of the UIAutomation.Activities package.
2. Optionally, we recommend you enable the Verify Execution feature, as Healing Agent relies on this feature for input actions.
  
  In addition, if you have any activities that are not connected to Orchestrator, use the Synchronize Object Repository feature at this time to add all activities to Orchestrator.
3. Publish your project.
Go to Orchestrator.
1. Select Add process, then Additional settings.
2. Enable Healing Agent either at the process level, or at the job level.
  
  You can configure self-healing independently at this time, across both the process and job levels.
  
  Note:
  If you do not activate self-healing, Healing Agent only provides detailed debug information and limited recommendations, and does not take any autonomous actions.
Figure 1.
1. Create a new job based on the process you published in step 4.
  
  Figure 2.
Run your job.
1. To check the job results, select Job Details, then select Healing Agent.
  
  The Healing Agent panel displays only if the job involved at least one recommendation or healed action.
2. Select Download the debug file.

If the automation project is in your workspace and Studio is connected to the Orchestrator tenant, you can select Open in Studio to directly open the debug file in Studio.

Otherwise, open the Autopilot panel in Studio and select Import debug file.

Attended setup

Note:

You must have the role permission of Automation User or higher, as well as the following permissions:

Process.Edit
MediaExecution.View
MediaExecution.Create
MediaExecution.Delete

In Studio, open an existing project or create a new one.
1. If you have not done so already, update to version 25.2.1-preview (or higher) of the UIAutomation.Activities package.
2. Optionally, we recommend you enable the Verify Execution feature, as Healing Agent relies on this feature for input actions.
  
  In addition, if you have any activities that are not connected to Orchestrator, use the Synchronize Object Repository feature at this time, to add all activities to Orchestrator.
Publish your project.
Go to Orchestrator.
1. Select Add process, then Additional settings.
2. Create a new process based on the automation you published.
3. Enable Healing Agent either at the process level, or at the job level.
  
  You can configure self-healing independently at this time, across both the process and job levels. If you do not activate self-healing, Healing Agent only provides detailed debug information and limited recommendations, and does not take any autonomous actions.
Run your automation from Assistant.

Ensure you selected the Report Exception option at runtime.
1. To check the job results, select Job Details, then select Healing Agent.
  
  The Healing Agent panel displays only if the job involved at least one recommendation or healed action.
2. Select Download the debug file.