Qué hacer si el mismo comando se ejecuta localmente pero muestra errores de sintaxis en Agent?
Primero confirma el shell que realmente usa Agent, luego corrige parámetros, comillas y rutas.
La entrada de ejecución puede usar un shell diferente
No juzgues el shell de Agent basándote únicamente en el sistema operativo o en la terminal que abres manualmente. En Windows, tanto las implementaciones de escritorio como las CLI priorizan Git Bash; si no lo encuentran, usan cmd; no está fijado a PowerShell. Los escritorios Unix eligen el shell disponible del usuario en el host, mientras que CLI usa bash para las rutas de comandos ordinarias. Cambiar el punto de entrada puede alterar cómo se interpreta la misma cadena.
Primero verifica las rutas y los métodos de comillas
Haz que Agent confirme primero el shell real, luego maneja las rutas que contienen espacios, las URL con signos de interrogación o conectores, y la sintaxis de parámetros específica de la plataforma. Algunos shells tratan los caracteres sin comillas como comodines, causando errores que parecen archivos no encontrados. No modifiques solo un carácter sospechoso y continúes la ejecución por lotes; puedes primero dividir la tarea en un solo comando de solo lectura verificable para observar el resultado.
Distingue los problemas de sintaxis de las herramientas faltantes
Si el error es 'programa no encontrado', primero verifica la instalación de la herramienta y las rutas; si se deniega el acceso, verifica los permisos del sistema; solo los errores de análisis requieren centrarse en corregir la sintaxis del shell. Incluso si la última parte del comando muestra éxito, verifica las salidas de error anteriores para evitar ignorar fallos parciales. Confirma que el comportamiento de un solo paso es correcto antes de restaurar la tarea completa; no es necesario restablecer los tokens de conexión ni aumentar los permisos del cliente por defecto para esto.