robot
2022.10
false
Importante :
A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.
UiPath logo, featuring letters U and I in white

Guia do administrador do UiPath Robot

Última atualização 6 de fev de 2026

Arquivos de configuração

Descrição do arquivo UiPath.Settings

O arquivo UiPath.Settings contém todos os detalhes necessários sobre como o Robô executa processos. Você pode modificar essas configurações editando diretamente o arquivo e os campos correspondentes. Por outro lado, você pode modificá-los por meio do Orchestrator. Isso é feito a partir da aba Configurações.
Observação: note que os direitos de administrador e do sistema local são necessários para modificar essas configurações. Você deve reiniciar o serviço do UiPath Robot (são necessários direitos de administrador para fazer isso) e fechar a bandeja do Robô para que as alterações entrem em vigor.
O arquivo UiPath.Settings é armazenado na pasta %localappdata%\UiPath\ quando o Robô é implantado no modo de usuário e %programdata%\UiPath\ quando o Robô é implantado no modo de serviço. Ele é criado na primeira vez que o serviço do UiPath Robot é iniciado. Contém os seguintes parâmetros:

Parâmetro

Description

NuGetApiKey

A chave de API do feed do NuGet.

Quando não estiver conectado ao Orchestrator, se você estiver usando um feed local, ele não requer uma chave de API.Se você usar um feed do MyGet privado, observe que este parâmetro é necessário.

Quando conectado ao Orchestrator, esse valor não é considerado.

NuGetServerUrl

O local em que os projetos são enviados e de onde são recuperados. Pode ser um feed local, como um caminho de sistema de arquivos, ou um feed da Web que usa o protocolo NuGet (NuGet, MyGet etc.).

