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

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

אבחון שגיאה

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

קריאת השגיאה

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

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

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

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

בדיקת מכסות ותקינות השירות

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

קטלוג שגיאות

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

קוד סטטוס או הודעה רזולוציה
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 האזור הגיע באופן זמני לקיבולת המקסימלית
429, RESOURCE_EXHAUSTED, max_instances מספר המכונות המקסימלי חורג מהמגבלה האזורית
500 שגיאת שרת פנימית מתבנית מוכנה מראש שגיאות בתבניות מוכנות מראש
cloudpickle או pydantic התנגשויות בגרסאות כשמבצעים סריאליזציה של הסוכן שגיאות סריאליזציה
NotFound: 404 Can not copy from "gs://..." לא נוצרת ספריית משנה של קטגוריה ב-Cloud Storage
‫iam.serviceAccounts.actAs denied, metadata server unavailable שגיאות בחשבון שירות בהתאמה אישית
400, INVALID_ARGUMENT, REASONING_ENGINE_SECRET_ACCESS_DENIED, referenced by spec.deployment_spec.secret_env שגיאות בגישה ל-Secret Manager
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) נכשלת
כשלים ביצירת ארגז חול בעיות ביצירת ארגז חול
פסק זמן להרצת קוד, כשלים בקלט/פלט של קובץ בארגז חול בעיות בהרצת קוד
‫RuntimeError: Failed to generate memory, או שלא הוחזרו זיכרונות אחרי סשן לא נוצרו זיכרונות

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

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

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

פנייה לתמיכה

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

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

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