robot
2024.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 robô

Última atualização 17 de fev de 2025

Arquivos de configuração

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 tabela 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.

Component

Instalação do Modo de Serviço

Instalação do Modo de Usuário

Serviço de robôs

  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.

  1. Saia e depois reinicie o UiPath 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

  1. Reiniciar o UiPath Assistant.

ou

  1. Clique com o botão direito do mouse no í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.

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:

Seção de configuração

Tipo de dados + nome do parâmetro

Description

Padrão

Exemplo

connectionSettings

string DefaultServiceUrl

Define o endereço padrão que o Robô usa para se conectar ao Orchestrator.

NA

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

Habilita a funcionalidade de login automático para o UiPath Assistant.

falso

bool AutoSignIn = true.bool AutoSignIn = true.
bool EnforceDefaultServiceUrl

Impõe o endereço fornecido como URLdeServiçoPadrão para todos os usuários.

falso

bool EnforceDefaultServiceUrl = true.bool EnforceDefaultServiceUrl = true.
communicationSettingsbyte MaxMessageSizeInMegabytes

Define o tamanho máximo de uma mensagem que o sistema pode enviar ou receber, em MB.

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

10 MB

byte MaxMessageSizeInMegabytes = 10;byte MaxMessageSizeInMegabytes = 10;
Intervalo de tempo InstallPackageTimeout

Define o limite de tempo para instalações de pacotes.

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

Expresso como Intervalo de tempo.

20 minutos

TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);
Intervalo de tempo RequestTimeout

Define por quanto tempo o sistema espera por uma resposta de comunicação.

Se o sistema não receber uma resposta no período definido, ele para e segue em frente.

Isso impede travamentos do sistema.

Expresso como Intervalo de tempo.

40 segundos

TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);
packageSettingsstring PackagesInstallationFolder

Define o diretório padrão onde os pacotes são instalados.

C:\UiPath\Packages 
bool SkipHttpConfigurationSources

Permite que o sistema ignore fontes de pacotes configuradas por HTTP, como feeds NuGet.

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.

falso

 
bool DisableSecureXaml

Permite que o Robô execute fluxos de trabalho potencialmente inseguros.

falso

 
bool DirectDownload

Permite o download direto de pacotes, sem solicitar ao usuário.

falso

 
bool PackageSaveWithoutNupkg
Permite salvar os pacotes sem o arquivo .nupkg.

Isso é útil para reduzir o tamanho do download.

falso

 
analyticsSettingsbool Telemetry.Enabled

Permite que o UiPath colete e envie dados de uso para análise.

falso

 
webProxySettingsstring ScriptAddress

Define o endereço do script que determina como e quando usar o proxy.

  
string ProxyAddress

Define o endereço do servidor do proxy, nome de IP ou de domínio.

  
string BypassList

Contém a lista de endereços que se conectam diretamente à Internet, ignorando o servidor do proxy.

  
bool BypassLocalAddresses

Permite conexão direta para endereços locais, ignorando o Servidor do Proxy.

falso

 
string UserName

Define a credencial de nome de usuário para autenticação do servidor do proxy.

  
string PasswordDefine a senha associada ao nome de usuário para autenticação do servidor do proxy.  
string DomainDefine o domínio onde o servidor do proxy reside, necessário para autenticação.  
robotCacheSettingsIntervalo de tempo SessionCacheDuration

Define por quanto tempo os dados de uma sessão específica devem ser retidos no cache antes de serem descartados.

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

Expresso como Intervalo de tempo.

30 segundos

TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);
Intervalo de tempo GetResourceUrlCacheDuration

Define por quanto tempo os URLs para recursos, como APIs ou páginas da web, são armazenados no cache.

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

Expresso como Intervalo de tempo.

1 hora

TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);
robotJsSettingsint ListenerPort

Define o número da porta no qual o Robot.js escuta conexões de entrada.

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

2323

int ListenerPort = 2323;int ListenerPort = 2323;
int TokenExpiryInDays

Define o período de validade, em dias, de tokens de autenticação gerados pelo serviço de robôs.

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

30 dias

int TokenExpiryInDays = 30;int TokenExpiryInDays = 30;
string AllowUrlList

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.

 
string AllowUrlList = "https://cloud.uipath.com";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:

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_USER_SERVICE_PATHDefine o caminho de instalação do serviço do usuário.
UIPATH_USER_SERVICE_PATH=C://installation/folder/UiPath.Service.UserHost.exeUIPATH_USER_SERVICE_PATH=C://installation/folder/UiPath.Service.UserHost.exe
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

UIPATH_SESSION_BEHAVIOR

Configura o comportamento da restauração da sessão 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.
  • ForceNewSession—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.
UIPATH_SESSION_BEHAVIOR = LeaveSessionDisconnectedUIPATH_SESSION_BEHAVIOR = LeaveSessionDisconnected

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White