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 Anda mencari perbaikan tertentu, kumpulkan informasi berikut:

Baca error

Catat 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 Jenis resource ke Vertex AI Reasoning Engine, lalu pilih nilai Penampung resource (nomor project Anda) dan nilai ID mesin penalaran yang sesuai.

Memeriksa kuota dan status responsivitas layanan

Error yang muncul sesekali, atau yang dimulai tanpa perubahan di sisi 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 Anda coba selesaikan.

Kode atau pesan status Resolusi
ImportError: cannot import name 'reasoning_engines', ImportError: cannot import name 'agent_engines' Versi Agent Platform SDK for 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
429, RESOURCE_EXHAUSTED, at capacity Kapasitas wilayah sementara penuh
429, RESOURCE_EXHAUSTED, max_instances Jumlah instance maksimum melebihi batas wilayah
Error server internal 500 dari template bawaan Error template bawaan
Konflik versi cloudpickle atau pydantic saat menserialisasi 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
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 yang menggunakan CA pribadi atau sertifikat 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 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 melaporkan bug, berikan informasi berikut:

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