Arquivos de configuração

Arquivos de configuração do Robô: locais, procedimentos de reinicialização para Modo de Serviço e Modo de Usuário, e configurações que controlam o comportamento do Robô.

Reinicialização de componentes dos Robots

Depois de editar os arquivos de configuração, você precisa reiniciar os componentes relevantes do Robô para que as alterações entrem em vigor. A lista a seguir resume como reiniciar vários componentes, com base no modo de instalação do robô.

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. Abra o menu de contexto para o 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. Abra o menu de contexto para o serviço e selecione Reiniciar.

• UiPath RobotJS ServiceHost

  1. Abra Gerenciador de tarefas > Serviços.
  2. Procure o serviço UiPath.RobotJS.ServiceHost.
  3. Abra o menu de contexto para o 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. Abra o menu de contexto para o ícone do UiPath Assistant na barra de tarefas.
  2. Selecione Recarregar Widgets

uipath.config

O arquivo UiPath.config contém parâmetros de configuração essenciais para o robô. Como administrador, você pode personalizar o comportamento de seus robôs editando a lista de parâmetros no arquivo de configuração.

Observação:

Cada ambiente pode precisar de avisos específicos, portanto, o UiPath permite que você aplique diferentes configurações com base no ambiente atual do robô, seja Desenvolvimento, Preparação ou Produção. Sempre tenha cuidado ao editar esse arquivo, pois a configuração imprecisa pode causar problemas de aplicativos.

Importante:

A partir do Robô 2025.10, as configurações de proxy são configuradas em proxy.json, não em UiPath.config. Para obter detalhes, consulte proxy.json.

Acessando o arquivo

Quando você instala seu robô, o sistema cria o arquivo UiPath.config.

Para acessá-lo, navegue até C:\Program Files\UiPath\Studio\UiPath.config.

Configurações personalizáveis

O arquivo UiPath.config consiste nos seguintes parâmetros:

• Na seção de configuração connectionSettings

  • DefaultServiceUrl (string) - Define o endereço padrão que o robô usa para conectar-se ao Orchestrator.

    Exemplo:

    string DefaultServiceUrl = "https://cloud.uipath.com"
    

  • AutoSignIn (bool) - Habilita a funcionalidade de login automático para o Assistant. O valor padrão é false.

    Exemplo:

    bool AutoSignIn = true.
    

  • EnforceDefaultServiceUrl (bool) - Impõe o endereço fornecido como DefaultServiceUrl para todos os usuários. O valor padrão é false.

    Exemplo:

    bool EnforceDefaultServiceUrl = true.
    

• Na seção de configuração communicationSettings

  • MaxMessageSizeInMegabytes (byte) - Define o tamanho máximo de uma mensagem que o sistema pode enviar ou receber, em MB. O valor padrão é 10.

    Isso é usado para evitar sobrecarga ou falhas no processo devido ao processamento de mensagens muito grandes.

    Exemplo:

    byte MaxMessageSizeInMegabytes = 10;
    

  • InstallPackageTimeout (TimeSpan) - Define o limite de tempo para instalações de pacotes.O valor padrão é 20 minutos.

    Se uma instalação de pacote levar mais tempo do que o tempo definido, o sistema aborta a instalação.

    Exemplo:

    TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);
    

  • RequestTimeout (TimeSpan) - Define quanto tempo o sistema aguarda por uma resposta de comunicação. O valor padrão é 40 segundos.

    Se o sistema não receber uma resposta no período definido, ele para e encaminha.Isso impede travamentos do sistema.

    Exemplo:

    TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);
    

• Na seção de configuração packageSettings

  • PackagesInstallationFolder (string) - Define o diretório padrão onde os pacotes são instalados. O valor padrão é C:\UiPath\Packages.

  • SkipHttpConfigurationSources (bool) - Permite que o sistema ignore fontes de pacotes configuradas por HTTP, como feeds do NuGet.O valor padrão é false.

    Isso significa que o sistema não recupera pacotes dessas fontes, o que é útil quando as fontes não são confiáveis ou seguras.

  • DisableSecureXaml (bool) - Permite que o robô execute fluxos de trabalho potencialmente inseguros.O valor padrão é false.

  • DirectDownload (bool) - Permite o download direto de pacotes, sem solicitar ao usuário. O valor padrão é false.

  • PackageSaveWithoutNupkg (bool) - Permite salvar os pacotes sem o arquivo .nupkg. O valor padrão é false.

    Isso é útil para reduzir o tamanho do download.

• Na seção de configuração analyticsSettings
  • Telemetry.Enabled (bool) - Permite que a UiPath colete e envie data de uso para análise. O valor padrão é false.
