Agent Gateway는 Gemini Enterprise Agent Platform 거버넌스를 Cloud Run에서 빌드하고 배포하는 AI 에이전트로 확장합니다. Secure Web Proxy가 지원하는 자체 관리형 Agent Gateway를 통해 Cloud Run 서비스의 아웃바운드 요청을 라우팅하면 에이전트 애플리케이션 코드를 변경하지 않고도 통합 액세스 정책을 시행하고, 콘텐츠 안전을 위해 프롬프트와 도구 페이로드를 검사하고, 로그와 trace를 캡처할 수 있습니다.
전체 단계별 설정 안내는 Cloud Run 문서의 Agent Gateway로 에이전트 관리를 참조하세요.
이점
Cloud Run과 함께 Agent Gateway를 사용하면 에이전트 워크로드에 다음과 같은 기능이 제공됩니다.
- 각 서비스의 암호화 에이전트 ID를 기반으로 모델 컨텍스트 프로토콜(MCP) 서버, 도구, 외부 엔드포인트에 대한 아웃바운드 호출에 최소 권한 액세스 규칙을 적용합니다.
- Service Extensions 확장 프로그램 바인딩을 통해 Model Armor 템플릿을 연결하여 프롬프트 인젝션, 탈옥, 민감한 데이터 유출에 대해 프롬프트와 응답을 스캔합니다.
- 에이전트 프레임워크에 커스텀 프록시 로직을 빌드하지 않고도 Cloud Run 앰비언트 네트워킹 및 Direct VPC 이그레스를 사용하여 아웃바운드 컨테이너 트래픽을 라우팅합니다.
- Cloud Run 서비스와 동일한 Google Cloud 프로젝트에서 게이트웨이를 호스팅하거나 공유 VPC를 사용하여 여러 서비스 프로젝트에서 중앙 게이트웨이를 공유합니다.
- Cloud Logging 및 Cloud Trace에서 정책 결정, MCP 도구 호출, 요청 지연 시간을 모니터링합니다.
주요 구성요소
Cloud Run의 자체 관리형 Agent Gateway 배포는 다음 구성요소를 결합합니다.
- Cloud Run 앰비언트 네트워킹: 에이전트 컨테이너와 함께 Google 관리 Envoy 사이드카를 실행하여 아웃바운드 연결을 가로채고 mTLS를 통해 전달합니다.
- Secure Web Proxy: Virtual Private Cloud(VPC) 네트워크 내에서 아웃바운드 정책 시행 지점으로 실행되어 TLS 검사를 수행하고 승인 규칙 및 확장 프로그램 바인딩을 평가합니다.
- 에이전트 ID 및 Agent Registry: Cloud Run 에이전트에 워크로드 바인딩 SPIFFE ID를 할당하고 조직의 중앙 인벤토리에 에이전트, MCP 서버, 도구를 등록합니다.
- IAP(Identity-Aware Proxy) 및 Identity and Access Management(IAM) 통합 액세스 정책: 특정 Cloud Run 에이전트 ID가 대상 MCP 서버, 도구 또는 엔드포인트를 호출할 수 있는 권한이 있는지 평가합니다.
- 확장 프로그램 바인딩: IAP 및 Model Armor를 Agent Gateway 리소스에 바인딩하여 아웃바운드 요청 및 응답을 평가합니다.
작동 방식
--ambient-networking, --vpc-egress=all, --functional-type=agent, --identity-type=agent-identity를 사용하여 Cloud Run 서비스를 배포하면 Cloud Run은 주변 Envoy 사이드카를 프로비저닝하고 서비스에 에이전트 ID 주 구성원을 할당합니다.
Cloud Run 서비스의 아웃바운드 트래픽을 자체 관리형 Agent Gateway 리소스와 연결된 Secure Web Proxy 인스턴스로 전달하는 Network Services API EgressRouting 정책을 만듭니다. 앰비언트 사이드카는 에이전트의 ID를 Secure Web Proxy로 전달하는 mTLS CONNECT 터널을 통해 VPC 직접 연결 이그레스를 통해 아웃바운드 연결을 전송합니다.
Secure Web Proxy는 Certificate Authority Service 또는 비공개 PKI의 인증 기관을 사용하여 아웃바운드 TLS 세션을 종료하고, MCP 메서드 및 모델 엔드포인트에 대한 ALLOW 승인 정책을 평가하고, 승인된 요청을 대상으로 전달하기 전에 확장 프로그램 바인딩을 통해 IAP 및 Model Armor를 호출합니다.
지원되는 리전
다음 리전의 Cloud Run에서 Agent Gateway를 사용할 수 있습니다.
europe-west1us-central1
다음 단계
- Agent Gateway로 에이전트 제어에서 단일 프로젝트 또는 공유 VPC 배포에 대한 아웃바운드 거버넌스를 설정합니다.
- Agent Gateway 문제 해결에서 라우팅, xDS 권한, TLS 검사, 정책 오류를 진단합니다.
- Cloud Run용 Agent Platform 기능 구성에서 에이전트 아이덴티티 및 자동 등록에 대해 알아보세요.
- Secure Web Proxy를 Agent Gateway로 배포에서 기본 프록시 리소스를 구성합니다.
- Agent Gateway 트래픽 모니터링에서 런타임 전반의 원격 분석을 확인합니다.