Executor do Robot

Configure e gerencie o UiPath Executor, o componente do UiPath Robot que executa fluxos de trabalho de automação em sessões isoladas.

UiPath Executor is a component of the UiPath software structure that is used to run automations or jobs. It is the component that actually executes the automation workflows, and you can identify it in the list of running processes as UiPath.Executor.exe.

Como funciona

Durante um ciclo de vida de automação, o Executor representa o estágio de execução:

1. Estágio de projeto — depois que um fluxo de trabalho de automação é projetado e criado no Studio, ele será publicado no Orchestrator.
2. Estágio do Orchestrator — O Orchestrator é o componente que gerencia, controla e registra as operações executadas pelos Robôs. Aqui, você pode agendar um trabalho ou executá-lo sob demanda.
3. Estágio de execução — quando uma tarefa é agendada ou disparada, o Orchestrator envia um comando para o Serviço de Robôs da UiPath.Em seguida, o Serviço de Robôs da UiPath inicia instâncias do UiPath Executor para executar a tarefa de automação. Cada instância opera em uma sessão isolada, garantindo que, se uma tarefa falhar, as outras permanecerão inalteradas.
4. Estágio de pós-execução — Quando a tarefa é concluída, as instâncias do Executor serão encerradas, e os resultados serão enviados de volta ao Orchestrator. Detalhes como tempo de execução, status (sucesso ou falha) e quaisquer exceções são registrados e podem ser analisados para solução de problemas ou melhoria do processo.

Capabilities

Alguns dos recursos do Executor incluem:

• Execução de tarefas locais ou remotas — o UiPath Executor pode executar tarefas no dispositivo local onde o Serviço de Robôs da UiPath está instalado, ou ele pode se conectar a outros dispositivos remotamente e executar tarefas lá.
• Execução de trabalhos simultaneamente — o Executor é capaz de executar várias automações ao mesmo tempo, cada uma operando como uma sessão independente.
• Balanceamento de carga e priorização de tarefas — Juntamente com o UiPath Orchestrator, o Executor pode ajudar a balancear cargas de automação em vários Robôs e priorizar tarefas com base em regras predefinidas.
• Manutenção do isolamento do fluxo de trabalho — cada execução no Executor é isolada, o que implica que um erro ou falha em um trabalho não afeta o desempenho do resto.
  Observação:

  O Executor se ajusta a diferentes configurações de DPI, permitindo que os fluxos de trabalho sejam executados em qualquer resolução. Se alguns aplicativos não puderem lidar com o DPI, você poderá desabilitar essa funcionalidade específica.

Tipos de Executores baseados em projetos de automação

Com base no projeto de automação, o Serviço de Robôs da UiPath inicia o tipo de Executor relevante destinado a executar a automação. As tabelas a seguir resumem os tipos de projetos que um Executor pode realizar, com base na estrutura de destino usada.

Tipo de projeto/Executor	Arquitetura	SO compatível	Estrutura usada
Windows - Legacy	32 bits	Windows (x64 e x86)	.NET Framework 4.7.2
Windows	64 bits	Windows x64	.NET 10 with Windows support (.NET Core - Windows)
Multiplataforma	64 bits	Windows, Linux (64-bit)	.NET 10 with cross-platform support (.NET Core)

Cada linha na tabela representa um tipo de Executor diferente, mostrando como ele está configurado para realizar projetos com base nos requisitos específicos do tipo de projeto, do sistema operacional de destino e da versão do .NET Framework usada. Essas informações ajudam a entender qual Executor é apropriado para cada projeto, garantindo a compatibilidade com o ambiente de destino e aproveitando os recursos de estrutura relevantes.

The Executor and executor packages

The Executor is the .NET executor of Unified Runtime, and runs RPA processes and test cases. By default, agents, functions, and API workflows don't run in UiPath.Executor.exe. They run in executor packages, in a separate host process that the Robot Service starts. The settings on this page, such as preloaded executors, Medium+ integrity, and UIPATH_HEADLESS_WITH_USER, apply to the Executor only.

Configurações do usuário para o Executor

The Executor has a dedicated system variable UIPATH_HEADLESS_WITH_USER, which you can configure depending on the type of user that runs the automation.

When the user is Local Service, you can run background automations. Here, the setting for UIPATH_HEADLESS_WITH_USER should either be Falseor not set at all.

When the user running the automation has credentials specified in Orchestrator, there are two scenarios you should consider:

• For background automations, the UIPATH_HEADLESS_WITH_USER setting should be True.
• For foreground automations, there should be no UIPATH_HEADLESS_WITH_USER variable set.

A tabela a seguir resume as condições do usuário para o Executor.

Tipo de Usuário	Tipo de automação	UIPATH_HEADLESS_WITH_USER Configuração
Local Service	Segundo plano	False ou nulo
Usuário configurado no Orchestrator	Segundo plano	True
	Primeiro plano	Não há necessidade de uma variável

Executor pré-carregado

Usually, each process requires time to load the required workflow, packages, and libraries into memory before it can start processing. In a preloaded setup, those dependencies are already loaded into memory, in dedicated execution slots. A preloaded executor is enabled by default in User Mode. Preloaded executors exist only in User Mode: in Service Mode, the Robot doesn't start them, and the variables below have no effect.

Aqui estão alguns detalhes importantes sobre o Executor pré-carregado:

