Què fer si el mateix comandament s'executa localment però mostra errors de sintaxi a Agent?
Primer confirma el shell que utilitza realment Agent, després corregeix els paràmetres, les cometes i els camins.
L'entrada d'execució pot utilitzar un shell diferent
No jutgis el shell de Agent basant-te només en el sistema operatiu o en el terminal que obres manualment. A Windows, tant les implementacions d'escriptori com les de CLI prioritzen Git Bash; si no el troben, utilitzen cmd; no està fixat a PowerShell. Els escriptoris Unix trien el shell disponible de l'usuari a l'amfitrió, mentre que CLI utilitza bash per a les rutes de comandes ordinàries. Canviar el punt d'entrada pot alterar com s'interpreta la mateixa cadena.
Primer comprova els camins i els mètodes de citació
Fes que Agent confirmi primer el shell real, i després gestiona els camins que contenen espais, URL amb signes d'interrogació o connectors, i la sintaxi de paràmetres específica de la plataforma. Alguns shells tracten els caràcters sense cometes com a comodins, causant errors que semblen fitxers no trobats. No modifiquis només un caràcter sospitós i continuïs l'execució per lots; primer pots dividir la tasca en un sol comandament de només lectura verificable per observar el resultat.
Distingeix els problemes de sintaxi de les eines que falten
Si l'error és 'programa no trobat', primer comprova la instal·lació de l'eina i els camins; si l'accés és denegat, comprova els permisos del sistema; només els errors de processament requereixen centrar-se en corregir la sintaxi del shell. Fins i tot si l'última part del comandament mostra èxit, comprova les sortides d'error anteriors per evitar ignorar fallades parcials. Confirma que el comportament d'un sol pas és correcte abans de restaurar la tasca completa; no cal restablir els tokens de connexió ni augmentar els permisos del client per defecte per a això.