Solución de problemas

Soluciones para problemas comunes de Delegate, incluidos errores de contexto de pantalla, problemas de permisos en macOS y Windows y fallos de conectividad o integración de herramientas.

Esta página es tu única referencia para resolver incidencias en Delegate.

Configuración e instalación

No veo mis aplicaciones

• Comprueba que el contexto de la pantalla está habilitado (alternar en la parte inferior de la ventana)
• Verifique que los permisos de grabación de pantalla/accesibilidad se concedan en la configuración del sistema (macOS) o que se haya aceptado UAC (Control de cuentas de usuario) (Windows)
• Reiniciar Delegate después de conceder permisos

Delegate dice que no puede acceder a un sitio web

• Compruebe su conexión a Internet
• Algunas redes corporativas bloquean ciertos servicios de IA: póngase en contacto con su departamento de TI si sospecha que esto es así
• Pruebe con un sitio web diferente para aislar el problema

No se detecta la extensión del navegador

• Asegúrese de que la extensión esté instalada y habilitada en su navegador
• En Chrome: chrome://extensions → Delegate debe aparecer en la lista y habilitarse
• Reinicia tu navegador después de la instalación
• Vuelva a ejecutar el asistente de configuración desde Configuración si es necesario

No puedo iniciar sesión

• Verifique las credenciales de su cuenta de UiPath
• Si tu organización utiliza SSO (inicio de sesión único), asegúrate de estar en la red corporativa o VPN
• Compruebe que su tenant está seleccionado correctamente

Tareas y solicitudes

Delegate no entendió lo que yo quería

• Divide la solicitud en pasos más pequeños
• Sea más explícito sobre el objetivo y el formato
• Proporcione un ejemplo de la salida deseada

Empezó a hacer algo que no esperaba

• Pulse Escape para detener
• Preguntar "¿Qué está intentando hacer?" para entender su razonamiento
• Redirigir con una instrucción más clara

La tarea está tardando demasiado

• Comprueba si estás en modo de fondo (más lento pero sin bloqueo)
• Solicitar una actualización de estado: "¿Por qué tarda tanto?"
• Considere dividir en fragmentos más pequeños para tareas complejas

Sigue pidiendo confirmación

• Está en modo guiado: esto es lo que se espera por seguridad
• Cambie al modo autónomo para flujos de trabajo repetitivos y de confianza
• Revise la configuración de seguridad si desea ajustar lo que desencadena la confirmación

Seguridad y permisos

Delegate dice que no tiene permiso

1. Comprueba Configuración → Seguridad → la categoría de herramientas relevante está habilitada.
2. Marca Permisos de herramienta para la herramienta específica o la operación del conector.
3. Comprueba si la aplicación o el sitio de destino está en Aplicaciones/sitios web bloqueados en Automatización de IU, o si la ruta coincide con una categoría en Archivos protegidos.
4. Intente cambiar al modo Cauteloso temporalmente para ver la denegación específica.

He aprobado una acción, pero sigue fallando

1. Comprueba los permisos a nivel de sistema operativo (configuración de privacidad de macOS, UAC de Windows).
2. Verifica que la aplicación o el sitio no esté en Aplicaciones/sitios web bloqueados en Automatización de IU.
3. Comprueba si la ruta del archivo coincide con una categoría en Archivos protegidos.
4. Revisa el mensaje de error: puede indicar un problema diferente (red, autenticación, etc.)

Quiero permitir un sitio que está bloqueado

1. Abre Configuración → Seguridad → Automatización de IU y marca Sitios web bloqueados : elimina el sitio si aparece en la lista de forma individual o si se añadió como parte de una categoría (Banca, Pagos, Cripto, Gestor de contraseñas, Gobierno, Salud).
2. Si la configuración está bloqueada y se muestra como gestionada por tu organización, ponte en contacto con tu administrador. Se aplica a través de Automation Ops y no se puede cambiar localmente.

Una habilidad sigue solicitando permisos que ya concedí

