Configuração

Configuração no nível de atividade

Antes de iniciar os procedimentos de configuração, certifique-se de atender aos pré-requisitos do Healing Agent.

Você também pode filtrar as funcionalidades do Healing Agent no nível da atividade, para cada atividade individual:

• Desabilitado — desabilita o Healing Agent.
• Configurações de trabalho herdadas—herda todas as configurações do Orchestrator.
• Apenas recomendação— o Healing Agent fornece apenas recomendações e não corrige a automação.
• Igual ao aplicativo/navegador— herda as configurações do Cartão do Aplicativo.

Se você desabilitar todas as configurações no Orchestrator, a modificação das configurações no nível de atividade não afetará o Healing Agent.

Configuração Não Assistida

Observação:

Você deve ter a permissão de função de Automation Developer ou superior, além de ter as seguintes permissões:

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

O Healing Agent está disponível apenas para processos executados como trabalhos.

1. No Studio, abra um projeto existente ou crie um novo.

   a. Se você ainda não o fez, atualize para a versão 25.10.2 ou posterior do pacote UIAutomation.Activities . b. Opcionalmente, habilite a funcionalidade Verificar execução , da qual o Healing Agent depende para ações de entrada. Se você tiver alguma atividade que não esteja conectada ao Orchestrator, use o recurso Sincronizar Repositório de Objetos para adicionar todas as atividades ao Orchestrator. c. Publique seu projeto.

2. Acesse o Orchestrator.

   a. Selecione Adicionar processo. b. Selecione Configurações adicionais. c. Habilite o Healing Agent no nível do processo ou no nível do trabalho. Você pode configurar a autocorreção de forma independente tanto no nível do processo quanto no de trabalho.

   Observação:

   Se você não ativar a autocorreção, o Healing Agent fornece apenas informações detalhadas de depuração e recomendações limitadas e não realiza nenhuma ação autônoma.

   

   d. Crie um novo trabalho com base no processo que você publicou.

   

3. Selecione Executar para executar seu trabalho.

   a. Selecione Detalhes do trabalho. b. Select Healing Agent. c. Selecione Baixar o arquivo de depuração.

Resultado: o painel Healing Agent é exibido apenas se o trabalho envolveu pelo menos uma recomendação ou ação corrigida. Se o projeto de automação estiver no seu espaço de trabalho e o Studio estiver conectado ao tenant do Orchestrator, você poderá selecionar Abrir no Studio para abrir o arquivo de depuração diretamente no Studio. Caso contrário, abra o painel Autopilot no Studio e selecione Importar arquivo de depuração.

Observação:

Se o Healing Agent não puder recuperar uma atividade, os logs do robô no Orchestrator mostram o motivo da falha, por exemplo, "O Healing Agent não pôde recuperar a atividade". A autocorreção está desabilitada."

Configuração Assistida

Observação:

Você deve ter a permissão de função de Automation User ou superior, e as seguintes permissões:

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

1. No Studio, abra um projeto existente ou crie um novo.

   a. Se você ainda não o fez, atualize para a versão 25.2.1-preview ou posterior do pacote UIAutomation.Activities . b. Opcionalmente, habilite a funcionalidade Verificar execução , da qual o Healing Agent depende para ações de entrada. Se você tiver alguma atividade que não esteja conectada ao Orchestrator, use o recurso Sincronizar Repositório de Objetos para adicionar todas as atividades ao Orchestrator.

2. Publique seu projeto.

3. Acesse o Orchestrator.

   a. Selecione Adicionar processo. b. Selecione Configurações adicionais. c. Crie um novo processo com base na automação que você publicou. d. Habilite o Healing Agent no nível do processo ou no nível do trabalho. Você pode configurar a autocorreção de forma independente tanto no nível do processo quanto no de trabalho. Se você não ativar a autocorreção, o Healing Agent fornece apenas informações detalhadas de depuração e recomendações limitadas e não realiza nenhuma ação autônoma.

4. Execute sua automação no UiPath Assistant. Certifique-se de selecionar a opção Reportar Exceção no runtime.

   a. Selecione Detalhes do trabalho. b. Select Healing Agent. c. Selecione Baixar o arquivo de depuração.

