Lokasi Agent Registry

Agent Registry memungkinkan Anda mendaftarkan dan menemukan komponen agen di region Google Cloud tertentu atau di lokasi global untuk memenuhi persyaratan latensi, ketersediaan, dan residensi data Anda. Memilih cakupan lokasi regional atau global yang sesuai akan menentukan penemuan komponen dan perutean 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 McpServer di lokasi global, bukan di region individual seperti us-central1. Jika layanan menyediakan endpoint regional (REP), seperti https://SERVICE.REGION.rep.googleapis.com/mcp, Agent Registry mencantumkan URL regional tersebut di kolom interfaces dari satu resource global McpServer tersebut:
    • Gunakan global untuk server yang terdaftar secara otomatis: tentukan lokasi global saat Anda mengkueri server di Agent Registry dengan --location=global atau menerapkan kebijakan Identity-Aware Proxy (IAP) ke server tersebut dengan --region=global. Jika Anda menentukan region seperti us-central1, perintah akan menampilkan error NOT_FOUND karena tidak ada resource McpServer regional 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.
  • 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 MCP global. Filter pencarian registry gateway mengkueri resource regional dan global.
  • Binding kebijakan egress: menerapkan binding otorisasi egress IAP di lokasi yang sama dengan tempat resource target didaftarkan di Agent Registry:
    • Untuk server MCP jarak jauh Google Cloud dan Google yang terdaftar secara otomatis, terapkan binding di global dengan --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.
  • Lokasi pendaftaran: Anda harus mendaftarkan agen, server MCP, dan endpoint secara manual, serta membuat binding, di wilayah yang didukung atau lokasi global. Untuk mengetahui detail tentang dukungan multi-region, lihat Multi-region.
  • 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 global serta 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 resource Service, Binding, Skill, atau SkillRevision regional. 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

Di multi-region yang didukung, Anda dapat menemukan agen dan server MCP yang terdaftar secara otomatis dari Gemini Enterprise dan mendaftarkan atau menemukan kemampuan mandiri.

Pendaftaran manual agen, server MCP, atau endpoint, dan pembuatan binding, hanya didukung di lokasi regional atau lokasi global. Operasi tersebut tidak didukung di lokasi multi-region. Untuk mengetahui informasi pemecahan masalah, lihat Pendaftaran manual atau pembuatan binding gagal di lokasi 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