Halaman ini menunjukkan cara menyelesaikan masalah terkait Agent Registry.
Kuota kapasitas API terlampaui
Anda mungkin mengalami masalah ini jika berinteraksi dengan Agent Registry API atau menavigasi Agent Registry dengan cepat di konsol Google Cloud :
429 Too Many Requests
Untuk mengatasi masalah ini, terapkan backoff eksponensial di klien API Anda untuk mengelola rasio permintaan. Agent Registry API memiliki kuota kapasitas default 1.200 permintaan per menit secara global dan per region.
Jika Anda mengalami pembatasan saat beralih tab di Google Cloud konsol, tunggu beberapa saat dan coba lagi. Jika kasus penggunaan terprogram Anda memerlukan batas yang lebih tinggi, minta penambahan kuota untuk metrik RequestsPerMinute.
Error ukuran payload selama pendaftaran manual
Anda mungkin mengalami masalah ini jika mendaftarkan agen atau server MCP secara manual: API menolak permintaan dengan error yang menyatakan bahwa payload terlalu besar.
Untuk mengatasi masalah ini, verifikasi bahwa file agent-card.json atau toolspec.json
Anda berukuran kurang dari 10 KB. Ukuran konten AgentSpec dan McpServerSpec dibatasi hingga 10 KB. Perkecil file JSON, hapus spasi yang tidak perlu, atau ringkas deskripsi alat agar sesuai dengan batas ini. Untuk mengetahui
informasi selengkapnya, lihat skema JSON.
Agen atau server MCP tidak ada setelah pembuatan
Anda mungkin mengalami masalah ini jika membuat server agen atau MCP di
produk Google Cloud yang didukung, seperti Google Workspace atau
Gemini Enterprise: resource tidak muncul saat memanggil API
ListAgents atau ListMcpServers.
Untuk mengatasi masalah ini, tunggu hingga sinkronisasi latar belakang selesai. Sumber daya Anda diperbarui secara real time, tetapi integrasi lain diisi oleh tugas batch offline yang berjalan secara berkala. Jika resource Anda tidak muncul setelah beberapa jam, verifikasi setelan Penggunaan Layanan project Anda dan pastikan API yang relevan diaktifkan.
Operasi yang berjalan lama tampak macet
Anda mungkin mengalami masalah ini jika men-deploy agen atau mengonfigurasi binding yang kompleks: operasi memerlukan waktu yang cukup lama dan tampak macet.
Untuk mengatasi masalah ini, gunakan alat MCP get_operation atau endpoint API
google.longrunning.Operations.GetOperation untuk melakukan polling status operasi. Beberapa pembuatan backend agen dan MCP memerlukan penyediaan infrastruktur yang signifikan, yang dapat menyebabkan waktu operasi yang berjalan lama (LRO) yang mungkin memerlukan waktu hingga 30 menit. Konfigurasi setelan waktu tunggu klien Anda
sebagai hasilnya dan polling tanda boolean done untuk memverifikasi penyelesaian.
Hasil kosong saat mengambil binding yang tersedia
Anda mungkin mengalami masalah ini jika mengambil binding yang tersedia untuk penyedia
auth: API menampilkan empty array atau error akses, meskipun Anda telah memverifikasi
bahwa binding ada.
Untuk mengatasi masalah ini, pastikan prinsipal Anda memiliki izin Identity and Access Management (IAM) yang benar pada resource AuthProvider target. API
menerapkan pemeriksaan IAM yang ketat dan menghapus objek Binding yang
mereferensikan penyedia autentikasi yang tidak dapat diakses oleh pemanggil. Pastikan pokok keamanan Anda memiliki akses yang diperlukan di penyedia autentikasi dan peran roles/agentregistry.viewer di project.