Memecahkan masalah Gemini Enterprise Agent Platform

Halaman ini adalah titik awal untuk memecahkan masalah Gemini Enterprise Agent Platform. Gunakan untuk mendiagnosis error, mencari error tertentu, menemukan panduan untuk tugas Anda, atau mendapatkan dukungan.

Mendiagnosis error

Sebelum mencari perbaikan tertentu, kumpulkan informasi berikut:

Baca error

Perhatikan kode status, seperti 400 atau 429, dan teks pesan yang tepat. Anda dapat mencari keduanya di katalog error.

Anda juga dapat mengidentifikasi kegagalan tertentu dari alasan yang dapat dibaca mesin, link dokumentasi, atau tampilan log yang telah difilter sebelumnya jika ada dalam pesan error.

Menemukan log

Untuk menelusuri dan memfilter log error agen, gunakan Logs Explorer, tetapkan Resource type ke Vertex AI Reasoning Engine, lalu pilih nilai Resource container (nomor project Anda) dan nilai Reasoning engine ID yang sesuai.

Memeriksa kuota dan Service Health

Error yang muncul sesekali, atau yang dimulai tanpa perubahan di pihak Anda, sering kali disebabkan oleh kuota atau insiden yang sedang berlangsung:

Katalog error

Temukan error yang Anda terima dalam tabel berikut. Jika error Anda tidak tercantum, gunakan panduan pemecahan masalah untuk tugas yang ingin Anda selesaikan.

Kode atau pesan status Resolusi
ImportError: cannot import name 'reasoning_engines', ImportError: cannot import name 'agent_engines' Versi lama Agent Platform SDK untuk Python
401 Context-Aware Access requirements are not met, 401 Request had invalid authentication credentials Error otorisasi 401
ValueError: Cannot get the Candidate text Error pembuatan konten
failed to start and cannot serve traffic, pada deployment container kustom (BYOC) pertama Anda di suatu region Error pembuatan pertama kali BYOC
failed to start and cannot serve traffic atau Request is prohibited by organization's policy, di dalam perimeter Kontrol Layanan VPC Error pelanggaran VPC-SC
429, RESOURCE_EXHAUSTED Error resource habis atau pembatasan kapasitas
429, RESOURCE_EXHAUSTED, at capacity Region sementara mencapai kapasitas maksimum
429, RESOURCE_EXHAUSTED, max_instances Instance maksimum melebihi batas regional
Error server internal 500 dari template bawaan Error template bawaan
Konflik versi cloudpickle atau pydantic saat melakukan serialisasi agen Anda Error serialisasi
NotFound: 404 Can not copy from "gs://..." Subdirektori bucket Cloud Storage tidak dibuat
iam.serviceAccounts.actAs ditolak, server metadata tidak tersedia Error akun layanan kustom
400, INVALID_ARGUMENT, REASONING_ENGINE_SECRET_ACCESS_DENIED, referenced by spec.deployment_spec.secret_env Error akses Secret Manager
504, DEADLINE_EXCEEDED, REASONING_ENGINE_BUILD_TIMEOUT Waktu tunggu build image container habis
504, DEADLINE_EXCEEDED, REASONING_ENGINE_CONTAINER_START_TIMEOUT Container tidak dimulai tepat waktu
InvalidArgument: 400 Provided filter is not valid Terjadi error saat memfilter daftar agen
google.api_core.exceptions.Unknown: None, Failed to convert project number to project ID, selama startup Error selama startup Agent Runtime
403 Forbidden pada permintaan keluar Error 403 Forbidden
Kegagalan verifikasi sertifikat saat mencapai tujuan CA yang ditandatangani sendiri atau pribadi Tujuan CA yang ditandatangani sendiri atau pribadi gagal terhubung
Kegagalan TLS handshake dari agen container kustom (BYOC) Agen yang di-deploy dengan container kustom (BYOC) gagal terhubung
Kegagalan pembuatan sandbox Masalah pembuatan sandbox
Waktu tunggu eksekusi kode habis, kegagalan I/O file di sandbox Masalah eksekusi kode
RuntimeError: Failed to generate memory, atau tidak ada memori yang ditampilkan setelah sesi Tidak ada memori yang dibuat

Panduan pemecahan masalah

Jika Anda tidak memiliki pesan error tertentu, atau error Anda tidak ada dalam katalog error, lihat tabel berikut untuk mengetahui panduan yang sesuai untuk tugas Anda:

Tugas Panduan
Menginstal SDK Agent Platform dan menyiapkan lingkungan Anda Penyiapan lingkungan Agent Runtime
Membuat agen Membuat agen
Men-deploy agen ke Agent Runtime Deployment agen
Memanggil layanan eksternal dari agen Konektivitas Agent Gateway
Mencantumkan, memperbarui, atau menghapus agen yang di-deploy Mengelola agen yang di-deploy
Menjalankan kode di sandbox Eksekusi Kode
Membuat atau mengambil memori Memory Bank Agent Platform
Menyajikan model atau mencapai kuota model Memecahkan masalah layanan machine learning

Mendapatkan dukungan

Jika panduan di halaman ini tidak menyelesaikan masalah Anda, lihat Mendapatkan bantuan untuk agen guna mengetahui paket dukungan, forum komunitas, dan pelaporan bug. Untuk pertanyaan terkait penagihan, lihat Pertanyaan terkait penagihan.

Jika Anda melaporkan bug, berikan informasi berikut:

  • Kode status
  • Pesan error
  • (Opsional) Masukan jika pesan error salah, menyesatkan, atau tidak dapat ditindaklanjuti.