• Na seção de configuração robotCacheSettings

  • SessionCacheDuration (TimeSpan) - Define por quanto tempo os dados de uma sessão específica devem ser retidos no cache antes de serem descartados. O valor padrão é 30 segundos.

    Isso é útil para reutilizar dados como valores de variáveis ou detalhes de operações, em vez de recriá-los ou recuperá-los.

    Exemplo:

    TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);
    

  • GetResourceUrlCacheDuration (TimeSpan) - Define quanto tempo os URLs para recursos, como APIs ou páginas da web, são armazenados no cache. O valor padrão é 1 (uma) hora.

    Isso é útil para otimizar o desempenho em cenários em que seus robôs precisam acessar certos recursos regularmente.

    Exemplo:

    TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);
    

• Na seção de configuração robotJsSettings

  • ListenerPort (int) - Define o número da porta no qual o Robot.js escuta conexões de entrada.O valor padrão é 2323.

    Isso permite que o serviço de robôs da UiPath interaja com aplicativos web executados em servidores locais ou remotos.

    Exemplo:

    int ListenerPort = 2323;
    

  • TokenExpiryInDays (int) - Define o período de validade, em dias, de tokens de autenticação gerados pelo Serviço de Robôs da UiPath. O valor padrão é 30 dias.

    O serviço de robôs usa esses tokens para autenticar-se ao interagir com outros componentes ou serviços de software.

    Exemplo:

    int TokenExpiryInDays = 30;
    

  • AllowUrlList (string) - Define a lista de URLs que o serviço de Robôs da UiPath pode acessar. Isso ajuda a garantir que seu serviço de Robôs da UiPath interaja apenas com serviços aprovados.

    Exemplo:

    string AllowUrlList = "https://cloud.uipath.com";
    

Importante:

• Sempre crie uma cópia de segurança do arquivo original UiPath.config antes de fazer qualquer alteração. Isso pode ajudar a restaurar as configurações originais se algo der errado.
• Para aplicar as atualizações feitas ao arquivo UiPath.config, reinicie o serviço UiPath ou o sistema.
• As configurações locais no arquivo UiPath.config têm precedência sobre as configurações definidas no Orchestrator.
• Os dados confidenciais no arquivo UiPath.config podem ser criptografados para segurança adicional.

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:

• UIPATH_SESSION_TIMEOUT - Altera 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.

  Exemplo:

  UIPATH_SESSION_TIMEOUT=75
  

• UIPATH_PIP_SESSION_TIMEOUT - Altera o tempo limite padrão de 180 segundos para iniciar um processo em uma sessão de robô.

  Exemplo:

  UIPATH_PIP_SESSION_TIMEOUT=60
  

• UIPATH_LANGUAGE - Define o idioma em que o robô opera. A ordem de precedência é:

  1. Valor UIPATH_LANGUAGE
  2. Variável de ambiente da máquina
  3. Cultura da interface gráfica atual do thread
  4. Idioma padrão do UiPath (inglês)

  Exemplo:

  UIPATH_LANGUAGE=French
  

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

  Exemplo:

  UIPATH_HEADLESS_WITH_USER=True
  

• UIPATH_PRE_LOADED_EXECUTOR - Por padrão, um executor pré-carregado é iniciado 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.

  Exemplo:

  UIPATH_PRE_LOADED_EXECUTOR=None
  

• UIPATH_DISABLE_PRE_LOADED_EXECUTOR - Desabilita a funcionalidade de executor pré-carregado.

  Exemplo:

  UIPATH_PRE_LOADED_EXECUTOR=None
  

• 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).

  Exemplo:

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

• UIPATH_DNS_MACHINENAME - Permite o uso do nome do 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.

  Exemplo:

  UIPATH_DNS_MACHINENAME=True
  

• NUGET_FALLBACK_PACKAGES - Configura os caminhos para as pastas de pacotes 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 no 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.

  Exemplo:

  NUGET_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).

  Exemplo:

  UIPATH_PRESERVE_CREDENTIALS_CASE = True
  

• UIPATH_SESSION_BEHAVIOR - Configura a maneira como a restauração da sessão se comporta após a conclusão de um trabalho. As seguintes opções estão disponíveis:

  • TryReuseAndRestoreSession—Opção padrão. Tenta reutilizar a sessão e restaurá-la para o estado anterior após a conclusão da tarefa. Se não houver uma sessão inicial para reutilizar, ela será desconectada na restauração.
  • ForceNew—Cria uma sessão completamente nova, independentemente do estado da sessão anterior. Sempre desconecta ao restaurar.
  • LeaveSessionActive—Impede a restauração do estado da sessão inicial.
  • LeaveSessionDisconnected—Sempre desconecta a sessão ao restaurar.

  Exemplo:

  UIPATH_SESSION_BEHAVIOR = LeaveSessionDisconnected
  

• UIPATH_HTTP_CONNECTION_LIFETIME - Define por quanto tempo a conexão com o Orchestrator permanece aberta antes de ser fechada e atualizada. A duração padrão é de 30 minutos, mas para ajustar esse valor, use o valor especificado em segundos.

  Exemplo:

  // to set 10 minutes                          
  UIPATH_HTTP_CONNECTION_LIFETIME = 600
  