Quando não estiver conectado ao Orchestrator, o valor padrão é %ProgramData%\UiPath\packages (modo de usuário) ou `%. Se você usar um feed do MyGet privado, use a URL fornecida em Sua URL do V2 pré-autenticada (sem autenticação básica). Observe que este não é um serviço gratuito do MyGet.

Quando conectado ao Orchestrator, esse valor não é considerado.

Feed de Atividades

O endereço em que as atividades são armazenadas. Este campo é preenchido apenas se você não estiver conectado ao Orchestrator. Por padrão, o valor é ~/NuGetPackages/Activities. Se você se conectar ao Orchestrator, este campo não é considerado. Saiba mais sobre os feeds de atividades nesta página, bem como onde os pacotes são instalados com base no tipo de implantação do Robô.

UiPathServerUrl

O endereço da sua instância do Orchestrator.

Quando não estiver conectado ao Orchestrator, este parâmetro está vazio.

Quando conectado ao Orchestrator, ele é preenchido automaticamente com a URL que você forneceu na janela Configurações do Orchestrator.

Nível de rastreamento

O nível no qual o Robô deve registrar informações. As seguintes opções estão disponíveis: Verboso, Rastreamento, Informação, Aviso, Erro, Crítico e Desligado.

Isso também pode ser alterado a partir da janela de Configurações do Orchestrator, a partir da lista suspensa Nível.

Rastreamento de baixo nível

Indica se as informações devem ser registradas em um nível de rastreamento para ajudar você a solucionar falhas e erros. Por padrão, este parâmetro é definido como false. Para iniciar rastreamento de baixo nível, defina o valor deste parâmetro como true. Você também pode alterar este valor a partir da linha de comando.

SecureLicenseKey

A Chave de Máquina que é usada para se conectar ao Orchestrator.A chave é criptografada no arquivo da UiPath.settings usando DPAPI. Esse valor também pode ser preenchido e modificado a partir da janela de Configurações do Orchestrator. Se não estiver conectado ao Orchestrator, esse parâmetro deve estar vazio.

LogonNoConsole

Permite que o Robô se conecte à sessão de console da máquina em que está instalado. Além disso, indica se você pode conectar vários Robôs ao Orchestrator usando muitos usuários (Robôs de Alta Densidade) ou não. Por padrão, o valor é true. Para habilitar Robôs de Alta Densidade, defina o valor como false.

Largura da Resolução

A largura de resolução de exibição da máquina. Esta opção é definida como 0 por padrão, o que significa que ela recupera e usa automaticamente a largura de resolução detectada. Você pode usar um valor personalizado, desde que ele seja compatível com a estação de trabalho.

Altura da Resolução

A altura de resolução de exibição da máquina. Esta opção é definida como 0 por padrão, o que significa que ela recupera e usa automaticamente a altura de resolução detectada. Você pode usar um valor personalizado, desde que ele seja compatível com a estação de trabalho.

Intensidade da Resolução

A profundidade de resolução de exibição da máquina. Esta opção é definida como 0 por padrão, o que significa que ela recupera e usa automaticamente a profundidade de resolução detectada. Você pode usar um valor personalizado, desde que ele seja compatível com a estação de trabalho.

Fonte Suavizada

Aumenta o reconhecimento de texto. Se estiver definido como True, a opção de Suavização de Fonte em conexões RDP é ativada. Isso significa que a máquina de destino terá o ClearType habilitado.

ConnectionString

Uma string gerada a partir do Orchestrator que permite que você registre seu Robô sem fornecer o Nome da Máquina e a Chave da Máquina.

DisableWorkflowExecution

Desabilita a possibilidade de executar processos a partir da linha de comando quando habilitado. Por padrão, essa funcionalidade está oculta e desabilitada.

webProxySettings

Parâmetro usado para configurar as Configurações de Proxy para o Robô. Saiba mais no documento Redirecionando Robôs por meio de um Proxy.

Variáveis do sistema do UiPath Robot

O comportamento personalizado adicional pode ser configurado por meio de variáveis de ambiente do sistema.

Importante:

Depois de modificar qualquer uma das variáveis do sistema, reinicie o Serviço de Robôs da UiPath.

A lista a seguir resume os casos de uso mais comuns:

Variável do sistema

Uso

Exemplo

UIPATH_SESSION_TIMEOUTAltera o tempo limite padrão de 60 segundos para criar uma sessão interativa.

Ajuste esse valor para adaptar o comportamento do Robô com base no desempenho e nos tempos de carregamento do sistema com o qual ele interage.

UIPATH_SESSION_TIMEOUT=75UIPATH_SESSION_TIMEOUT=75
UIPATH_PIP_SESSION_TIMEOUT

Altera o tempo limite padrão de 180 segundos para o início de um processo em uma sessão do Robô.

UIPATH_PIP_SESSION_TIMEOUT=60UIPATH_PIP_SESSION_TIMEOUT=60
UIPATH_LANGUAGE

Define o idioma em que o Robô opera.

A ordem para determinar o idioma é:

  1. Valor UIPATH_LANGUAGE
  2. A variável de ambiente da máquina

  3. A cultura de interface do usuário do tópico atual

  4. Idioma padrão do UiPath (inglês)

UIPATH_LANGUAGE=FrenchUIPATH_LANGUAGE=French
UIPATH_HEADLESS_WITH_USER

Usa as credenciais de um usuário específico, que foi configurado anteriormente no Orchestrator.

UIPATH_HEADLESS_WITH_USER=TrueUIPATH_HEADLESS_WITH_USER=True
UIPATH_PRE_LOADED_EXECUTOR

Por padrão, um executor pré-carregado é lançado quando o robô é iniciado.

Para alterar esse comportamento e lançar o executor pré-carregado apenas quando o primeiro processo for executado, defina essa variável como None.
UIPATH_PRE_LOADED_EXECUTOR=NoneUIPATH_PRE_LOADED_EXECUTOR=None
UIPATH_DISABLE_PRE_LOADED_EXECUTOR

Desabilita a funcionalidade de executor pré-carregado.

UIPATH_DISABLED_PRE_LOADED_EXECUTOR=TrueUIPATH_DISABLED_PRE_LOADED_EXECUTOR=True
UIPATH_ROBOTJS_ALLOWLIST

Aceita automaticamente o diálogo de consentimento do robô, ao estabelecer a conexão entre o SDK do Robot JS e o Executor. do robô.

A variável aceita URLs de aplicativos personalizados, separados por ponto e vírgula. Inclua o número da porta na URL se ele diferir das portas padrão (80 ou 443).

UIPATH_ROBOTJS_ALLOWLIST=cloud.uipath.com;mydomain.com;UIPATH_ROBOTJS_ALLOWLIST=cloud.uipath.com;mydomain.com;
UIPATH_DNS_MACHINENAME

Permite o uso do nome de host DNS para Localhost ao criar sessões RDP. Para executar trabalhos unattended em ambientes com autenticação Kerberos para RDP, defina esse valor como True.

UIPATH_DNS_MACHINENAME=TrueUIPATH_DNS_MACHINENAME=True
UIPATH_PROXY_USE_DEFAULT_CREDENTIALS

Permite que o robô manipule configurações do proxy que usam Credenciais do Windows para autenticação.

UIPATH_PROXY_USE_DEFAULT_CREDENTIALS=TrueUIPATH_PROXY_USE_DEFAULT_CREDENTIALS=True
NUGET_FALLBACK_PACKAGES

Configura os caminhos para pastas de pacotes de fallback. Use ponto e vírgula para separar vários caminhos.

Na ausência dessa variável, o Robô pesquisa por pastas de pacotes de fallback no arquivo Nuget.config.
 
NUGET_SCRATCH

Permite que vários robôs em Modo de Usuário na mesma máquina compartilhem um caminho local para armazenar pacotes.

O valor deve ser um caminho diferente da pasta de instalação do Nuget e atua como uma pasta temporária para o NuGet.

Observação:
Apenas a variável NUGET_SCRATCH deve usar a pasta temporária configurada.
NUGET_SCRATCH=C:\NuGetTempFolderNUGET_SCRATCH=C:\NuGetTempFolder
UIPATH_PRESERVE_CREDENTIALS_CASE

Preserva o uso original de maiúsculas/minúsculas das credenciais de registro (domínio\nome de usuário).

UIPATH_PRESERVE_CREDENTIALS_CASE = TrueUIPATH_PRESERVE_CREDENTIALS_CASE = True

Reinicialização de componentes dos Robots

Lembre-se de salvar algum trabalho em andamento antes de reiniciar para evitar perder qualquer progresso não salvo.

  • Serviço de robôs
    • Instalação do Modo de Serviço
      1. Abra Gerenciador de tarefas > Serviços.
      2. Procure o serviço UiPathRobotSvc.
      3. Clique com o botão direito do mouse no serviço e selecione Reiniciar.
    • Instalação do Modo Usuário - Encerre, depois reinicie o Assistant, ou:
      1. Abra Gerenciador de tarefas > Detalhes.
      2. Selecione o processo UiPath.Service.UserHost.exe.
      3. Selecione Encerrar tarefa.
  • Atualizar Serviço
    1. Abra Gerenciador de tarefas > Serviços.
    2. Procure o serviço UiPath.UpdateService.Agent.
    3. Clique com o botão direito do mouse no serviço e selecione Reiniciar.
  • UiPath RobotJS ServiceHost
    1. Abra Gerenciador de tarefas > Serviços.
    2. Procure o serviço UiPath.RobotJS.ServiceHost.
    3. Clique com o botão direito do mouse no serviço e selecione Reiniciar.
  • UiPath Assistant
    1. No UiPath Assistant, selecione Preferências e, em seguida, Sair.
    2. Reinicie o UiPath Assistant.
  • Widgets - Reiniciar o Assistant ou:
    1. Clique com o botão direito do mouse no ícone do UiPath Assistant na barra de tarefas.
    2. Selecione Recarregar Widgets

Esta página foi útil?

Conectar

Precisa de ajuda? Suporte

Quer aprender? Academia UiPath

Tem perguntas? Fórum do UiPath

Fique por dentro das novidades