Que facer se o mesmo comando se executa localmente pero mostra erros de sintaxe en Agent?
Primeiro confirma o shell realmente usado por Agent, despois corrixe parámetros, comiñas e rutas.
A entrada de execución pode usar un shell diferente
Non xulgues o shell de Agent unicamente en función do sistema operativo ou do terminal que abras manualmente. En Windows, ambas as implementacións de escritorio e CLI priorizan Git Bash; se non o atopan, usan cmd; non está fixo a PowerShell. Os escritorios Unix elixen o shell dispoñible do usuario no host, mentres que CLI usa bash para rutas de comandos ordinarias. Cambiar o punto de entrada pode alterar como se interpreta a mesma cadea.
Primeiro comproba as rutas e os métodos de comiñas
Fai que Agent confirme primeiro o shell real, despois manexa rutas que conteñan espazos, URL con signos de interrogación ou conectores, e sintaxe de parámetros específica da plataforma. Algúns shells tratan os caracteres sen comiñas como comodíns, causando erros que semellan ficheiros non atopados. Non modifiques só un carácter sospeitoso e continúes a execución por lotes; podes primeiro dividir a tarefa nun único comando de só lectura verificable para observar o resultado.
Distingue os problemas de sintaxe das ferramentas que faltan
Se o erro é 'programa non atopado', primeiro comproba a instalación da ferramenta e as rutas; se o acceso é denegado, comproba os permisos do sistema; só os erros de análise requiren centrarse en corrixir a sintaxe do shell. Mesmo se a última parte do comando mostra éxito, comproba as saídas de erro anteriores para evitar ignorar fallos parciais. Confirma que o comportamento dun só paso é correcto antes de restaurar a tarefa completa; non hai necesidade de restablecer tokens de conexión nin de aumentar os permisos do cliente por defecto para isto.