הודעות שגיאה

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

במאמרי העזרה של Cloud API מפורטות שיטות מומלצות לטיפול בשגיאות.

הרשאות

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

אם קיבלתם את ההודעה הזו:

The Application Default Credentials are not available. They are
available if running in Google Compute Engine. Otherwise, the
environment variable GOOGLE_APPLICATION_CREDENTIALS must be defined
pointing to a file defining the credentials.
See https://developers.google.com/accounts/docs/application-default-credentials
for more information.

ההרשאה נדחתה

אם קיבלתם את ההודעה הזו:

ERROR: (gcloud.auth.application-default.print-access-token) File /path/to/key.json
(pointed by GOOGLE_APPLICATION_CREDENTIALS environment variable) does not exist!
{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "status": "PERMISSION_DENIED"
  }
}

מוודאים שיש לכם קובץ JSON תקין של מפתח חשבון שירות במיקום שמאוחסן במשתנה הסביבה GOOGLE_APPLICATION_CREDENTIALS, ושהמשתנה מצביע על המיקום הנכון.

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

cat $GOOGLE_APPLICATION_CREDENTIALS

הגישה נדחתה: לא נעשה שימוש ב-POST API עם קוד 403 או שהוא מושבת

אם קיבלתם את ההודעה:

Forbidden: 403 POST Gemini Enterprise Agent Platform Vision API has not been used in
project # before or it is disabled.
Enable it by visitng [url] then retry.
If you enabled this API recently, wait a few minutes for the action to
propagate and retry.

1. נכנסים לקישור שצוין בהודעת השגיאה ומפעילים את Agent Platform Vision API. מחכים כמה דקות ומנסים שוב.
2. מוודאים שיש לכם קובץ JSON תקין של מפתח חשבון שירות שמאוחסן במשתנה הסביבה GOOGLE_APPLICATION_CREDENTIALS. כדי לאבחן את השגיאה הזו, נסו לפתוח את קובץ המפתח של חשבון השירות מהתיקייה שממנה אתם מנסים לבצע קריאה ל-Gemini Enterprise Agent Platform Vision API.

   cat $GOOGLE_APPLICATION_CREDENTIALS
   

ארגומנטים לא חוקיים

גרסת ה-API לא נתמכת

לדוגמה: כששולחים בקשה לגרסת API שלא תומכת בפעולה.

message: "The requested operation is unsupported for the API version."

בקשה פגומה

כשמתבצעת בקשת API אבל בשדות הבקשה יש הפרה אחת או יותר. כל הפרה מתועדת כfield_violations בפרטים של google.rpc.BadRequest.

message: "Request contains an invalid argument."
details {
  [type.googleapis.com/google.rpc.BadRequest] {
    field_violations { field: "foo" description: "bar" }
  }
}

מספר הפרויקט לא חוקי

כשמספקים מספר פרויקט לא תקין. דוגמה למספר פרויקט: 848757893952147483648.

message: "Invalid project number used: 848757893952147483648."
details {
    [type.googleapis.com/google.rpc.ErrorInfo] {
      reason: "INVALID_PROJECT_NUMBER"
      domain: "visionai.googleapis.com"
    }
}

פורמט המשאב לא תקין

כשפורמט המשאב לא תקין. מספר פרויקט לדוגמה: 1234 ומזהה מיקום לדוגמה: us-central1.

message: "Invalid Resource Used: project/1234/location/us-central1. Valid format should be "
"projects/{project_number}/locations/{location_id}."
details {
    [type.googleapis.com/google.rpc.ErrorInfo] {
      reason: "INVALID_RESOURCE_FORMAT"
      domain: "visionai.googleapis.com"
    }
}

תנאי מוקדם נכשל

נתוני סרטון חסרים

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

message: "Asset doesn't have start time inferred yet. Should ingest asset and retry."
details {
    [type.googleapis.com/google.rpc.ErrorInfo] {
      reason: "FAILED_PRECONDITION"
      domain: "visionai.googleapis.com"
    }
}

מכסות ומגבלות

חריגה מהמכסה

אם קיבלתם את ההודעה הזו:

RESOURCE_EXHAUSTED: Quota exceeded.

הגעתם למכסה לדקה או למכסה היומית. כדאי לעיין במכסות ובמגבלות לשימוש ב-Agent Platform Vision.

אפשר לבקש להגדיל את המכסות דרך Google Cloud המסוף.