에이전트 레지스트리 위치

에이전트 레지스트리를 사용하면 특정 Google Cloud 리전 또는 global 위치에서 에이전트 구성요소를 등록하고 검색하여 지연 시간, 가용성, 데이터 레지던시 요구사항을 충족할 수 있습니다. 적절한 리전 또는 전역 위치를 선택하면 거버넌스 프로젝트 및 워크로드 전반에서 구성요소 검색 및 게이트웨이 라우팅의 범위가 지정됩니다. 리전과 영역에 대한 자세한 내용은 위치 및 리전을 참조하세요.

리전 및 전역 위치 전반의 거버넌스 범위

Agent Registry, Agent Gateway, Identity and Access Management (IAM) 전반에서 에이전트 아키텍처를 배포하고 관리할 때는 다음 위치 및 범위 지정 규칙을 고려하세요.

  • Google 및 Google Cloud 원격 MCP 서버: 에이전트 레지스트리가 사용 설정된 API에 대해 Google 또는 Google Cloud 원격 MCP 서버를 자동으로 등록하면 McpServer 리소스가 us-central1과 같은 개별 리전이 아닌 global 위치에만 생성됩니다. 서비스에서 https://SERVICE.REGION.rep.googleapis.com/mcp와 같은 리전 엔드포인트 (REP)를 제공하는 경우 Agent Registry는 단일 global McpServer 리소스의 interfaces 필드에 해당 리전 URL을 나열합니다.
    • 자동으로 등록된 서버에 global 사용: --location=global를 사용하여 에이전트 레지스트리에서 서버를 쿼리하거나 --region=global를 사용하여 Identity-Aware Proxy (IAP) 정책을 적용할 때 global 위치를 지정합니다. us-central1과 같은 리전을 지정하면 기본적으로 리전 McpServer 리소스가 없으므로 명령어가 NOT_FOUND 오류를 반환합니다.
    • 데이터 레지던시를 위해 리전에 등록: 특정 리전에 레지스트리 메타데이터를 보관해야 하는 경우 커스텀 MCP 서버를 리전 Cloud Run 또는 Google Kubernetes Engine (GKE) 런타임에 배포하거나 해당 리전에 MCP 서버와 리전 엔드포인트 URL을 수동으로 등록한 후 동일한 리전에 IAP 정책을 적용합니다. Agent Gateway가 대상 URL을 확인할 때 리전 레지스트리 항목이 global 항목보다 우선 적용됩니다. 문제 해결 정보는 리전 위치에서 원격 MCP 서버를 찾을 수 없음을 참조하세요.
  • 전역 MCP 서버를 제어하는 리전 게이트웨이: us-central1와 같은 리전 위치에 배포된 Agent Gateway는 global MCP 서버로 트래픽을 제어하고 라우팅할 수 있습니다. 게이트웨이 레지스트리 조회 필터는 리전 및 global 리소스를 모두 쿼리합니다.
  • 이그레스 정책 바인딩: 대상 리소스가 Agent Registry에 등록된 동일한 위치에 IAP 이그레스 승인 바인딩을 적용합니다.
    • 자동으로 등록된 Google 및 Google Cloud 원격 MCP 서버의 경우 호출 에이전트가 리전 게이트웨이를 통해 트래픽을 전송하는 경우에도 --region=global를 사용하여 global에 바인딩을 적용합니다.
    • 특정 리전에 등록된 리소스의 경우 해당 리전에 바인딩을 적용합니다. 문제 해결 정보는 IAP 정책을 관리할 때 리소스 항목을 찾을 수 없음 오류를 참조하세요.
  • 등록 위치: 지원되는 지역 위치 또는 global 위치에서 에이전트, MCP 서버, 엔드포인트를 수동으로 등록하고 바인딩을 만들어야 합니다. 멀티 리전 지원에 대한 자세한 내용은 멀티 리전을 참조하세요.
  • 정책 시행을 위한 리전 조정: Agent Gateway에서 Model Armor 정책 필터를 구성하는 경우 게이트웨이, Model Armor 템플릿, 승인 확장 프로그램 및 정책이 동일한 리전에 있어야 합니다. Model Armor는 리전 게이트웨이에서 요청 및 응답 페이로드를 검사하므로 게이트웨이는 global 위치에 등록된 MCP 서버와 리전 대상에 라우팅된 트래픽을 계속 검사하고 제어할 수 있습니다. 문제 해결 정보는 Agent Gateway에서 Model Armor를 구성할 때 리전 불일치 오류를 참조하세요.
  • 조직 정책 위치 제한: 조직에 리소스의 지리적 위치에 대한 특정 요구사항이 있는 경우 조직 정책에 리소스 위치 제약 조건(constraints/gcp.resourceLocations)이 포함될 수 있습니다. Agent Registry는 리전 Service, Binding, Skill 또는 SkillRevision 리소스를 만들 때 이러한 제약 조건을 적용합니다. 조직 정책 준수는 소급해서 시행되지 않으므로 리소스 위치 제약 조건을 적용해도 기존 Agent Registry 리소스나 해당 리소스에 대한 업데이트는 영향을 받지 않습니다. 자세한 내용은 리소스 위치 제한을 지원하는 서비스를 참조하세요.

