Kuota dan batas sistem

Agent Registry menggunakan kuota dan batas sistem untuk mempertahankan alokasi resource yang adil, mencegah kelebihan beban layanan, dan membantu Anda mengelola penggunaan resource.

Kuota dan batas sistem serupa, tetapi berbeda dalam hal berikut:

  • Kuota memiliki nilai default, tetapi biasanya Anda dapat meminta penyesuaian.
  • Batas sistem adalah nilai tetap yang tidak dapat diubah.

Google Cloud menggunakan kuota untuk membantu menjaga keadilan dan mengurangi lonjakan penggunaan dan ketersediaan resource. Kuota membatasi jumlah Google Cloud resource yang dapat digunakan Google Cloud project Anda. Kuota berlaku untuk berbagai jenis resource, termasuk komponen hardware, software, dan jaringan. Misalnya, kuota dapat membatasi jumlah panggilan API ke suatu layanan, jumlah load balancer yang digunakan secara bersamaan oleh project Anda, atau jumlah project yang dapat Anda buat. Kuota melindungi komunitas penggunaGoogle Cloud dengan mencegah kelebihan beban layanan. Kuota juga membantu Anda mengelola resource Google Cloud sendiri.

Sistem Kuota Cloud melakukan hal berikut:

Dalam sebagian besar kasus, saat Anda mencoba menggunakan resource melebihi kuota yang diizinkan, sistem akan memblokir akses ke resource tersebut, dan tugas yang Anda coba lakukan akan gagal.

Kuota umumnya berlaku di level Google Cloud project. Penggunaan resource dalam satu project tidak memengaruhi kuota yang tersedia dalam project lain. Dalam project Google Cloud , kuota dibagikan ke semua aplikasi dan alamat IP.

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Kuota Cloud.

Kuota alokasi

Kuota alokasi membatasi jumlah resource tertentu yang dapat Anda gunakan di Agent Registry pada waktu tertentu. Saat Anda membuat resource, kuota yang tersedia untuk resource tersebut akan berkurang. Saat Anda menghapus resource, kuota akan dipulihkan.

Tabel berikut mencantumkan kuota alokasi yang berlaku untuk Agent Registry dan nilai default untuk setiap kuota.

Kuota Nilai
Agen maksimum per project 100 (Global dan per region)
Server MCP maksimum per project 100 (Global dan per region)
Endpoint maksimum per project 100 (Global dan per region)
Binding maksimum per project 100 (Global dan per region)
Kemampuan A2A maksimum per project 100 (Global dan per region)
Keterampilan mandiri maksimum per project per lokasi 100 (Global, multi-region, dan per region)
Revisi skill maksimum per project per lokasi, yang digunakan bersama di semua skill di lokasi tersebut 500 (Global, multi-region, dan per region)

Kuota kapasitas

Kuota kapasitas membatasi kapasitas penggunaan resource. Kuota kapasitas per menit direset setiap menit. Tabel berikut mencantumkan kuota kapasitas yang berlaku untuk Agent Registry dan nilai default untuk setiap kuota.

Kuota Nilai
Menggabungkan permintaan API di seluruh metode global dan regional 12.000 per menit per project (200 QPS)
Permintaan API global 1.200 per menit per project (20 QPS)
Permintaan API regional 1.200 per menit per project per region (20 QPS)
Membuat, memperbarui, dan menghapus permintaan untuk keahlian dan revisi keahlian 120 per menit per project per lokasi (2 QPS. Global, multi-region, dan per region)
Mendapatkan, mencantumkan, dan menelusuri permintaan untuk keahlian dan revisi keahlian 1.200 per menit per project per lokasi (20 QPS. Global, multi-region, dan per region)

Batas sistem

Tabel berikut mencantumkan batas sistem yang berlaku untuk Agent Registry dan nilai untuk setiap batas sistem.

Batas sistem Nilai
Panjang nama tampilan 63 karakter (layanan dan binding); 128 karakter (keahlian)
Panjang deskripsi 2.048 karakter
Ukuran konten spesifikasi agen 10 KB
Ukuran konten spesifikasi server MCP 10 KB
Ukuran payload skill terkompresi maksimum (ZIP) 1 MB
Ukuran total maksimum payload keterampilan tanpa kompresi untuk keterampilan yang dipindai 10 MB, diterapkan saat pemindaian diaktifkan
Ukuran file individual maksimum yang tidak dikompresi dalam payload keterampilan untuk keterampilan yang dipindai 1 MB, diterapkan saat pemindaian diaktifkan
Keterampilan atau alat A2A maksimum per layanan 100
Ukuran penomoran halaman maksimum 100
Project anggota maksimum per project pengelolaan untuk rollup lintas project 10.000

