Que faire si la même commande s'exécute localement mais affiche des erreurs de syntaxe dans Agent ?
Confirmez d'abord le shell réellement utilisé par Agent, puis corrigez les paramètres, les guillemets et les chemins.
Le point d'entrée d'exécution peut utiliser un shell différent
Ne jugez pas le shell de Agent uniquement en fonction du système d'exploitation ou du terminal que vous ouvrez manuellement. Sur Windows, les implémentations de bureau et CLI privilégient Git Bash; s'il n'est pas trouvé, elles utilisent cmd; ce n'est pas fixe à PowerShell. Les bureaux Unix choisissent le shell disponible de l'utilisateur sur l'hôte, tandis que CLI utilise bash pour les chemins de commande ordinaires. La modification du point d'entrée peut altérer la façon dont la même chaîne est interprétée.
Vérifiez d'abord les chemins et les méthodes de mise entre guillemets
Demandez d'abord à Agent de confirmer le shell réel, puis gérez les chemins contenant des espaces, les URL avec des points d'interrogation ou des connecteurs, et la syntaxe des paramètres spécifiques à la plateforme. Certains shells traitent les caractères non mis entre guillemets comme des jokers, provoquant des erreurs qui ressemblent à des fichiers introuvables. Ne modifiez pas simplement un caractère suspect et ne continuez pas l'exécution par lots; vous pouvez d'abord diviser la tâche en une seule commande vérifiable en lecture seule pour observer le résultat.
Distinguez les problèmes de syntaxe des outils manquants
Si l'erreur est « programme introuvable », vérifiez d'abord l'installation et les chemins des outils; si l'accès est refusé, vérifiez les autorisations système; seules les erreurs d'analyse nécessitent de se concentrer sur la correction de la syntaxe du shell. Même si la dernière partie de la commande réussit, vérifiez les sorties d'erreur précédentes pour éviter d'ignorer les échecs partiels. Confirmez que le comportement en une seule étape est correct avant de restaurer la tâche complète; il n'est pas nécessaire de réinitialiser les jetons de connexion ou d'augmenter les autorisations du client par défaut pour cela.