• UIPATH_FILE_LOG_LEVEL - Define o nível de log de execução usado no arquivo local. Isso é diferente do nível de log usado para o Orchestrator. As seguintes opções estão disponíveis:

  • Verbose
  • Trace
  • Information
  • Aviso
  • Erro
  • Crítica
  • Desativado

  Exemplo:

  // to set verbose level locally
  UIPATH_FILE_LOG_LEVEL = Verbose
  

• UIPATH_EXECUTOR_STARTUP_DELAY - Define o tempo em segundos para esperar entre a criação da sessão e a inicialização do Executor. Isso é usado quando sua infraestrutura necessita carregar alguns serviços (VPN, segurança) antes que a execução de sua automação comece.

  Exemplo:

  // to set the delay to 5 seconds
  UIPATH_EXECUTOR_STARTUP_DELAY = 5
  

• UIPATH_MEDIUMPLUS_EXECUTOR - Lança o Executor do Robô no nível de integridade Médio+, para que as automações possam interagir com janelas que exigem privilégios mais altos, como a caixa de diálogo Windows CredentialBroker, durante a entrada de credenciais no RDP. Defina como 1 para habilitá-lo. Requer o Windows com Controle de Conta de Usuário (UAC) Habilitado.Para obter mais informações, consulte Elevação de integridade Média+.

  Exemplo:

  UIPATH_MEDIUMPLUS_EXECUTOR=1
  

• UIPATH_MEDIUMPLUS_INVOKE - Permite que as atividades Invoke Workflow File e Invoke Process sejam executadas no nível de integridade Médio+ por invocação, sem elevar todo o Executor por meio de UIPATH_MEDIUMPLUS_EXECUTOR.Ambas as condições são necessárias para elevar: essa variável deve estar habilitada e a atividade deve solicitar a elevação (sua opção de elevação habilitada) — a variável por si só não tem efeito.A opção de elevação está disponível apenas com o UiPath.System.Activities 26.6.0 ou posterior, e para Invoke Workflow File, ela se aplica apenas quando o fluxo de trabalho é invocado isoladamente. Defina esta variável de ambiente da máquina (do sistema) como 1 para habilitá-la. Requer o Windows com Controle de Conta de Usuário (UAC) Habilitado.Para obter mais informações, consulte Elevação de integridade Média+.

  Exemplo:

  UIPATH_MEDIUMPLUS_INVOKE=1
  

proxy.json

O arquivo proxy.json armazena a configuração de proxy para o Serviço de Robôs da UiPath e o Update Worker quando eles são executados no modo de serviço.Disponível a partir do Robot 2025.10, ele substitui as Configurações de Proxy que eram mantidas anteriormente em UiPath.config.

Importante:

A partir do robô 2025.10, as configurações de proxy são configuradas em proxy.json.

Acessando o arquivo

Local do arquivo: %ProgramData%\UiPath\Shared\proxy.json

Observação:

Se você fizer a atualização de uma versão anterior e já tiver definido as configurações de proxy, o sistema migrará automaticamente suas configurações existentes para proxy.json.

Após editar proxy.json, reinicie o Serviço de Robôs da UiPath ou o dispositivo para que as alterações entrem em vigor.

Parâmetros

Os seguintes parâmetros são suportados: Se ambos ScriptAddress e ProxyAddress estiverem presentes no mesmo arquivo, ScriptAddress terá precedência.

Parâmetro	Tipo	Description
ScriptAddress	String	URL do script de configuração automática de proxy (PAC). Quando presente, tem precedência sobre ProxyAddress. Exemplo: http://proxy.address/proxy.pac
ProxyAddress	String	Endereço e porta do servidor do proxy. Exemplo: http://proxy.address:1234/
BypassLocalAddresses	Booleano	Quando true, os endereços locais ignoram o servidor do proxy.
BypassList	String	Lista separada por ponto e vírgula de padrões de expressões regulares identificando hosts que ignoram o proxy.Use \\ para escapar caracteres regex especiais. Exemplo: server\\.domain\\.local$;192\\.168\\.\\d{1,3}\\.\\d{1,3}
UserName	String	Nome de usuário para a autenticação básica do proxy.
Password	String	Senha para a autenticação básica de proxy.
Domain	String	Domínio para autenticação básica de proxy.

Observação:

Para armazenar a senha do proxy em forma criptografada em vez de texto sem formatação, consulte Configurar o proxy usando uma senha criptografada.

Exemplos de configurações

Para obter instruções de configuração passo a passo, consulte Redirecionamento de robôs por meio de um servidor do proxy.

Script de PAC

{
  "ScriptAddress": "http://proxy.address/proxy.pac"
}

Endereço de proxy com autenticação básica

{
  "ProxyAddress": "http://proxy.address:1234/",
  "BypassLocalAddresses": true,
  "BypassList": "server\\.domain\\.local$;www.example.com;192\\.168\\.\\d{1,3}\\.\\d{1,3}",
  "UserName": "myUser",
  "Password": "myPassword",
  "Domain": "myDomain"
}