Arquivos de configuração

Após editar os arquivos de configuração, você precisa reiniciar os componentes do Robô relevantes 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 qualquer 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 o Gerenciador de Tarefas > Serviços. Procure o serviço UiPathRobotSvc . Clique com o botão direito do mouse no serviço e selecione Reiniciar.	Sair e reiniciar o UiPath Assistant ou Abra o Gerenciador de Tarefas > Detalhes. Selecione o processo UiPath.Service.UserHost.exe . Selecione Finalizar tarefa.
Atualizar Serviço	Abra o 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 o 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, depois, 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 e, por isso, a UiPath permite que você aplique diferentes configurações com base no ambiente atual do robô, seja Desenvolvimento, Preparação ou Produção. Tenha sempre cuidado ao editar esse arquivo, pois uma configuração imprecisa pode causar problemas no aplicativo.

Acesso ao arquivo

Quando você instalar seu Robô, o sistema criará 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	cadeia de caracteres 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 Assistant.	falso	bool AutoSignIn = true.
	Bool EnforceDefaultServiceUrl	Impõe o endereço fornecido como DefaultServiceUrl 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 de 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 anulará a instalação. Expresso como TimeSpan.	20 minutos	TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);
	Intervalo de Tempo RequestTimeout	Define por quanto tempo o sistema aguarda uma resposta de comunicação. Se o sistema não receber uma resposta no período definido, ele para e avança. Isso evita travamentos do sistema. Expresso como TimeSpan.	40 segundos	TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);
packageSettings	cadeia de caracteres PackagesInstallationFolder	Define o diretório padrão em que os pacotes são instalados.	C:\UiPath\Packages
	Bool SkipHttpConfigurationSources	Permite que o sistema ignore origens de pacote configuradas em HTTP, como feeds do NuGet. Isso significa que o sistema não recupera pacotes dessas origens, o que é útil quando as origens 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 o 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	cadeia de caracteres ScriptAddress	Define o endereço do script que determina como e quando usar o proxy.
	cadeia de caracteres ProxyAddress	Define o endereço do servidor de proxy, seja o IP ou o nome do domínio.
	cadeia de caracteres BypassList	Contém a lista de endereços que se conectam diretamente à Internet, ignorando o servidor de proxy.
	Bool BypassLocalAddresses	Permite conexão direta para endereços locais, ignorando o Servidor do Proxy.	falso
	cadeia de caracteres UserName	Define a credencial de nome de usuário para autenticação do servidor proxy.
	cadeia de caracteres Password	Define a senha associada ao nome de usuário para a autenticação do servidor proxy.
	cadeia de caracteres Domain	Define o domínio no qual o servidor de proxy reside, necessário para a 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 recuperá-los. Expresso como TimeSpan.	30 segundos	TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);
	Intervalo de Tempo GetResourceUrlCacheDuration	Define por quanto tempo as URLs para recursos, como APIs ou páginas da web, são armazenadas em cache. Isso é útil para otimizar o desempenho em cenários nos quais seus robôs precisam acessar determinados recursos regularmente. Expresso como TimeSpan.	1 hora	TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);
robotJsSettings	ListenerPort	Define o número da porta na qual o Robot.js escuta as conexões de entrada. Isso permite que o Serviço de Robôs da UiPath interaja com aplicativos da Web em execução em servidores locais ou remotos.	2323	int ListenerPort = 2323;
	TokenExpiryInDays	Define o período de validade, em dias, dos tokens de autenticação gerados pelo serviço de robôs. O Serviço de Robôs da UiPath usa esses tokens para se autenticar ao interagir com outros componentes de software ou serviços.	30 dias	int TokenExpiryInDays = 30;
	cadeia de caracteres 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 um backup do arquivo UiPath.config original 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 no arquivo UiPath.config , reinicie o serviço da UiPath ou o sistema.
• As configurações locais no arquivo UiPath.config têm precedência sobre as configurações configuradas no Orchestrator.
• Dados confidenciais no arquivo UiPath.config podem ser criptografados para segurança adicional.

Variáveis do sistema do UiPath Robot

Outros comportamentos personalizados podem ser configurados por meio das variáveis de ambiente do sistema.

Após modificar qualquer uma das variáveis do sistema, reinicie o Serviço do Robô.

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 tempos de carregamento do sistema com o qual ele interage.	UIPATH_SESSION_TIMEOUT=75
UIPATH_SESSION_LEGACY
UIPATH_PIP_SESSION_TIMEOUT	Altera o tempo limite padrão de 180 segundos para iniciar um processo em uma sessão do UiPath Robot.	UIPATH_PIP_SESSION_TIMEOUT=60
UIPATH_USER_SERVICE_PATH	Define o caminho de instalação do serviço de 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 gráfica do thread atual Idioma padrão da UiPath (inglês)	UIPATH_LANGUAGE=French
UIPATH_DISABLE_MARKETPLACE_WIDGET	Obrigatório pelo UiPath Assistant, desabilita o widget do UiPath Marketplace.	// On Windows OS UIPATH_DISABLE_MARKETPLACE_WIDGET=True //On Mac OS, run the following command: launchctl setenv UIPATH_DISABLE_MARKETPLACE_WIDGET TRUE
UIPATH_HEADLESS_WITH_USER	Usa as credenciais de um usuário específico, que foram configuradas anteriormente no Orchestrator.	UIPATH_HEADLESS_WITH_USER=True
UIPATH_PRE_LOADED_EXECUTOR	Por padrão, um executor pré-carregado é iniciado quando o Robô é iniciado. Essa variável substitui o comportamento padrão e um executor pré-carregado começa quando o primeiro processo é executado. As opções são: Windows Herdado Portátil Nenhum	UIPATH_PRE_LOADED_EXECUTOR=None
UIPATH_DISABLE_PRE_LOADED_EXECUTOR	Desabilita a funcionalidade do executor pré-carregado.	UIPATH_DISABLED_PRE_LOADED_EXECUTOR=True
UIPATH_ROBOTJS_ALLOWLIST	Aceita automaticamente a caixa de diálogo consentimento do robô, ao estabelecer a conexão entre o Robot JS SDK e o Executor do Robô. A variável aceita URLs de aplicativos personalizados, separados por ponto e vírgula. Se portas não padrão forem usadas, certifique-se de incluir os números das portas.
UIPATH_DNS_MACHINENAME	Permite usar o nome do host do DNS para o Localhost ao criar sessões de 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ô lide com configurações de proxy que usam as Credenciais do Windows para a autenticação.	UIPATH_PROXY_USE_DEFAULT_CREDENTIALS=True
NUGET_FALLBACK_PACKAGES	Configura os caminhos para as pastas dos pacotes de fallback. Use ponto e vírgula para separar vários caminhos. Na ausência dessa variável, o Robô procura as pastas dos pacotes de fallback no arquivo Nuget.config .
NUGET_SCRATCH	Permite que vários robôs de modo de usuário na mesma máquina compartilhem um caminho local para armazenar pacotes. O valor deve ser um caminho diferente para a pasta de instalação do NuGet e ele funciona 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 e minúsculas das credenciais de log (domínio/nome de usuário).	UIPATH_PRESERVE_CREDENTIALS_CASE = True