ماذا تفعل إذا تم تشغيل نفس الأمر محليًا ولكنه يُظهر أخطاء في بناء الجملة في Agent؟
أولاً، قم بتأكيد الصدفة (shell) التي يستخدمها Agent بالفعل، ثم قم بتصحيح المعلمات والاقتباسات والمسارات.
قد يستخدم نقطة الدخول للتنفيذ صدفة مختلفة
لا تحكم على صدفة Agent بناءً على نظام التشغيل أو الطرفية التي تفتحها يدويًا فقط. على Windows، تعطي كل من تطبيقات سطح المكتب و CLI الأولوية لـ Git Bash؛ إذا لم يتم العثور عليه، فإنها تستخدم cmd؛ وهي ليست ثابتة على PowerShell. تختار أسطح Unix صدفة المستخدم المتاحة على المضيف، بينما تستخدم CLI bash لمسارات الأوامر العادية. قد يؤدي تغيير نقطة الدخول إلى تغيير كيفية تفسير نفس السلسلة.
تحقق أولاً من المسارات وطرق الاقتباس
اجعل Agent يؤكد الصدفة الفعلية أولاً، ثم تعامل مع المسارات التي تحتوي على مسافات، وعناوين URL التي تحتوي على علامات استفهام أو موصلات، وبناء جملة المعلمات الخاص بالمنصة. تعامل بعض الصدفات الأحرف غير المقتبسة كأحرف بدل (wildcards)، مما يتسبب في أخطاء تبدو وكأنها ملفات غير موجودة. لا تقم فقط بتعديل حرف واحد مشبوه ومتابعة التنفيذ المجمع؛ يمكنك أولاً تقسيم المهمة إلى أمر واحد قابل للتحقق للقراءة فقط لملاحظة النتيجة.
فرق بين مشاكل بناء الجملة والأدوات المفقودة
إذا كان الخطأ هو 'لم يتم العثور على البرنامج'، فتحقق أولاً من تثبيت الأداة والمسارات؛ إذا تم رفض الوصول، فتحقق من أذونات النظام؛ فقط أخطاء التحليل تتطلب التركيز على تصحيح بناء جملة الصدفة. حتى لو أظهر الجزء الأخير من الأمر نجاحًا، فتحقق من مخرجات الأخطاء السابقة لتجنب تجاهل الفشل الجزئي. قم بتأكيد أن السلوك أحادي الخطوة صحيح قبل استعادة المهمة الكاملة؛ لا حاجة لإعادة تعيين رموز الاتصال أو رفع أذونات العميل افتراضيًا لهذا.