Kuota layanan downstream dan A2A agentic

Saat agen orchestrator Anda menemukan dan memanggil agen Agent2Agent (A2A) atau alat Model Context Protocol (MCP), Google Cloud akan mengevaluasi konsumsi kuota di tiga lapisan terpisah:

  • Kuota penemuan dan pengelolaan registry: kuota alokasi dan kuota kapasitas yang tercantum dalam dokumen ini hanya mengatur permintaan pendaftaran, pengelolaan, penelusuran, dan pencarian metadata yang dikirim ke Agent Registry. Agen runtime dan panggilan alat tidak menggunakan kuota kapasitas Agent Registry setelah klien Anda mencari URL endpoint server MCP atau agen target.
  • Kuota runtime agen target: setiap runtime atau layanan Google Cloud target menerapkan kuota kapasitasnya sendiri. Untuk batas khusus layanan, lihat dokumentasi kuota untuk layanan target atau lihat kuota khusus API.
  • Kuota token dan API per layanan downstream: saat agen A2A memanggil API downstream Google Cloud atau alat MCP, panggilan tersebut menggunakan kuota kapasitas API per layanan dari project kuota atau project resource yang ditagih untuk setiap permintaan. Loop penalaran otonom, percobaan ulang, dan sub-agen paralel dapat menghasilkan traffic burst terhadap kuota project bersama. Pantau penggunaan di Kuota Cloud dan kurangi penggunaan dengan meminta nilai kuota yang lebih rendah seperti yang dijelaskan dalam Melihat dan mengelola kuota. Untuk membantu membatasi konsumsi token LLM bersama di seluruh traffic agen keluar, konfigurasikan kebijakan pengelolaan token di Secure Web Proxy dan Agent Gateway.

Mendapatkan nama metrik kuota dan batas sistem

Kuota dan batas sistem memiliki dua jenis nama: nama tampilan dan nama metrik. Nama tampilan memiliki spasi dan huruf kapital yang membuatnya lebih mudah dibaca manusia. Nama metrik cenderung menggunakan huruf kecil dan dibatasi oleh garis bawah, bukan spasi; format persisnya bergantung pada layanan.

Petunjuk berikut menunjukkan cara mendapatkan nama metrik untuk kuota dan batas sistem menggunakan konsol Google Cloud atau Google Cloud CLI.

Konsol

  1. Di konsol Google Cloud , buka halaman IAM & Admin > Quotas & System Limits:

    Buka Quotas & System Limits

    Tabel di halaman ini menampilkan kuota dan batas sistem yang memiliki penggunaan atau telah menyesuaikan nilai, serta entri referensi untuk kuota lainnya. Entri referensi memiliki kata "default" dalam tanda kurung di akhir listingan di kolom Name. Misalnya, SetIAMPolicy requests per minute per region (default) adalah entri referensi untuk kuota SetIamPolicyRequestsPerMinutePerProject.

  2. Jika Anda tidak melihat kolom Metrik, lakukan langkah-langkah berikut.

    1. Klik Column display options.
    2. Pilih Metrik.
    3. Klik Oke. Kolom Metrik akan muncul di tabel.

Kolom Metric menampilkan nama metrik. Untuk memfilter hasil, masukkan nama atau nilai properti di kolom di samping Filter.

gcloud

Untuk mendapatkan nama metrik layanan Google Cloud menggunakan gcloud CLI, jalankan perintah quotas info list. Untuk melewati baris yang tidak mencantumkan nama metrik, teruskan output ke perintah seperti grep dengan metric: sebagai istilah penelusuran, atau gunakan flag --format gcloud CLI:

gcloud beta quotas info list --project=PROJECT_ID_OR_NUMBER \
    --service=SERVICE_NAME --format="value(metric)"

Ganti kode berikut:

  • PROJECT_ID_OR_NUMBER: project ID atau nomor project.
  • SERVICE_NAME: nama layanan yang metrik kuotanya ingin Anda lihat, misalnya, nama layanan untuk Compute Engine adalah compute.googleapis.com. Sertakan bagian googleapis.com dari nama layanan.

Meminta penyesuaian kuota

Untuk menyesuaikan sebagian besar kuota, gunakan konsol Google Cloud . Untuk mengetahui informasi selengkapnya, lihat Meminta penyesuaian kuota.