Archivos de configuración

Una vez que edites los archivos de configuración, debes reiniciar los componentes de UiPath Robot relevantes para que los cambios surtan efecto. La siguiente tabla resume cómo reiniciar varios componentes, en función del modo de instalación de UiPath Robot.

Recuerda guardar cualquier trabajo en curso antes de reiniciar para evitar perder cualquier progreso no guardado.

Componente	Instalación del modo de servicio	Instalación en modo de usuario
Servicio de robots	Abre Task Manager > Servicios. Busca el servicio UiPathRobotSvc . Haz clic con el botón derecho en el servicio y selecciona Reiniciar.	Salga y reinicie UiPath Assistant o Abre Task Manager > Detalles. Selecciona el proceso UiPath.Service.UserHost.exe . Selecciona Finalizar tarea.
Servicio de actualización	Abre Task Manager > Servicios. Busca el servicio UiPath.UpdateService.Agent . Haz clic con el botón derecho en el servicio y selecciona Reiniciar.
UiPath RobotJS ServiceHost	Abre Task Manager > Servicios. Busca el servicio UiPath.RobotJS.ServiceHost . Haz clic con el botón derecho en el servicio y selecciona Reiniciar.
Asistente de UiPath	En Assistant, selecciona Preferencias y luego Salir. Vuelve a iniciar Assistant.
Widgets	Reinicia Assistant. o Haz clic con el botón derecho en el icono de Assistant en la barra de tareas. Selecciona Volver a cargar widgets.

uipath.config

El archivo UiPath.config contiene parámetros de configuración esenciales para el UiPath Robot. Como administrador, puedes personalizar el comportamiento de tus robots editando la lista de parámetros en el archivo de configuración.

Nota:

Cada entorno puede necesitar avisos específicos, por lo que UiPath te permite aplicar diferentes configuraciones en función del entorno actual del robot, ya sea Desarrollo, Prueba o Producción. Ten siempre cuidado al editar este archivo, ya que una configuración inexacta puede causar problemas en la aplicación.

Acceder al archivo

Al instalar tu UiPath Robot, el sistema crea el archivo UiPath.config .

Para acceder a ella, ve a C:\Program Files\UiPath\Studio\UiPath.config.

Configuración personalizable

El archivo UiPath.config consta de los siguientes parámetros:

Sección de configuración	Tipo de datos + nombre del parámetro	Descripción	Predeterminado	Ejemplo
connectionSettings	cadena DefaultServiceUrl	Establece la dirección predeterminada que utiliza el robot para conectarse a Orchestrator.	N/A	string DefaultServiceUrl = "https://cloud.uipath.com"
	Booleano AutoSignIn	Habilita la función de inicio de sesión automático para Assistant.	False	bool AutoSignIn = true.
	Booleano EnforceDefaultServiceUrl	Aplica la dirección proporcionada como DefaultServiceUrl a todos los usuarios.	False	bool EnforceDefaultServiceUrl = true.
communicationSettings	byte MaxMessageSizeInMegabytes	Establece el tamaño máximo de un mensaje que el sistema puede enviar o recibir, en MB. Esto se utiliza para evitar sobrecargas o bloqueos del proceso debido al manejo de mensajes demasiado grandes.	10 MB	byte MaxMessageSizeInMegabytes = 10;
	Intervalo de tiempo InstallPackageTimeout	Establece el límite de tiempo para las instalaciones de paquetes. Si la instalación de un paquete tarda más que el tiempo definido, el sistema aborta la instalación. Expresado como IntervaloDeTiempo.	20 minutos	TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);
	Intervalo de tiempo RequestTimeout	Define cuánto tiempo espera el sistema una respuesta de comunicación. Si el sistema no recibe una respuesta en el período establecido, se detiene y avanza. Esto evita que el sistema se cuelgue. Expresado como IntervaloDeTiempo.	40 segundos	TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);
