Cosa fare se lo stesso comando funziona localmente ma mostra errori di sintassi in Agent?
Conferma prima la shell effettivamente usata da Agent, poi correggi parametri, virgolette e percorsi.
Il punto di esecuzione può usare una shell diversa
Non dedurre la shell di Agent soltanto dal sistema operativo o dal terminale che apri manualmente. Su Windows, sia il desktop sia la CLI danno priorità a Git Bash; se non lo trovano usano cmd, non necessariamente PowerShell. I desktop Unix scelgono la shell dell'utente disponibile sull'host, mentre la CLI usa bash per i normali percorsi di esecuzione dei comandi. Cambiare punto di avvio può modificare il modo in cui viene interpretata la stessa stringa.
Controlla prima percorsi e uso delle virgolette
Chiedi prima ad Agent di confermare la shell effettiva, poi gestisci percorsi con spazi, URL con punti interrogativi o connettori e sintassi dei parametri specifica della piattaforma. Alcune shell trattano i caratteri senza virgolette come caratteri jolly, causando errori simili a file non trovati. Non limitarti a modificare un carattere sospetto e proseguire con l'esecuzione in blocco; puoi prima ridurre l'attività a un singolo comando verificabile in sola lettura e osservarne il risultato.
Distingui i problemi di sintassi dagli strumenti mancanti
Se l'errore è 'program not found', controlla prima installazione e percorsi degli strumenti; se l'accesso è negato, verifica i permessi di sistema; soltanto gli errori di interpretazione richiedono di concentrarsi sulla sintassi della shell. Anche se l'ultima parte del comando indica successo, controlla gli errori precedenti per non ignorare fallimenti parziali. Conferma che il singolo passaggio funzioni correttamente prima di ripristinare l'attività completa; non occorre per questo reimpostare i token di connessione o elevare per impostazione predefinita i permessi del client.