Pesan error

Pelajari cara menyelesaikan beberapa error yang dilaporkan oleh Agent Platform Vision. Topik ini membahas error yang penyelesaiannya memerlukan lebih banyak langkah daripada yang dapat dijelaskan dengan mudah dalam pesan error.

Lihat dokumentasi Cloud API untuk mengetahui praktik penanganan error yang direkomendasikan.

Izin

Kredensial default aplikasi tidak tersedia

Jika Anda menerima pesan ini:

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.

Izin ditolak

Jika Anda menerima pesan ini:

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"
  }
}

Pastikan Anda memiliki file JSON kunci akun layanan yang valid di lokasi yang disimpan dalam variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS dan bahwa variabel tersebut menunjuk ke tempat yang benar.

Untuk mendiagnosis error ini, coba buka file kunci akun layanan dari folder tempat Anda mencoba memanggil Gemini Enterprise Agent Platform Vision API.

cat $GOOGLE_APPLICATION_CREDENTIALS

Forbidden: 403 POST API has not been used or is disabled

Jika Anda menerima pesan ini:

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. Buka link yang ditentukan dalam pesan error dan aktifkan Agent Platform Vision API. Tunggu beberapa menit, lalu coba lagi.
  2. Pastikan Anda memiliki file JSON kunci akun layanan valid yang tersimpan di variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS. Untuk mendiagnosis error ini, coba buka file kunci akun layanan dari folder tempat Anda mencoba memanggil Gemini Enterprise Agent Platform Vision API.
    cat $GOOGLE_APPLICATION_CREDENTIALS
    

Argumen tidak valid

Versi API tidak didukung

Contoh: saat permintaan dibuat ke versi API yang tidak mendukung operasi.

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

Bad Request

Saat permintaan API dibuat, tetapi kolom permintaan memiliki satu atau beberapa pelanggaran. Setiap pelanggaran diambil sebagai field_violations dalam detail google.rpc.BadRequest.

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

Nomor Project Tidak Valid

Saat nomor project tidak valid diberikan. Contoh nomor project: 848757893952147483648.

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

Format Resource Tidak Valid

Saat format resource tidak valid. Contoh nomor project: 1234 dan Contoh ID lokasi: 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"
    }
}

Prakondisi Gagal

Data Video Tidak Ada

Beberapa API (seperti CreateAnnotation untuk anotasi tingkat partisi), aset harus sudah memiliki data video yang di-streaming untuk menyimpulkan waktu mulai aset. Jika tidak, error berikut akan dipicu.

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"
    }
}

Kuota dan batas

Kuota melampaui batas

Jika Anda menerima pesan ini:

RESOURCE_EXHAUSTED: Quota exceeded.

Anda telah mencapai batas kuota per menit atau harian. Tinjau kuota & batasan untuk menggunakan Agent Platform Vision.

Anda dapat meminta penambahan kuota dari Google Cloud konsol.