1. Comprueba si la habilidad solicita un permiso diferente al anterior.
2. Verifique que el manifiesto de la habilidad coincida con lo que realmente utiliza.
3. Algunos permisos tienen un ámbito de sesión y requieren una nueva aprobación.
4. Consulta Configuración → Permisos → Agentes permitidos para asegurarte de que el agente relevante está habilitado.

Conexiones

Integration Service: error de conexión o error de autenticación

Causas

• El token de OAuth ha caducado
• Contraseña cambiada en el servicio de origen
• La política de la organización ha revocado el acceso de terceros
• Permisos concedidos insuficientes

Soluciones

1. Ve a Configuración → Conexiones → Reconectar.
2. Si eso falla, revoca y vuelve a crear la conexión.
3. Comprueba la configuración de la aplicación de terceros del servicio.
4. Comprueba que tienes los permisos necesarios en la aplicación de origen.

Integration Service: no se ha encontrado ninguna conexión para [servicio]

Causa: has pedido a Delegate que utilice un servicio que no está conectado

Soluciones

1. Crea la conexión en Configuración → Conexiones.
2. O especifica un enfoque diferente que no requiera ese servicio.

Integration Service: permisos insuficientes

Causa: la conexión existe, pero carece de los ámbitos necesarios para la acción solicitada

Soluciones

1. Desconecta y vuelve a conectar, otorgando permisos adicionales cuando se te solicite.
2. Consulta con tu administrador de TI si las políticas de la organización restringen los ámbitos.

MCP: error al conectarse al servidor MCP

Causas

• El servidor remoto está inactivo o no se puede acceder
• El proceso local no se pudo iniciar
• Red/firewall bloqueando la conexión
• URL o configuración no válida

Soluciones

1. Verifica que el servidor se esté ejecutando (para local) o accesible (para remoto).
2. Compruebe si hay errores tipográficos en la URL/comando.
3. Prueba el punto final manualmente (curl, navegador).
4. Comprueba la configuración del cortafuegos.
5. Revisa los registros del proceso local para detectar errores de inicio.

MCP: servidor conectado pero no hay herramientas disponibles

Causa: el servidor se está ejecutando pero no ha registrado ninguna herramienta o las herramientas no se pudieron inicializar

Soluciones

1. Consulta la documentación del servidor para ver la configuración necesaria.
2. Verifique que las variables de entorno estén configuradas correctamente.
3. Reinicia el servidor MCP.
4. Compruebe los registros del servidor para detectar errores de inicialización.

MCP: llamada de herramienta fallida o error de MCP

Causa: el servidor recibió la solicitud, pero no se pudo ejecutar

Soluciones

1. Comprueba el mensaje de error específico en la tarjeta de herramientas.
2. Verifique que se hayan proporcionado los parámetros necesarios de la herramienta.
3. Comprueba si el recurso subyacente (archivo, base de datos, API) es accesible.
4. Revisa los registros del servidor MCP para obtener información detallada sobre los errores.

Rutinas

No se ha encontrado la rutina

Causa: se eliminó la rutina o se movió la carpeta LocalSkills

Soluciones

1. Comprueba si la rutina está en Configuración → Rutinas.
2. Si se importa, vuelve a importar desde el archivo original.
3. Comprueba la ruta de la carpeta LocalSkills en Configuración → Habilidades & Marketplace.

Falta la entrada requerida

Causa: la rutina espera un parámetro que no se proporcionó

Soluciones

1. Al ejecutar, rellena todas las entradas solicitadas.
2. Si está programando, asegúrese de que se establezcan valores fijos para todas las entradas necesarias.
3. Edita la rutina para hacer que las entradas sean opcionales con los valores predeterminados.

La rutina falló en el paso X

Causa: no se pudo completar una acción en la rutina

Soluciones

1. Comprueba el mensaje de error en la tarjeta de herramientas.
2. Verifica que las conexiones necesarias estén activas (Configuración → Conexiones).
3. Asegúrate de que los archivos de entrada existan y sean accesibles.
4. Comprueba si las aplicaciones de destino están instaladas.
5. Ejecuta en modo guiado para ver exactamente dónde falla.

La rutina programada no se ejecutó

Causa: el servicio de programación no se está ejecutando o hay un problema de permisos

Soluciones

