Що робити, якщо команда працює локально, але Agent показує синтаксичну помилку?
Перевірте фактичну оболонку Agent, потім виправте параметри, лапки й шляхи.
Спосіб виконання може використовувати іншу оболонку
Не визначайте оболонку Agent лише за системою або вручну відкритим терміналом. У Windows і настільний клієнт, і CLI насамперед використовують Git Bash, а без нього — cmd, а не обов'язково PowerShell. Настільні клієнти Unix вибирають доступну оболонку користувача хоста, тоді як звичайні командні шляхи CLI використовують bash. Зміна способу запуску може змінити тлумачення того самого рядка.
Спочатку перевірте шляхи й лапки
Нехай Agent перевірить фактичну оболонку, потім опрацює шляхи з пробілами, URL зі знаками питання чи з'єднувачами та платформний синтаксис параметрів. Деякі оболонки трактують символи без лапок як шаблони, що дає помилки, схожі на відсутні файли. Не змінюйте лише один підозрілий символ і не продовжуйте групове виконання. Спочатку виділіть одну перевірювану команду читання й оцініть результат.
Розрізняйте синтаксис і відсутні інструменти
За «програму не знайдено» перевірте встановлення й шляхи; за відмови доступу — системні права; виправляти синтаксис оболонки потрібно саме за помилок розбору. Навіть успіх кінця команди не скасовує попередніх помилок: перегляньте їх, щоб не пропустити часткові збої. Перевірте один крок перед повним завданням. Для цього зазвичай не потрібно скидати токени чи підвищувати права клієнта.