Solución de problemas con UiPath para agentes de codificación

Los agentes de codificación para la solución de problemas aportan diagnósticos conversacionales a UiPath Platform. Describa un fallo en un lenguaje sencillo desde cualquier terminal de su máquina, incluido el terminal integrado en UiPath Studio, y la habilidad clasifica el problema, clasifica las causas probables, prueba cada hipótesis con los datos de la plataforma en vivo a través de uip y le dice exactamente qué sucedió incorrecto y cómo solucionarlo.

La habilidad de resolución de problemas forma parte del catálogo de habilidades de UiPath y se instala en tu agente de codificación a través de uip skills install.

Cómo funciona

Una sesión de diagnóstico sigue el mismo flujo de cuatro etapas independientemente del tipo de fallo:

1. Triaje : clasifica el ámbito del fallo a partir de la descripción del usuario, el identificador del trabajo o proceso, o el mensaje de error. Si la entrada es ambigua, la habilidad hace una pregunta aclaratoria.
2. Generar hipótesis : produce una lista clasificada de posibles causas, basándose en el libro de jugadas del dominio relevante y cualquier evidencia recopilada durante la clasificación.
3. Probar hipótesis : confirma o elimina una hipótesis a la vez. La habilidad obtiene registros, seguimientos, artículos en cola, datos de reparación, configuración y eventos de auditoría a través de uip para recopilar pruebas.
4. Resolución : presenta la causa raíz, la cadena de eventos que produjo el fallo y una solución concreta. La habilidad pide aprobación explícita antes de cambiar algo.

El usuario puede participar en cuatro momentos: aclarar el ámbito durante la clasificación, proporcionar contexto adicional para la generación de hipótesis, proporcionar el código fuente o los archivos de configuración cuando sea necesario y aprobar las correcciones recomendadas.

Lo que puede diagnosticar hoy

La habilidad de solución de problemas cubre los siguientes dominios. Describes el problema; la habilidad obtiene la evidencia y devuelve una causa raíz.

Dominio	Qué puedes diagnosticar	Ejemplo de solicitud
RPA	Trabajos fallidos (SelectorNotFoundException, TimeoutException y similares), discrepancias de selector, fallos de artículos en cola, análisis de datos de Healing Agent	"¿Por qué ha fallado el trabajo de InvoiceBot esta mañana?"
Orchestrator	Trabajos atascados o defectuosos, problemas de permisos y roles, errores de implementación y publicación, problemas de configuración de colas	"¿Por qué mi robot no recoge elementos de la cola de Finanzas?"
Maestro	Instancias de proceso defectuosas, fallos en el nivel de paso, incidentes, cadenas de fallos multidominio que involucran agentes o RPA	"¿Por qué la instancia del proceso de aprobación falló en el paso 3?"

El soporte para otros dominios de UiPath ya está disponible, pero aún se está profundizando. Más dominios y diagnósticos más completos están en camino.

La habilidad funciona con el mismo acceso que tú tienes. Si no puedes leer ciertos registros o carpetas como usuario que ha iniciado sesión, la habilidad tampoco podrá leerlos.

Requisitos previos

1. Habilidades de UiPath instaladas para tu agente. Consulta Uso de UiPath CLI con agentes de codificación para el comando de instalación por agente.
2. Una sesión iniciada (uip login). Consulta Autenticación.

Pasos

Ejecuta la configuración descrita aquí Utilizar UiPath CLI con agentes de codificación una vez por máquina. A partir de entonces, la habilidad estará disponible en todas las sesiones.

Inicie su agente de codificación desde cualquier terminal en su máquina o desde el terminal integrado en UiPath Studio, luego inicie una sesión de diagnóstico introduciendo /uipath-troubleshoot para invocar la habilidad explícitamente, o describiendo el problema directamente, por ejemplo, "Mi trabajo abc- 123 ha fallado, ¿qué ha ocurrido?"

Responde a las solicitudes de seguimiento de la habilidad. Responda a preguntas aclaratorias en inglés sencillo y comparta el código fuente, los archivos de configuración u otros artefactos cuando la habilidad los solicite.

La habilidad imprime un resumen estructurado de la causa raíz: el componente que falla, la cadena de eventos que produjo el fallo, la evidencia de apoyo de los registros y seguimientos, y una solución recomendada. Antes de cambiar algo en tu máquina o en tu tenant, la habilidad pide aprobación explícita.

El siguiente ejemplo muestra una sesión ejecutada desde el terminal integrado en UiPath Studio:

Consejos para sesiones eficaces

Trata la habilidad como un colega que te ayuda a depurar; el contexto y el intercambio mejoran el resultado:

• Sea específico. Los ID de trabajo, los nombres de proceso, los nombres de cola y los mensajes de error exactos permiten que la habilidad omita las rondas de aclaración.
• Mantenga la conversación en marcha. Si la primera recomendación no coincide con lo que observas, dilo. Frases como "no es eso", "Ya lo he comprobado" o "profundizar" mantienen la investigación en movimiento.
• Redirigir cuando sea necesario. Si la habilidad sigue el hilo incorrecto, corrígelo, por ejemplo, "el problema no es con los permisos; el trabajo se ejecutó bien ayer".
• Comparte archivos cuando se te pida. project.json, los archivos de configuración y artefactos similares mejoran considerablemente la calidad del diagnóstico.
• Coincidir el acceso con las expectativas. La habilidad utiliza tu sesión de uip iniciada y hereda tus permisos. Si no puedes ver un registro, la habilidad tampoco podrá.

Ver también

• Habilidades : el mecanismo de habilidades más amplio
• Utilizar UiPath CLI con Coding Agents : instalar el catálogo de habilidades de UiPath en Claude Code, Cursor, GitHub Copilot, Gemini CLI, Codex y OpenCode
• Gestionar herramientas y habilidades : mantenimiento diario