Agent Platform용 Agent Gateway는 Agent Runtime 및 Gemini Enterprise에 배포된 AI 에이전트에 완전 관리형 트래픽 거버넌스 및 보안 시행을 제공합니다.
이 배포 모델에서는 Google이 모든 게이트웨이 인프라를 호스팅하고 관리하므로 게이트웨이 호스팅 인프라를 관리하지 않고도 액세스 규칙, mTLS 종료, 안전 가드레일을 정의할 수 있습니다.
지원되는 액세스 경로
Agent Platform의 Agent Gateway에서 사용할 수 있는 제어되는 액세스 경로는 Agent Runtime 플랫폼에 따라 다릅니다.
- Agent Runtime: 클라이언트에서 에이전트로 (인그레스) 및 에이전트에서 모든 위치로 (이그레스) 모드를 모두 지원합니다.
- Gemini Enterprise: Agent-to-Anywhere (이그레스) 모드만 지원합니다.
다음 표에는 각 액세스 경로의 Agent Gateway에 지원되는 거버넌스 제어가 요약되어 있습니다.
다음 표에는 관리되는 각 액세스 경로에 대해 각 거버넌스 구성요소가 수행하는 역할이 요약되어 있습니다.
| 거버넌스 레이어 | 클라이언트에서 에이전트로 | 에이전트에서 모든 위치로 |
|---|---|---|
| ID | 클라이언트가 게이트웨이에 전달하는 클라이언트 ID 또는 사용자 인증 정보입니다. | 에이전트에 할당된 워크로드 바인딩 에이전트 ID (SPIFFE ID 또는 WIF 토큰) |
| Agent Registry | 클라이언트에서 에이전트로의 모드에는 적용되지 않습니다. | 아웃바운드 대상 리소스 (도구, MCP 서버, 에이전트)를 등록합니다. |
| 액세스 제어 정책 | ||
| IAM 통합 액세스 정책 | 수신 클라이언트 ID 및 대상 에이전트를 기반으로 게이트웨이에서 평가됩니다. | 에이전트 ID 및 대상을 기반으로 IAP (Identity-Aware Proxy) 및 보안 주체 액세스 경계 (PAB) 정책에 의해 평가됩니다. |
| Model Armor 가드레일 | 프롬프트 인젝션, 탈옥, 유해한 콘텐츠가 있는지 인바운드 클라이언트 프롬프트를 실시간으로 검사합니다. | 발신 도구 페이로드와 에이전트 응답을 검사하여 민감한 정보 유출을 방지합니다. |
| 시맨틱 거버넌스 정책 | 클라이언트 요청에 대한 자연어 제약 조건을 평가합니다. | 외부 도구 작업 및 에이전트 위임에 대한 자연어 제약 조건을 평가합니다. |
Agent Gateway에서 정책을 시행하는 방법
Agent Gateway를 통과하는 트래픽은 트래픽 방향에 따라 특정 정책 평가를 거칩니다. 다음 섹션에서는 Agent Gateway를 통과하는 인바운드 및 아웃바운드 요청의 이벤트 시퀀스를 간략하게 설명합니다.
클라이언트에서 에이전트로의 시행
클라이언트-에이전트 모드 (Agent Runtime에 배포된 에이전트에만 지원됨)에서 Agent Gateway가 관리하는 에이전트에 대한 요청은 다음과 같은 일련의 이벤트를 거칩니다.
- 클라이언트 요청: 클라이언트 (예: CLI, 웹 애플리케이션, 개발자 도구)가 에이전트에 요청을 보냅니다. 요청은 에이전트의 프런트엔드 역할을 하는 클라이언트-에이전트 모드에서 작동하는 Agent Gateway에 의해 가로채기됩니다.
- 요청 검사: Agent Gateway는 게이트웨이에 연결된 승인 정책을 사용하여 요청을 평가합니다.
- Model Armor: 인바운드 사용자 프롬프트를 실시간으로 스캔하여 프롬프트 인젝션 공격, 탈옥, 유해한 콘텐츠를 차단합니다.
- 시맨틱 거버넌스 정책 (Model Armor 대신 구성된 경우): 인바운드 요청에 대해 자연어 제약 조건을 평가합니다.
- 요청 전달: 모든 검사를 통과하면 Agent Gateway가 요청을 Agent Runtime의 대상 목적지로 전달합니다.
에이전트에서 모든 위치로의 시행
Agent Runtime 또는 Gemini Enterprise에서 실행되는 에이전트가 외부 도구, MCP 서버 또는 다른 에이전트에 아웃바운드 호출을 전송하면 요청은 다음 일련의 이벤트를 거칩니다.
- 아웃바운드 요청 및 가로채기: 에이전트 (할당된 에이전트 ID로 식별됨)가 아웃바운드 전화를 전송합니다. 요청은 Agent-to-Anywhere 모드로 작동하는 Agent Gateway에 의해 가로채기됩니다.
- IAM, 보안 주체 액세스 경계, IAP 정책 확인: IAP는 에이전트 ID에 대상에 액세스할 수 있는
iap.resources.egressViaIAP권한을 부여하는 IAM 액세스 정책이 있는지 확인합니다. 에이전트 ID에 적용된 보안 주체 액세스 경계 정책도 평가됩니다. 보안 주체 액세스 경계 정책이 적용되는 에이전트 ID는 해당 정책에 지정된 리소스에만 액세스할 수 있으므로 에이전트가 지정된 액세스 경계로 엄격하게 격리됩니다. - 에이전트 레지스트리 확인: Agent Gateway는 대상 리소스가 에이전트 레지스트리에 등록되어 있는지 확인합니다 (또는 대상이 등록되지 않은 경우 대상 엔드포인트 URL을 확인). 세분화된 리소스별 액세스 정책과 도구 수준 제어를 적용하려면 에이전트 레지스트리에 대상을 등록하는 것이 좋습니다. 대상 위치가 에이전트 레지스트리에 등록되지 않은 경우 대상 URL을 타겟팅하는 명시적인 IAM 액세스 정책이 있어야 합니다. 기본적으로 일치하는 액세스 정책이 없으면 요청이 거부됩니다.
요청 검사: 이전 검사를 통과하면 Agent Gateway는 구성했을 수 있는 다른 안전 가드레일에 따라 요청을 평가합니다.
- Model Armor: 도구 페이로드와 에이전트 응답에서 프롬프트 인젝션 및 민감한 정보 유출을 검사합니다.
- 시맨틱 거버넌스 정책: 도구 호출 및 에이전트 작업에 대한 자연어 제약 조건(NLC)을 평가합니다.
- 커스텀 승인 엔진에 승인 위임: Service Extensions를 사용하여 커스텀 승인 엔진에 승인 결정을 위임할 수 있습니다. 구성된 승인 정책에 따라 이러한 승인 엔진 중 하나 이상이 요청을 허용하거나 거부할 수 있습니다.
요청 전달: 모든 검사를 통과하면 Agent Gateway가 요청을 대상 목적지로 전달합니다.
Agent Platform에 Agent Gateway 배포
Google 관리 런타임에 Agent Gateway를 배포하고 구성하려면 일반 설정 주제에 따라 게이트웨이 인프라와 액세스 정책을 구성한 후 런타임별 가이드를 참고하여 에이전트 워크로드에서 트래픽을 라우팅하세요.
일반 설정 및 정책 구성
- Agent Gateway 설정:
agentGateways리소스를 만들고, 에이전트 ID를 할당하고, Agent Registry에 대상 도구를 등록하고, 액세스 정책을 연결하는 방법을 알아봅니다. - VPC 연결로 Agent Gateway 설정: Agent Gateway가 VPC 네트워크의 리소스로 아웃바운드 트래픽을 전송할 수 있도록 비공개 VPC 연결을 구성하는 방법을 알아봅니다.
- 승인 위임: 승인 정책 및 확장 프로그램을 구성하여 트래픽 결정을 IAP, Model Armor, 시맨틱 거버넌스 정책 또는 커스텀 서비스 확장 프로그램 엔진에 위임하는 방법을 알아봅니다.
런타임별 트래픽 라우팅
- Agent Gateway를 통해 런타임 트래픽 라우팅: Agent Gateway를 통해 인바운드(클라이언트-에이전트) 및 아웃바운드 (에이전트-모든 위치) 트래픽을 라우팅하도록 Agent Runtime 에이전트를 구성하는 방법을 알아봅니다.
- Agent Gateway를 통해 Gemini Enterprise 트래픽 라우팅: 외부 도구 및 API에 연결할 때 Agent Gateway를 통해 트래픽을 라우팅하도록 Gemini Enterprise 앱을 구성하는 방법을 알아봅니다.
제한사항
Agent Platform용 Agent Gateway에는 다음 제한사항이 적용됩니다.
- Gemini Enterprise의 경우 클라이언트-에이전트 모드가 지원되지 않습니다.
- 각 Agent Gateway 인스턴스는 Agent Registry에 등록된 리소스를 최대 5,000개까지 관리할 수 있습니다.
- 선택한 배포 및 기능과 관련된 제한사항을 알아보려면 다음 페이지를 검토하세요.