מה לעשות אם אותה פקודה פועלת מקומית אך מציגה שגיאות תחביר ב-Agent?
ראשית, אשר את ה-shell שבו נעשה שימוש בפועל על ידי Agent, ולאחר מכן תקן פרמטרים, ציטוטים ונתיבים.
נקודת הכניסה לביצוע עשויה להשתמש ב-shell שונה
אל תשפוט את ה-shell של Agent אך ורק על סמך מערכת ההפעלה או הטרמינל שאתה פותח ידנית. ב-Windows, גם יישומי שולחן העבודה וגם CLI נותנים עדיפות ל-Git Bash; אם הוא לא נמצא, הם משתמשים ב-cmd; זה לא קבוע ל-PowerShell. שולחנות עבודה של Unix בוחרים את ה-shell הזמין של המשתמש במארח, בעוד CLI משתמש ב-bash עבור נתיבי פקודה רגילים. שינוי נקודת הכניסה עשוי לשנות כיצד אותו מחרוזת מתפרשת.
בדוק תחילה נתיבים ושיטות ציטוט
תן ל-Agent לאשר תחילה את ה-shell בפועל, ולאחר מכן טפל בנתיבים המכילים רווחים, כתובות URL עם סימני שאלה או מחברים, ותחביר פרמטרים ספציפי לפלטפורמה. חלק מה-shells מתייחסים לתווים לא מצוטטים כאל תווים כלליים (wildcards), מה שגורם לשגיאות שנראות כמו קבצים שלא נמצאו. אל תשנה רק תו אחד חשוד והמשך בביצוע אצווה; אתה יכול תחילה לפצל את המשימה לפקודה אחת הניתנת לאימות לקריאה בלבד כדי לצפות בתוצאה.
הבחן בין בעיות תחביר לכלים חסרים
אם השגיאה היא 'program not found', בדוק תחילה את התקנת הכלים והנתיבים; אם הגישה נדחתה, בדוק את הרשאות המערכת; רק שגיאות ניתוח דורשות התמקדות בתיקון תחביר ה-shell. גם אם החלק האחרון של הפקודה מראה הצלחה, בדוק פלטי שגיאה קודמים כדי להימנע מהתעלמות מכשלונות חלקיים. אשר שהתנהגות שלב בודד נכונה לפני שחזור המשימה המלאה; אין צורך לאפס אסימוני חיבור או להעלות הרשאות לקוח כברירת מחדל עבור זה.