Agent Registry memungkinkan Anda mendaftarkan dan menemukan komponen agentic di
Google Cloud region, multi-region, atau di lokasi global
tertentu untuk memenuhi persyaratan latensi, ketersediaan, dan residensi data Anda.
Memilih lokasi yang sesuai akan mencakup penemuan komponen dan pemilihan rute gateway di seluruh project tata kelola dan workload Anda.
Untuk mengetahui informasi selengkapnya tentang region dan zona, lihat
Geografi dan region.
Cakupan tata kelola di seluruh lokasi regional dan global
Saat men-deploy dan mengatur arsitektur agen di seluruh Registry Agen, Gateway Agen, dan Identity and Access Management (IAM), pertimbangkan aturan lokasi dan cakupan berikut:
- Server MCP jarak jauh Google Cloud Google dan: saat
Registry Agen otomatis mendaftarkan
server MCP jarak jauh Google Cloud Google atau
untuk API yang diaktifkan, registry ini hanya membuat resource
McpServerdi lokasiglobal, bukan di region individual sepertius-central1. Jika layanan menyediakan endpoint regional (REP), sepertihttps://SERVICE.REGION.rep.googleapis.com/mcp, Agent Registry mencantumkan URL regional tersebut di kolominterfacesdari satu resourceglobalMcpServertersebut:- Gunakan
globaluntuk server yang terdaftar secara otomatis: tentukan lokasiglobalsaat Anda mengkueri server di Agent Registry dengan--location=globalatau menerapkan kebijakan Identity-Aware Proxy (IAP) ke server tersebut dengan--region=global. Jika Anda menentukan region sepertius-central1, perintah akan menampilkan errorNOT_FOUNDkarena tidak ada resourceMcpServerregional di sana secara default. - Daftarkan di region untuk residensi data: jika Anda perlu menyimpan
metadata registry di region tertentu, deploy server MCP kustom ke
runtime
Cloud Run
atau
Google Kubernetes Engine (GKE)
regional, atau
daftarkan secara manual
server MCP dan URL endpoint regionalnya di region tersebut, lalu
terapkan kebijakan IAP Anda di region yang sama. Saat
Agent Gateway me-resolve URL target, entri registry regional
lebih diprioritaskan daripada entri
global. Untuk informasi pemecahan masalah, lihat Server MCP jarak jauh tidak ditemukan di lokasi regional.
- Gunakan
- Gateway regional yang mengatur server MCP global: Agent Gateway yang di-deploy di lokasi regional, seperti
us-central1, dapat mengatur dan merutekan traffic ke server MCPglobal. Filter pencarian registry gateway mengkueri resource regional danglobal. - Binding kebijakan egress: menerapkan binding otorisasi egress IAP di lokasi yang sama dengan tempat resource target didaftarkan di Agent Registry:
- Untuk server MCP Google dan Google Cloud jarak jauh yang terdaftar secara otomatis, terapkan binding di
globaldengan--region=global, bahkan saat agen panggilan mengirim traffic melalui gateway regional. - Untuk resource yang terdaftar di region tertentu, terapkan binding di region tersebut. Untuk informasi pemecahan masalah, lihat Error entitas resource tidak ditemukan saat mengelola kebijakan IAP.
- Untuk server MCP Google dan Google Cloud jarak jauh yang terdaftar secara otomatis, terapkan binding di
- Lokasi pendaftaran: Anda dapat membuat binding dan mendaftarkan komponen agen dan skill mandiri secara manual, di lokasi regional yang didukung, multi-region yang didukung, atau lokasi
global. - Batas pengelolaan lintas project: saat Anda mengonfigurasi
batas pengelolaan, rollup lintas project
didukung di semua lokasi Google Cloud yang didukung di
project pengelolaan Anda.
Membuat kueri lokasi pada project pengelolaan akan menggabungkan komponen yang ditemukan secara otomatis yang di-deploy di lokasi yang sama di seluruh project pengelolaan dan semua project anggota dalam batasan. Hasil kueri juga mencakup resource
ServicedanBindingyang dibuat di lokasi tersebut pada project pengelolaan. Untuk mengetahui detailnya, lihat Rollup kueri terpusat. - Penyelarasan regional untuk penegakan kebijakan: jika Anda mengonfigurasi
filter kebijakan Model Armor
di Agent Gateway, gateway, template Model Armor, serta ekstensi dan kebijakan otorisasi harus berada di
region yang sama. Karena Model Armor memeriksa payload permintaan dan respons di gateway regional, gateway masih dapat memeriksa dan mengatur traffic yang dirutekan ke server MCP yang terdaftar di lokasi
globalserta tujuan regional. Untuk mengetahui informasi pemecahan masalah, lihat Error ketidakcocokan region saat mengonfigurasi Model Armor di Agent Gateway. - Batasan lokasi kebijakan organisasi: jika organisasi Anda
memiliki persyaratan khusus untuk lokasi geografis
resource, kebijakan organisasi Anda mungkin menyertakan
batasan lokasi resource
(
constraints/gcp.resourceLocations). Agent Registry menerapkan batasan tersebut saat Anda membuat resourceService,Binding,Skill, atauSkillRevisionregional. Kepatuhan kebijakan organisasi tidak diterapkan secara retroaktif, sehingga penerapan batasan lokasi resource tidak memengaruhi resource Agent Registry yang ada atau update pada resource tersebut. Untuk mengetahui informasi selengkapnya, lihat Layanan yang mendukung pembatasan lokasi resource.
Global
Anda dapat mendaftarkan dan menemukan resource tanpa batasan geografis tertentu menggunakan lokasi global.
Semua resource di Agent Registry didukung di lokasi global.
Multi-region
Tabel berikut mencantumkan multi-region tempat Agent Registry tersedia.
| Deskripsi region | Nama region |
|---|---|
| Amerika Serikat | us |
| Eropa | eu |
Amerika
Tabel berikut mencantumkan region di Amerika tempat Agent Registry tersedia.
| Deskripsi region | Nama region |
|---|---|
| Iowa | us-central1 |
| Carolina Selatan | us-east1 |
| Northern Virginia | us-east4 |
| Columbus | us-east5 |
| Dallas | us-south1 |
| Oregon | us-west1 |
| Los Angeles | us-west2 |
| Montréal | northamerica-northeast1 |
| Toronto | northamerica-northeast2 |
| Meksiko | northamerica-south1 |
| Sao Paulo | southamerica-east1 |
| Santiago | southamerica-west1 |
Asia Pasifik
Tabel berikut mencantumkan region di Asia Pasifik tempat Agent Registry tersedia.
| Deskripsi region | Nama region |
|---|---|
| Taiwan | asia-east1 |
| Hong Kong | asia-east2 |
| Tokyo | asia-northeast1 |
| Osaka | asia-northeast2 |
| Seoul | asia-northeast3 |
| Mumbai | asia-south1 |
| Delhi | asia-south2 |
| Singapura | asia-southeast1 |
| Jakarta | asia-southeast2 |
| Kuala Lumpur | asia-southeast3 |
| Sydney | australia-southeast1 |
| Melbourne | australia-southeast2 |
Eropa
Tabel berikut mencantumkan region di Eropa tempat Agent Registry tersedia.
| Deskripsi region | Nama region |
|---|---|
| Warsawa | europe-central2 |
| Finlandia | europe-north1 |
| Swedia | europe-north2 |
| Madrid | europe-southwest1 |
| Belgia | europe-west1 |
| London | europe-west2 |
| Frankfurt | europe-west3 |
| Belanda | europe-west4 |
| Zurich | europe-west6 |
| Milan | europe-west8 |
| Paris | europe-west9 |
| Berlin | europe-west10 |
| Turin | europe-west12 |
Timur Tengah
Tabel berikut mencantumkan region di Timur Tengah tempat Agent Registry tersedia.
| Deskripsi region | Nama region |
|---|---|
| Doha | me-central1 |
| Dammam | me-central2 |
| Tel Aviv | me-west1 |
Afrika
Tabel berikut mencantumkan region di Afrika tempat Agent Registry tersedia.
| Deskripsi region | Nama region |
|---|---|
| Johannesburg | africa-south1 |