הדף הזה הוא נקודת ההתחלה לפתרון בעיות ב-Gemini Enterprise Agent Platform. אפשר להשתמש בו כדי לאבחן שגיאה, לחפש שגיאה ספציפית, למצוא את המדריך למשימה או לקבל תמיכה.
אבחון שגיאה
לפני שמחפשים פתרון ספציפי, כדאי לאסוף את הפרטים הבאים:
קריאת השגיאה
רושמים את קוד הסטטוס, כמו 400 או 429, ואת הטקסט המדויק של ההודעה. אפשר לחפש את שניהם בקטלוג השגיאות.
אפשר גם לזהות את הכשל הספציפי מסיבה שניתנת לקריאה על ידי מכונה, מקישור למסמכים או מתצוגת יומן שסוננה מראש, אם הם מופיעים בהודעת השגיאה.
איפה נמצאים היומנים
כדי לחפש ולסנן את יומני השגיאות של הסוכן, משתמשים בכלי Logs Explorer, מגדירים את סוג המשאב ל-Vertex AI Reasoning Engine, ובוחרים את הערך המתאים של Resource container (מספר הפרויקט) ואת הערך של Reasoning engine ID.
בדיקת מכסות ותקינות השירות
שגיאות שמופיעות לסירוגין, או שהתחילו בלי שביצעתם שינוי בצד שלכם, נובעות בדרך כלל ממכסת שימוש או מאירוע מתמשך:
- משווים את השימוש שלכם למכסות ולמגבלות המערכת.
- כדאי לבדוק את Google Cloud 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
|
שגיאות שקשורות למיצוי משאבים או להגבלת קצב |
500 שגיאת שרת פנימית מתבנית מוכנה מראש |
שגיאות בתבניות מוכנות מראש |
cloudpickle או pydantic גרסאות סותרות כשמבצעים סריאליזציה של הסוכן |
שגיאות בסריאליזציה |
NotFound: 404 Can not copy from "gs://..."
|
לא נוצרת ספריית משנה של קטגוריה ב-Cloud Storage |
iam.serviceAccounts.actAs denied, metadata server
unavailable |
שגיאות מותאמות אישית בחשבון שירות |
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 |
| הצגת מודל או הגעה למכסת המודל | פתרון בעיות בשירותי למידת מכונה |
פנייה לתמיכה
אם המדריכים בדף הזה לא פותרים את הבעיה, אפשר לעיין במאמר קבלת עזרה לסוכנים כדי לקבל מידע על חבילות תמיכה, פורומים של הקהילה ודיווח על באגים. אם יש לכם שאלות בנושא חיוב, תוכלו לעיין במאמר שאלות בנושא חיוב.
אם מדווחים על באג, צריך לספק את הפרטים הבאים:
- קוד סטטוס
- הודעת השגיאה
- (אופציונלי) משוב אם הודעת השגיאה שגויה, מטעה או לא ניתנת לביצוע.