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 Anda mencari perbaikan tertentu, kumpulkan informasi berikut:
Baca error
Catat kode status, seperti 400 atau 429, dan teks pesan yang tepat. Anda
dapat mencarinya 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 Jenis resource ke Vertex AI Reasoning Engine, lalu pilih nilai Penampung resource (nomor project Anda) dan nilai ID mesin inferensi yang sesuai.
Memeriksa kuota dan status layanan
Error yang muncul sesekali, atau yang dimulai tanpa perubahan di sisi Anda, sering kali disebabkan oleh kuota atau insiden yang sedang berlangsung:
- Bandingkan penggunaan Anda dengan Kuota dan batas sistem.
- Periksa Google Cloud Service Health untuk mengetahui insiden yang sedang terjadi di wilayah Anda.
Katalog error
Temukan error yang Anda terima dalam tabel berikut. Jika error Anda tidak tercantum, gunakan panduan pemecahan masalah untuk tugas yang Anda coba selesaikan.
| Kode atau pesan status | Resolusi |
|---|---|
ImportError: cannot import name 'reasoning_engines',
ImportError: cannot import name 'agent_engines' |
Versi Agent Platform SDK untuk Python yang sudah usang |
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 karena resource habis atau batas laju terlampaui |
Error server internal 500 dari template bawaan |
Error template bawaan |
cloudpickle atau konflik versi pydantic saat
melakukan serialisasi agen |
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 |
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 yang mencapai tujuan CA pribadi atau yang ditandatangani sendiri | Tujuan CA pribadi atau yang ditandatangani sendiri gagal terhubung |
| Kegagalan handshake TLS dari agen container kustom (BYOC) | Agen yang di-deploy dengan penampung kustom (BYOC) gagal terhubung |
| Kegagalan pembuatan sandbox | Masalah pembuatan sandbox |
| Eksekusi kode kehabisan waktu, kegagalan I/O file di sandbox | Masalah eksekusi kode |
RuntimeError: Failed to generate memory, atau tidak ada kenangan yang ditampilkan setelah sesi |
Tidak ada kenangan 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 kenangan | 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 untuk mengetahui paket dukungan, forum komunitas, dan pelaporan bug. Untuk pertanyaan terkait penagihan, lihat Pertanyaan terkait penagihan.
Jika Anda mengajukan bug, berikan informasi berikut:
- Kode status
- Pesan error
- (Opsional) Masukan jika pesan error salah, menyesatkan, atau tidak dapat ditindaklanjuti.