전역

global 위치를 사용하여 특정 지리적 제한 없이 리소스를 등록하고 검색할 수 있습니다.

에이전트 레지스트리의 모든 리소스는 global 위치에서 지원됩니다.

멀티 리전

지원되는 멀티 리전에서는 Gemini Enterprise에서 자동으로 등록된 에이전트와 MCP 서버를 검색하고 독립형 스킬을 등록하거나 검색할 수 있습니다.

에이전트, MCP 서버 또는 엔드포인트의 수동 등록과 바인딩 생성은 리전 위치 또는 global 위치에서만 지원됩니다. 이러한 작업은 멀티 리전 위치에서 지원되지 않습니다. 문제 해결 정보는 멀티 리전 위치에서 수동 등록 또는 바인딩 생성 실패를 참조하세요.

다음 표에는 Agent Registry를 사용할 수 있는 멀티 리전이 나와 있습니다.

리전 설명 리전 이름
미국 us
유럽 eu

미주

다음 표에는 Agent Registry를 사용할 수 있는 미주 리전이 나와 있습니다.

리전 설명 리전 이름
아이오와 us-central1
사우스캐롤라이나 us-east1
북버지니아 us-east4
콜럼버스 us-east5
댈러스 us-south1
오리건 us-west1
로스앤젤레스 us-west2
몬트리올 northamerica-northeast1
토론토 northamerica-northeast2
멕시코 northamerica-south1
상파울루 southamerica-east1
산티아고 southamerica-west1

아시아 태평양

다음 표에는 Agent Registry를 사용할 수 있는 아시아 태평양의 리전이 나와 있습니다.

리전 설명 리전 이름
타이완 asia-east1
홍콩 asia-east2
도쿄 asia-northeast1
오사카 asia-northeast2
서울 asia-northeast3
뭄바이 asia-south1
델리 asia-south2
싱가포르 asia-southeast1
자카르타 asia-southeast2
쿠알라룸푸르 asia-southeast3
시드니 australia-southeast1
멜버른 australia-southeast2

유럽

다음 표에는 Agent Registry를 사용할 수 있는 유럽 내 리전이 나와 있습니다.

리전 설명 리전 이름
바르샤바 europe-central2
핀란드 europe-north1
스웨덴 europe-north2
마드리드 europe-southwest1
벨기에 europe-west1
런던 europe-west2
프랑크푸르트 europe-west3
네덜란드 europe-west4
취리히 europe-west6
밀라노 europe-west8
파리 europe-west9
베를린 europe-west10
토리노 europe-west12

중동

다음 표에는 Agent Registry를 사용할 수 있는 중동 내 리전이 나와 있습니다.

리전 설명 리전 이름
도하 me-central1
Dammam me-central2
텔아비브 me-west1

아프리카

다음 표에는 Agent Registry를 사용할 수 있는 아프리카 내 리전이 나와 있습니다.

리전 설명 리전 이름
요하네스버그 africa-south1