Resultado: o painel Healing Agent é exibido apenas se o trabalho envolveu pelo menos uma recomendação ou ação corrigida. Para visualizar o arquivo de depuração, abra o painel Autopilot no Studio e selecione Importar arquivo de depuração.

Configuração Bring-your-own-model (BYOM)

Para usar suas próprias assinaturas de LLM, configure-as por meio das configurações de LLM na AI Trust Layer:

1. Na plataforma de Automation Cloud™, navegue até Admin.
2. Selecione AI Trust Layer e, em seguida, selecione a guia Configurações de LLM.
3. Selecione um tenant no menu suspenso Tenant e, em seguida, selecione Adicionar configuração.
4. No painel Adicionar configuração, siga as seguintes etapas: a. Selecione Healing Agent no menu suspenso Produto.b.Selecione Recuperação do fluxo de trabalho no menu suspenso Funcionalidade.c.Selecione Substituir assinatura de LLM da UiPath. d. No menu suspenso Pasta, selecione a pasta na qual você deseja armazenar sua conexão do LLM.
   Observação:

   Evite armazenar sua conexão de LLM em uma pasta compartilhada com outros usuários.As credenciais salvas em pastas compartilhadas podem ser acessadas por qualquer pessoa com acesso às pastas e podem expor as chaves de API ou dados de modelo da sua organização.

   e. Para seu LLM substituível, selecione um conector no menu suspenso Conector e, em seguida, selecione Adicionar conexão no menu suspenso Conexão . f. Uma nova guia se abre. Preencha os campos necessários para conectar o UiPath ao seu conector selecionado e, em seguida, selecione Teste no painel Adicionar configuração . G. Selecione Salvar.

Resultado: o Healing Agent usa sua assinatura de LLM configurada para a recuperação do fluxo de trabalho.

Para obter mais informações, consulte Configuração de LLMs.

Uso do Autopilot para analisar sugestões de debug do Healing Agent no Studio 2025.10

Se você usar o Studio 2025.10 ou posterior, pode aproveitar o Autopilot para analisar automaticamente as sugestões de depuração do Healing Agent para trabalhos executados do projeto aberto no momento.

Com base no status de sua conexão do tenant entre o Studio e o Orchestrator, siga as etapas que correspondem ao seu caso nas duas opções a seguir:

Opção 1: se suas contas do Studio e do Orchestrator estiverem conectadas ao mesmo tenant em que os trabalhos foram executados, o Autopilot analisa automaticamente as sugestões de depuração do Healing Agent sem qualquer entrada manual. Se esse for o seu caso, siga as seguintes etapas:

1. Acesse o Studio e abra um projeto existente ou crie um novo.

Observação:

Certifique-se de fazer login no Studio e no Orchestrator com a mesma conta com a qual você publica e executa seu projeto.

2. No painel Autopilot, selecione uma das seguintes solicitações predefinidas: Carregar dados do Healing Agent a partir do arquivo ou Analisar dados de execução do Healing Agent ou insira sua própria solicitação ao interagir com o Autopilot.

3. Após o relatório de dados de Runtime Healing ser exibido, você pode expandir manualmente todas as atividades afetadas e selecionar Aplicar para implementar as alterações sugeridas.

Opção 2: se suas contas do Studio e do Orchestrator não estiverem conectadas ao mesmo tenant em que os trabalhos foram executados, você pode baixar manualmente o arquivo de depuração do Healing Agent a partir do Orchestrator e importá-lo para o Studio. Se esse for o seu caso, siga as seguintes etapas:

1. Acesse o Orchestrator.
2. Na visualização Trabalhos, selecione Detalhes do trabalho e, em seguida, selecione Healing Agent. O painel Healing Agent é exibido apenas se o trabalho envolveu pelo menos uma recomendação ou ação corrigida.
3. Selecionar Download o Debug Arquivo.
4. Acesse o Studio e abra o projeto existente para o qual você baixou o arquivo de debug.
5. No painel Autopilot, selecione uma das seguintes solicitações predefinidas: Carregar dados do Healing Agent a partir do arquivo ou Analisar dados de execução do Healing Agent ou insira sua própria solicitação ao interagir com o Autopilot, como "Importar arquivo ZIP de debug".
6. Após o relatório de dados de Runtime Healing ser exibido, você pode expandir manualmente todas as atividades afetadas e selecionar Aplicar para implementar as alterações sugeridas.