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	Abra Gerenciador de tarefas > Serviços. Procure o serviço UiPathRobotSvc. Clique com o botão direito do mouse no serviço e selecione Reiniciar.	Saia e depois reinicie o UiPath Assistant ou Abra Gerenciador de tarefas > Detalhes. Selecione o processo UiPath.Service.UserHost.exe. Selecione Encerrar tarefa.
Atualizar Serviço	Abra Gerenciador de tarefas > Serviços. Procure o serviço UiPath.UpdateService.Agent. Clique com o botão direito do mouse no serviço e selecione Reiniciar.
UiPath RobotJS ServiceHost	Abra Gerenciador de tarefas > Serviços. Procure o serviço UiPath.RobotJS.ServiceHost. Clique com o botão direito do mouse no serviço e selecione Reiniciar.
UiPath Assistant	No UiPath Assistant, selecione Preferências e, em seguida, Sair. Reinicie o UiPath Assistant.
Widgets	Reiniciar o UiPath Assistant. ou Clique com o botão direito do mouse no ícone do UiPath Assistant na barra de tarefas. 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"
	bool AutoSignIn	Habilita a funcionalidade de login automático para o UiPath Assistant.	falso	bool AutoSignIn = true.
	bool EnforceDefaultServiceUrl	Impõe o endereço fornecido como URLdeServiçoPadrão para todos os usuários.	falso	bool EnforceDefaultServiceUrl = true.
communicationSettings	byte 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;
	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);
	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);
packageSettings	string 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
analyticsSettings	bool Telemetry.Enabled	Permite que o UiPath colete e envie dados de uso para análise.	falso
webProxySettings	string 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 Password	Define a senha associada ao nome de usuário para autenticação do servidor do proxy.
	string Domain	Define o domínio onde o servidor do proxy reside, necessário para autenticação.
robotCacheSettings	Intervalo 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);
	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);
robotJsSettings	int 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 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;
	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";

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_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.	UIPATH_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=60
UIPATH_USER_SERVICE_PATH	Define o caminho de instalação do serviço do usuário.	UIPATH_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 é: Valor UIPATH_LANGUAGE A variável de ambiente da máquina A cultura de interface do usuário do tópico atual Idioma padrão do UiPath (inglês)	UIPATH_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=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=None
UIPATH_DISABLE_PRE_LOADED_EXECUTOR	Desabilita a funcionalidade de executor pré-carregado.	UIPATH_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_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=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=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:\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 = 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 = LeaveSessionDisconnected