packageSettings	cadena PackagesInstallationFolder	Establece el directorio predeterminado donde se instalan los paquetes.	C:\UiPath\Packages
	Booleano SkipHttpConfigurationSources	Permite que el sistema ignore las fuentes de paquetes configuradas a través de HTTP, como las fuentes NuGet. Esto significa que el sistema no recupera paquetes de estas fuentes, lo que es útil cuando las fuentes no son fiables o seguras.	False
	Booleano DisableSecureXaml	Permite que el UiPath Robot ejecute flujos de trabajo potencialmente inseguros.	False
	Booleano DirectDownload	Permite la descarga directa de paquetes, sin preguntar al usuario.	False
	Booleano PackageSaveWithoutNupkg	Permite guardar los paquetes sin el archivo .nupkg . Esto es útil para reducir el tamaño de la descarga.	False
analyticsSettings	Booleano Telemetry.Enabled	Permite a UiPath recopilar y enviar datos de uso para su análisis.	False
webProxySettings	cadena ScriptAddress	Establece la dirección del script que determina cómo y cuándo utilizar el proxy.
	cadena ProxyAddress	Establece la dirección del servidor proxy, ya sea IP o nombre de dominio.
	cadena BypassList	Contiene la lista de direcciones que se conectan directamente a Internet, sin pasar por el servidor proxy.
	Booleano BypassLocalAddresses	Permite la conexión directa para direcciones locales, pasando el servidor proxy.	False
	cadena UserName	Establece la credencial de nombre de usuario para la autenticación del servidor proxy.
	cadena Password	Establece la contraseña asociada al nombre de usuario para la autenticación del servidor proxy.
	cadena Domain	Establece el dominio donde reside el servidor proxy, necesario para la autenticación.
robotCacheSettings	Intervalo de tiempo SessionCacheDuration	Define cuánto tiempo deben conservarse los datos de una sesión específica en la caché antes de descartarse. Esto es útil para reutilizar datos como valores de variables o detalles de operaciones, en lugar de volver a crearlos o recuperarlos. Expresado como IntervaloDeTiempo.	30 segundos	TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);
	Intervalo de tiempo GetResourceUrlCacheDuration	Define cuánto tiempo se almacenan en la caché las URL de los recursos, como las API o las páginas web. Esto es útil para optimizar el rendimiento en escenarios en los que tus robots necesitan acceder a ciertos recursos con regularidad. Expresado como IntervaloDeTiempo.	1 hora	TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);
robotJsSettings	int ListenerPort	Establece el número de puerto en el que Robot.js escucha las conexiones entrantes. Esto permite que el servicio de robot interactúe con las aplicaciones web que se ejecutan en servidores locales o remotos.	2323	int ListenerPort = 2323;
	int TokenExpiryInDays	Establece el período de validez, en días, de los tokens de autenticación generados por el servicio de robot. El servicio de robot utiliza estos tokens para autenticarse cuando interactúa con otros componentes o servicios de software.	30 días	int TokenExpiryInDays = 30;
	cadena AllowUrlList	Establece la lista de URL a las que puede acceder el servicio de robot. Esto ayuda a garantizar que tu servicio de robot solo interactúe con los servicios aprobados.		string AllowUrlList = "https://cloud.uipath.com";

Importante:

• Crea siempre una copia de seguridad del archivo UiPath.config original antes de realizar cualquier cambio. Esto puede ayudar a restaurar la configuración original si algo sale mal.
• Para aplicar las actualizaciones realizadas al archivo UiPath.config , reinicia el servicio UiPath o el sistema.
• La configuración local en el archivo UiPath.config tiene prioridad sobre la configuración configurada en Orchestrator.
• Los datos confidenciales del archivo UiPath.config pueden cifrarse para mayor seguridad.

Variables del sistema de UiPath Robot

Se puede configurar un comportamiento personalizado adicional a través de las variables de entorno del sistema.

Después de modificar cualquiera de las variables del sistema, reinicia el servicio de robot.

La siguiente lista resume los casos de uso más comunes:

