Làm gì khi cùng lệnh chạy được cục bộ nhưng báo lỗi cú pháp trong Agent?
Xác nhận shell Agent thực sự dùng trước rồi sửa tham số, dấu trích dẫn và đường dẫn.
Điểm thực thi có thể dùng shell khác
Đừng đánh giá shell của Agent chỉ theo hệ điều hành hoặc terminal tự mở. Trên Windows, cả desktop và CLI ưu tiên Git Bash; nếu không tìm thấy thì dùng cmd, không cố định PowerShell. Desktop Unix chọn shell khả dụng của người dùng trên máy, còn CLI dùng bash cho đường lệnh thông thường. Đổi điểm truy cập có thể đổi cách diễn giải cùng chuỗi.
Kiểm tra đường dẫn và cách trích dẫn trước
Yêu cầu Agent xác nhận shell thực tế trước, rồi xử lý đường dẫn có khoảng trắng, URL có dấu hỏi hoặc ký tự nối và cú pháp tham số riêng nền tảng. Một số shell coi ký tự không đặt trong dấu trích dẫn là ký tự đại diện, gây lỗi giống không tìm thấy tệp. Đừng chỉ sửa một ký tự nghi ngờ rồi chạy hàng loạt tiếp; có thể tách tác vụ thành một lệnh chỉ đọc kiểm chứng được trước để quan sát kết quả.
Phân biệt lỗi cú pháp với thiếu công cụ
Nếu lỗi 'không tìm thấy chương trình', kiểm tra cài đặt và đường dẫn trước; nếu từ chối truy cập, kiểm tra quyền hệ thống; chỉ lỗi phân tích cú pháp mới cần tập trung sửa cú pháp shell. Dù phần cuối lệnh báo thành công, vẫn kiểm tra đầu ra lỗi trước đó để tránh bỏ qua thất bại một phần. Xác nhận hành vi từng bước đúng rồi khôi phục toàn bộ tác vụ; không cần mặc định đặt lại mã kết nối hoặc nâng quyền ứng dụng khách vì việc này.