• Execução mais rápida: ao pré-carregar o processo, seus Robôs podem começar a trabalhar em suas tarefas muito mais rapidamente.
• Utilização de recursos: com um Executor pré-carregado, os Robôs consomem menos recursos por já terem os fluxos de trabalho necessários carregados na memória.
• Disponibilidade: os Executores pré-carregados são projetados principalmente para automações attended iniciadas a partir do UiPath Assistant, RobotJS, Studio ou a interface de linha de comando.Trabalhos Unattended do Orchestrator iniciam um único Executor não pré-carregado.

Variáveis do sistema para configuração pré-carregada

You can manage the behavior of preloaded executors by setting specific environment variables on the robot machine, as follows. They apply to User Mode robots only:

Variável de ambiente	Valor	Description
UIPATH_PRE_LOADED_EXECUTOR	Nenhum	Substitui o comportamento padrão e inicia o Executor pré-carregado apenas quando o primeiro trabalho é iniciado.
UIPATH_DISABLE_PRE_LOADED_EXECUTOR	True	Desabilita o Executor pré-carregado.

Como funciona

Quando você adiciona a variável UIPATH_PRE_LOADED_EXECUTOR a seu sistema, você define uma configuração pré-carregada. Isso inicia dois Executores: um sempre que um trabalho é iniciado e outro para aguardar trabalhos futuros - o Executor pré-carregado.Quando outro trabalho é iniciado, ele usa o Executor pré-carregado e gera outro Executor pré-carregado para aguardar o próximo trabalho. Em suma, uma configuração pré-carregada sempre garante que haja um Executor disponível à espera de trabalhos.

Executores e sistemas operacionais pré-carregados

For Windows devices, when UiPath.Service.UserHost.exe starts in User Mode, it launches two preloaded executors: one for Windows projects, and another for Windows-Legacy projects.

Elevação de integridade Média+

Alguns aplicativos do Windows são executados em um nível de integridade mais alto do que a sessão do usuário padrão. Um exemplo comum é a caixa de diálogo CredentialBroker do Windows, que aparece quando você insere um nome de usuário e senha para conectar-se a uma sessão de Área de Trabalho Remota (RDP). Como o CredentialBroker é executado no nível de integridade Médio+, o executor não pode interagir com ele por padrão, e sua automação não digita credenciais na caixa de diálogo.

Para habilitar o Executor a automatizar essas janelas, defina a variável de ambiente da máquina (sistema) UIPATH_MEDIUMPLUS_EXECUTOR como 1. Quando essa variável é definida, o serviço de Robôs da UiPath inicia o executor no nível de integridade Médio+, permitindo que ele interaja com janelas que, de outra forma, ficariam inacessíveis.

Alternativamente, para elevar apenas invocações específicas em vez de todo o Executor, defina a variável UIPATH_MEDIUMPLUS_INVOKE de ambiente da máquina (sistema) como 1. Quando essa variável está habilitada, as atividades Invoke Workflow File e Invoke Process podem ser executadas no nível de integridade Médio+ por invocação, deixando o restante da automação no nível de integridade padrão.

A elevação aplica-se apenas a invocações que a solicitam — você também deve habilitar a opção de elevação da atividade; a variável por si só não eleva nada.

A opção de elevação requer o UiPath.System.Activities 26.6.0 ou posterior e, para o Invoke Workflow File, ela se aplica apenas quando você invoca o fluxo de trabalho de modo Isolado.Assim como o UIPATH_MEDIUMPLUS_EXECUTOR, essa funcionalidade é apenas do Windows e requer que você habilite o UAC.

Requisitos

• Windows only — this feature is not available on Linux.
• O UAC deve estar habilitado — a elevação depende de o Controle de contas de usuários estar ativo na máquina. Se o UAC estiver desabilitado, a variável será ignorada e o executor será iniciado no nível de integridade padrão.
• Modo de instalação — o robô deve ser instalado no modo de serviço ou no modo de usuário com uma instalação por máquina (instalada em Program Files).As instalações por usuário não são compatíveis com elevação Média+.
• Variável no nível de máquina — a variável deve ser definida como uma variável de ambiente de máquina (sistema), tanto para automações assistidas quanto não assistidas. Uma variável no nível de usuário não tem efeito; a elevação é habilitada apenas quando a variável é definida no nível de máquina.

Como habilitar

1. Abra Propriedades do sistema > Variáveis de ambiente na máquina do robô.
2. Na seção Variáveis do sistema, selecione Nova. A variável deve ser definida no nível de máquina (sistema); uma variável no nível de usuário não tem efeito.
3. Defina o nome da variável como UIPATH_MEDIUMPLUS_EXECUTOR e o valor como 1.
4. Selecione OK para salvar a variável.
5. Reinicie o serviço do robô para que a alteração entre em vigor.

Resultado

Após habilitar a elevação Média+, suas automações podem interagir com a caixa de diálogo CredentialBroker e outras janelas que exigem integridade Média+. Se UIPATH_MEDIUMPLUS_EXECUTOR for definido, o Executor é executado elevado para toda a automação; se UIPATH_MEDIUMPLUS_INVOKE for definida, apenas as invocações que solicitam a elevação são executadas elevadas. Se o Executor não puder iniciar no nível elevado (por exemplo, porque o UAC está desabilitado), ele reverterá para o nível de integridade padrão e registrará um Warning.