1. Consulta Configuración → Rutinas → Programadas para el estado de ejecución.
2. Verifique que Delegate se estuviera ejecutando a la hora programada.
3. Comprueba si la máquina estaba inactiva (es posible que las programaciones no se ejecuten mientras está inactiva).
4. Revisa el historial de ejecuciones para ver si hay mensajes de error.
5. Asegúrese de que las conexiones sigan siendo válidas (no hayan caducado).

Tienda y habilidades

El elemento no se instalará

Causas

• Problema de conectividad de red
• Espacio en disco insuficiente
• Descarga dañada
• Versión de Delegate incompatible

Soluciones

1. Compruebe la conexión a Internet.
2. Libera espacio en disco (consulta el directorio LocalSkills).
3. Intente instalar de nuevo.
4. Comprueba si tu Delegate está actualizado.
5. Póngase en contacto con el editor si el problema persiste.

La habilidad instalada no aparece

Causas

• La habilidad está deshabilitada
• No añadido a la lista de Habilidades habilitadas
• Delegate debe reiniciarse

Soluciones

1. Comprueba Configuración → Habilidades & Marketplace → la habilidad aparece en la lista y está habilitada.
2. Reinicia Delegate.
3. Consulta la carpeta LocalSkills para ver los archivos de habilidades.

La habilidad falla cuando intento usarla

Causas

• Faltan las conexiones necesarias
• Faltan los permisos necesarios
• Versión de habilidad obsoleta
• La versión de la aplicación no coincide

Soluciones

1. Consulta la documentación de la habilidad para conocer los requisitos previos.
2. Crea las conexiones necesarias en Configuración → Conexiones.
3. Habilite las categorías de herramientas necesarias en Configuración → Seguridad.
4. Actualiza la habilidad a la última versión.
5. Comprueba si la versión de la aplicación de destino es compatible.

La fuente personalizada no se carga

Causas

• URL de fuente no válida
• Servidor de fuentes inactivo
• Formato de fuente incorrecto
• Bloqueo de red/firewall

Soluciones

1. Verifique que la URL sea correcta y accesible en un navegador.
2. Compruebe el formato de la fuente con la especificación de UiPath.
3. Póngase en contacto con el administrador de la fuente.
4. Compruebe la configuración del cortafuegos corporativo.

Configuración

Los cambios de configuración no tienen efecto

Causa: algunas configuraciones requieren un reinicio de la aplicación; La configuración de las pestañas Seguridad y Permisos solo se puede cambiar a través de la IU de Configuración, no editando el archivo directamente.

Soluciones

1. Reinicia Delegate y comprueba si la configuración tuvo efecto.
2. Si la configuración está en la pestaña Seguridad o Permisos, utiliza la IU de Configuración en lugar de editar el archivo directamente.
3. Si editas settings.json manualmente, verifica que estés editando la ruta de archivo correcta.

El archivo de configuración está dañado

Causa: settings.json tiene una sintaxis JSON no válida, a menudo debido a un error de edición manual. Delegate recurre a la configuración predeterminada automáticamente.

Soluciones

1. Cerrar Delegate.
2. Eliminar o cambiar el nombre de settings.json.
3. Reiniciar Delegate: se crean nuevos valores predeterminados.
4. Vuelva a configurar sus preferencias.

No se puede encontrar una configuración

Causa: la configuración puede estar en una pestaña diferente a la esperada, o solo estar disponible a través de la IU de Configuración.

Soluciones

1. Comprueba si la configuración está en la pestaña Seguridad (solo IU).
2. Verifica tu versión de Delegate: algunas configuraciones son específicas de la versión.

La configuración segura no se guardará

Causa: la seguridad en el sistema operativo impide el acceso al almacén de configuración cifrada: llavero de macOS o API de protección de datos de Windows (DPAPI).

Soluciones

1. Comprueba los permisos de seguridad a nivel de sistema operativo.
2. macOS: asegúrate de que el llavero esté desbloqueado.
3. Windows: asegúrate de que tu perfil de usuario esté cargado correctamente.
4. Reinicia Delegate.
5. Si es persistente, ponte en contacto con el soporte de UiPath.