פתרון בעיות ב-Gemini Enterprise Agent Platform

הדף הזה הוא נקודת ההתחלה לפתרון בעיות ב-Gemini Enterprise Agent Platform. אתם יכולים להשתמש בו כדי לאבחן שגיאה, לחפש שגיאה ספציפית, למצוא את המדריך למשימה שלכם או לקבל תמיכה.

אבחון שגיאה

לפני שאתם מחפשים פתרון ספציפי, אספו את המידע הבא:

לקרוא את השגיאה

שימו לב לקוד הסטטוס, כמו 400 או 429, ולטקסט המדויק של ההודעה. אפשר לחפש את שניהם בקטלוג השגיאות.

אפשר גם לזהות את הכשל הספציפי לפי סיבה בפורמט קריא למכונה, קישור למסמך או תצוגת יומן מסוננת מראש, אם הם מופיעים בהודעת השגיאה.

איפה נמצאים היומנים

כדי לחפש ולסנן את יומני השגיאות של הסוכן, משתמשים ב-Logs Explorer, מגדירים את Resource type ל-Vertex AI מנוע חשיבה רציונלית ובוחרים את הערך המתאים של Resource container (מספר הפרויקט) ואת הערך של Reasoning engine ID.

בדיקת המכסות ו-Service Health

שגיאות שמופיעות לסירוגין, או שהתחילו בלי שביצעתם שינוי, נגרמות בדרך כלל בגלל מכסה או אירוע מתמשך:

קטלוג השגיאות

מאתרים בטבלה הבאה את השגיאה שקיבלתם. אם השגיאה לא מופיעה ברשימה, השתמשו במדריכים לפתרון בעיות של המשימה שניסיתם לבצע.

קוד סטטוס או הודעת סטטוס רזולוציה
ImportError: cannot import name 'reasoning_engines', ImportError: cannot import name 'agent_engines' גרסה מיושנת של Agent Platform SDK ל-Python
401 Context-Aware Access requirements are not met, 401 Request had invalid authentication credentials שגיאות הרשאה מסוג 401
ValueError: Cannot get the Candidate text שגיאות ביצירת תוכן
‫failed to start and cannot serve traffic, בפריסה הראשונה של קונטיינר בהתאמה אישית (BYOC) באזור שגיאה ביצירת BYOC בפעם הראשונה
‫failed to start and cannot serve traffic או Request is prohibited by organization's policy, בתוך היקף של VPC Service Controls שגיאות של הפרת VPC-SC
429, RESOURCE_EXHAUSTED שגיאות מסוג "המשאב מוצה" או "הגבלת קצב של יצירת בקשות"
429, RESOURCE_EXHAUSTED, at capacity Region temporarily at capacity
429, RESOURCE_EXHAUSTED, max_instances מספר המכונות המקסימלי חורג מהמגבלה האזורית
שגיאת שרת פנימית אחת (500) מתבנית מוכנה מראש שגיאות בתבניות מוכנות מראש
התנגשויות בין גרסאות של cloudpickle או pydantic כשמבצעים סריאליזציה של הסוכן שגיאות בסריאליזציה
NotFound: 404 Can not copy from "gs://..." לא נוצרה ספריית משנה של קטגוריית Cloud Storage
‫iam.serviceAccounts.actAs נדחה, שרת המטא-נתונים לא זמין שגיאות בחשבון שירות בהתאמה אישית
400, INVALID_ARGUMENT, REASONING_ENGINE_SECRET_ACCESS_DENIED, referenced by spec.deployment_spec.secret_env שגיאות גישה ל-Secret Manager
‫504, DEADLINE_EXCEEDED, REASONING_ENGINE_BUILD_TIMEOUT הזמן הקצוב לתפוגה של פיתוח קובץ האימג' של הקונטיינר נגמר
‫504, DEADLINE_EXCEEDED, REASONING_ENGINE_CONTAINER_START_TIMEOUT הקונטיינר לא הופעל בזמן
InvalidArgument: 400 Provided filter is not valid שגיאה בסינון רשימת הנציגים
‫google.api_core.exceptions.Unknown: None, Failed to convert project number to project ID, במהלך ההפעלה שגיאות במהלך ההפעלה של Agent Runtime
‫403 Forbidden בבקשה יוצאת שגיאות מסוג "403 אסור"
כשלים באימות אישורים שמגיעים ליעד של רשות אישורים (CA) פרטית או עם חתימה עצמית לא מצליחים להתחבר ליעדים עם חתימה עצמית או עם רשות אישורים פרטית
כשלים בלחיצת יד בפרוטוקול TLS מסוכן של קונטיינר בהתאמה אישית (BYOC) הנציג שנפרס עם קונטיינר בהתאמה אישית (BYOC) לא מצליח להתחבר
כשלים ביצירת ארגז חול (sandbox) בעיות ביצירת ארגז חול
זמן קצוב לתפוגה של הרצת הקוד, כשלים בקלט/פלט של קבצים בארגז חול (sandbox) בעיות בהרצת קוד
‫RuntimeError: Failed to generate memory, או שלא הוחזרו זיכרונות אחרי סשן לא נוצרו זיכרונות

מדריכים לפתרון בעיות

אם לא קיבלתם הודעת שגיאה ספציפית, או שהשגיאה לא מופיעה בקטלוג השגיאות, תוכלו להיעזר בטבלה הבאה כדי למצוא את המדריך המתאים למשימה שלכם:

משימה מדריך
התקנת ה-SDK של Agent Platform והגדרת הסביבה הגדרת סביבת Agent Runtime
יצירת סוכן יצירת סוכן
פריסת סוכן ב-Agent Runtime פריסת הסוכן
קריאה לשירות חיצוני מנציג קישוריות של Agent Gateway
הצגה, עדכון או מחיקה של סוכן פעיל ניהול הסוכנים שנפרסו
הרצת קוד בארגז חול (sandbox) הרצת קוד
יצירה או אחזור של זיכרונות ‫Memory Bank ב-Agent Platform
הפעלת מודל או הגעה למכסת המודל פתרון בעיות בשירותי למידת מכונה

פנייה לתמיכה

אם המדריכים בדף הזה לא פותרים את הבעיה, תוכלו לקרוא את המאמר קבלת עזרה בנושא סוכנים כדי לקבל מידע על חבילות תמיכה, פורומים של הקהילה ודיווח על באגים. שאלות בנושא חיוב

אם אתם מדווחים על באג, ציינו את הפרטים הבאים:

  • קוד סטטוס
  • הודעת השגיאה
  • (אופציונלי) משוב אם הודעת השגיאה שגויה, מטעה או לא ניתנת לפעולה.