Variable del sistema	Uso	Ejemplo
UIPATH_SESSION_TIMEOUT	Cambia el tiempo de espera predeterminado de 60 segundos para crear una sesión interactiva. Ajusta este valor para adaptar el comportamiento del robot en función del rendimiento y los tiempos de carga del sistema con el que interactúa.	UIPATH_SESSION_TIMEOUT=75
UIPATH_SESSION_LEGACY
UIPATH_PIP_SESSION_TIMEOUT	Cambia el tiempo de espera predeterminado de 180 segundos para iniciar un proceso en una sesión de UiPath Robot.	UIPATH_PIP_SESSION_TIMEOUT=60
UIPATH_USER_SERVICE_PATH	Establece la ruta de instalación del servicio de usuario.	UIPATH_USER_SERVICE_PATH=C://installation/folder/UiPath.Service.UserHost.exe
UIPATH_LANGUAGE	Establece el idioma en el que opera el UiPath Robot. El orden para determinar el idioma es: UIPATH_LANGUAGE valor La variable de entorno de la máquina La cultura de la IU del hilo actual Idioma predeterminado de UiPath (inglés)	UIPATH_LANGUAGE=French
UIPATH_DISABLE_MARKETPLACE_WIDGET	Requerido por UiPath Assistant, deshabilita el widget de 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	Utiliza las credenciales de un usuario específico, que se configuró previamente en Orchestrator.	UIPATH_HEADLESS_WITH_USER=True
UIPATH_PRE_LOADED_EXECUTOR	De forma predeterminada, se lanza un ejecutor precargado cuando se inicia el UiPath Robot. Esta variable sobrescribe el comportamiento predeterminado, y un ejecutor precargado se inicia cuando se ejecuta el primer proceso. Las opciones son: Ventanas Legado Portátil Ninguno	UIPATH_PRE_LOADED_EXECUTOR=None
UIPATH_DISABLE_PRE_LOADED_EXECUTOR	Deshabilita la característica de ejecutor precargado.	UIPATH_DISABLED_PRE_LOADED_EXECUTOR=True
UIPATH_ROBOTJS_ALLOWLIST	Acepta automáticamente el cuadro de diálogo de consentimiento del robot, al establecer la conexión entre el SDK de Robot JS y el ejecutor de robot. La variable acepta URL de aplicaciones personalizadas, separadas por punto y coma. Si se utilizan puertos no estándar, asegúrese de incluir los números de puerto.
UIPATH_DNS_MACHINENAME	Permite utilizar el nombre de host DNS para Localhost al crear sesiones RDP. Para ejecutar trabajos desatendidos en entornos con autenticación Kerberos para RDP, establece este valor en Verdadero.	UIPATH_DNS_MACHINENAME=True
UIPATH_PROXY_USE_DEFAULT_CREDENTIALS	Permite que el UiPath Robot gestione las configuraciones de proxy que utilizan credenciales de Windows para la autenticación.	UIPATH_PROXY_USE_DEFAULT_CREDENTIALS=True
NUGET_FALLBACK_PACKAGES	Configura las rutas a las carpetas de paquetes alternativos. Utiliza punto y coma para separar varias rutas. En ausencia de esta variable, el UiPath Robot busca carpetas de paquetes alternativos en el archivo Nuget.config .
NUGET_SCRATCH	Permite que varios robots en modo usuario en la misma máquina compartan una ruta local para almacenar paquetes. El valor debe ser una ruta diferente a la carpeta de instalación de NuGet, y actúa como una carpeta temporal para NuGet. Nota: Solo la variable NUGET_SCRATCH debe utilizar la carpeta temporal configurada.	NUGET_SCRATCH=C:\NuGetTempFolder
UIPATH_PRESERVE_CREDENTIALS_CASE	Conserva la carcasa original de las credenciales de registro (dominio\nombre de usuario).	UIPATH_PRESERVE_CREDENTIALS_CASE = True