¿Qué hacer si el mismo comando se ejecuta localmente pero muestra errores de sintaxis en Agent?
Primero confirma el shell que 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 rutas que contengan espacios, URLs con signos de interrogación o conectores, y 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 te limites a modificar un carácter sospechoso y continuar la ejecución por lotes; primero puedes dividir la tarea en un solo comando verificable de solo lectura 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 sea correcto antes de restaurar la tarea completa; no es necesario restablecer tokens de conexión ni aumentar los permisos del cliente por defecto para esto.