במסמך הזה מפורטות בעיות נפוצות שקשורות להרצת קוד בסביבת ארגז חול מבודדת, ומוצעים פתרונות לבעיות האלה. בין היתר, מוסבר איך לפתור בעיות שקשורות ליצירת ארגז חול, לפסק זמן של הרצה ולקלט/פלט של קבצים.
בעיות ביצירת ארגז חול
שגיאת הרשאות: אם נתקלתם בשגיאות כשניסיתם ליצור ארגז חול, ודאו שלפרויקט Google Cloud שלכם הוקצה התפקיד 'משתמש ב-Agent Platform'
(roles/aiplatform.user)בפלטפורמה לניהול הזהויות והרשאות הגישה (IAM).מזהה פרויקט או מיקום לא תקינים: מוודאים שהמשתנים
PROJECT_IDו-LOCATIONשבהם נעשה שימוש בקוד הם נכונים ונתמכים. רשימת האזורים הנתמכים מופיעה במאמר אזורים נתמכים.לא נוצר Agent Engine: לפני שיוצרים ארגז חול, צריך לוודא שנוצר בהצלחה מופע של Agent Platform. השיטה
agent_engine.create()צריכה להסתיים ללא שגיאות.
בעיות בהרצת קוד
שגיאות בקוד: בודקים את הפלט של
stderrמהתגובה שלexecute_codeכדי לזהות שגיאות תחביר, חריגות בזמן ריצה או פגמים לוגיים בקוד.בעיות בקלט/פלט של קבצים:
הקובץ לא נמצא: צריך לוודא שכל קובצי הקלט שצוינו במערך
filesשלinput_dataמופנים בצורה נכונה בקוד. הקוד מופעל באותה תיקייה שבה נמצאים הקבצים, ואין לו גישה לתיקיות אחרות.קובץ הפלט לא נוצר: בודקים שהקוד כותב לשם קובץ הפלט הצפוי, ואין שגיאות שמונעות את יצירת הקובץ או הכתיבה אליו.
מגבלות גודל: גודל הקובץ המקסימלי הוא 100MB.
שמירת מצב: אם הקוד שלכם מסתמך על מצב קודם, צריך לוודא שאתם משתמשים באותו
sandbox_nameעבור שיחות עוקבות. בנוסף, חשוב לוודא שתוקף הסביבה הווירטואלית לא פג.פסק זמן: הזמן הקצוב לתפוגה של ביצוע הקוד הוא 300 שניות. מומלץ לבצע אופטימיזציה של הקוד לשיפור הביצועים או לחלק משימות מורכבות לשלבים קטנים יותר שקל יותר לנהל.
ניהול וניקוי של ארגז חול
לא נמצא ארגז חול למחיקה: אם לא הצלחתם למחוק ארגז חול, ודאו שאתם משתמשים ב
sandbox_nameהנכון ושהארגז עדיין קיים.לא נמצא Agent Engine למחיקה: בדומה לארגזי חול, צריך לוודא את
agent_engine_nameכשמנסים למחוק את מופע Agent Platform.מכסות משאבים: אם אתם יוצרים הרבה ארגזי חול או מבצעים הרבה הרצות, יכול להיות שתיתקלו במגבלות של מכסות משאבים. בודקים את המכסות של הפרויקט לשירותי Agent Platform ומבקשים הגדלות אם צריך. רשימת המכסות של Agent Engine מופיעה במאמר בנושא מכסות.