Agent Registry에서 A2A 에이전트 가져오기

Gemini Enterprise 관리자는 에이전트 레지스트리에서 Gemini Enterprise 앱에 A2A 에이전트를 추가할 수 있습니다.

Agent Gateway를 통해 트래픽에 액세스 제어 정책을 적용할 수 있습니다. 이러한 정책을 사용하면 이그레스 거버넌스를 적용하여 에이전트로의 트래픽을 제어할 수 있습니다.

A2A 에이전트 및 Agent Registry 정보

Agent2Agent (A2A) 프로토콜은 에이전트를 위한 개방형 통신 프로토콜이자 범용 언어입니다. 이 프로토콜을 사용하면 서로 다른 빌더와 플랫폼의 에이전트가 서로를 검색하고, 공동작업하고, 작업을 안전하게 위임할 수 있습니다.

Agent Registry는 A2A 에이전트, 엔드포인트, MCP 서버를 검색, 추적, 관리하기 위한 단일 정보 소스 역할을 하는 중앙 집중식 쿼리 가능 카탈로그입니다.

레지스트리의 A2A 에이전트는 사용자와 동료가 빌드하고 Gemini Enterprise Agent Platform의 Agent Runtime, Cloud Run, Google Kubernetes Engine (GKE)과 같은 다양한 런타임에 배포한 커스텀 에이전트일 수 있습니다. 이러한 에이전트는 Google Workspace와 같은 Google 제품에 내장된 에이전트일 수도 있습니다.

에이전트 레지스트리의 에이전트를 Gemini Enterprise 앱과 연결하여 앱의 최종 사용자가 사용할 수 있도록 할 수 있습니다.

Agent Gateway 정보

Agent Gateway는 A2A 에이전트, MCP 서버, 엔드포인트의 트래픽 컨트롤러 및 런타임 정책 시행 지점 역할을 하는 Agent Platform의 관리형 리전 네트워킹 구성요소입니다. 클라이언트와 A2A 에이전트, A2A 에이전트와 백엔드 도구, A2A 에이전트와 다른 에이전트 간의 연결을 보호하고 관리합니다.

A2A 에이전트를 Gemini Enterprise 앱과 연결하려면 먼저 에이전트 트래픽을 라우팅할 수 있는 Agent Gateway를 설정해야 합니다. 아래의 시작하기 전에를 참고하세요.

레지스트리, 게이트웨이, 앱의 리전 제약조건

데이터 레지던시 요구사항을 준수하기 위해 Agent Registry 및 Agent Gateway 리소스는 모두 프로젝트 및 리전별로 다릅니다.

Agent Gateway는 Gemini Enterprise 앱의 운영 리전과 호환되는 리전에 있는 Agent Registry와 연결되도록 구성되어야 합니다. 이렇게 하면 데이터 레지던시 규칙 위반을 방지할 수 있습니다. 예를 들어 미국 리전에서 만든 Gemini Enterprise 앱은 전역 Agent Registry가 아닌 미국 리전 Agent Gateway로 구성된 Agent Gateway를 사용해야 합니다.

Gemini Enterprise 앱의 경우 특정 바인딩 프로세스를 통해 리전 정렬이 엄격하게 적용됩니다.

  • Gemini Enterprise 앱은 해당 앱에 허용된 리전 중 하나에 있는 Agent Gateway에만 바인딩되어야 합니다.

  • 선택한 Agent Gateway는 에이전트 레지스트리와 연결되어야 합니다. 이 Agent Registry는 Agent Gateway 및 앱과 동일한 특정 리전에 있어야 합니다.

  • 즉, 세 가지 구성요소 (앱, 게이트웨이, 레지스트리)가 리전별로 정렬되어야 합니다. 아래 표에는 구체적인 리전 매핑이 나와 있습니다.

Gemini Enterprise 앱 위치 Agent Gateway 위치 에이전트 레지스트리 위치
global us-central1 us-central1
us us-central1 us-central1
eu europe-west1 europe-west1

제한사항

에이전트 레지스트리에서 에이전트를 가져올 때는 다음 제한사항이 적용됩니다.

  • 레지스트리가 Gemini Enterprise 앱에 설정된 Agent Gateway와 연결된 경우에만 Agent Registry에서 에이전트를 탐색하고 가져올 수 있습니다.

  • 거버넌스 정책은 Agent Gateway와 연결된 단일 레지스트리 내에 있는 에이전트에만 적용할 수 있습니다.

  • Gemini Enterprise 에이전트 간 또는 Gemini Enterprise 에이전트와 Gemini Enterprise 데이터 커넥터 (커스텀 MCP 서버와 같은 MCP 기반 커넥터 포함) 간의 직접 통신은 Agent Gateway 정책 시행을 트리거하지 않습니다.

시작하기 전에

시작하기 전에 다음 기본 요건을 완료했는지 확인하세요.

Agent Registry에서 Gemini Enterprise 앱으로 에이전트 가져오기

에이전트 레지스트리에서 Gemini Enterprise 앱으로 A2A 에이전트를 가져오면 앱의 최종 사용자가 에이전트를 사용할 수 있습니다.

콘솔

에이전트 레지스트리에서 Gemini Enterprise 앱으로 에이전트를 가져오려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서 Gemini Enterprise 페이지로 이동합니다.

    Gemini Enterprise

  2. A2A 에이전트를 연결할 앱의 이름을 클릭합니다.

  3. 에이전트를 클릭합니다.

  4. + 에이전트 추가를 클릭하고 Agent Runtime을 통한 커스텀 에이전트의 추가를 클릭합니다.

  5. 추가할 에이전트를 찾아 에이전트 추가를 클릭합니다.

  6. 에이전트 세부정보를 검토하고 다음을 클릭합니다.

  7. 다음 중 하나를 수행합니다.

    • 에이전트가 공개적으로 사용 가능하거나 런타임에 대한 권한이 이미 있는 경우 건너뛰기 및 완료를 클릭합니다.

    • 그렇지 않으면 제공업체 사용자 인증 정보 및 추가 세부정보를 검토하거나 입력하고 완료를 클릭합니다.

      필드 설명
      클라이언트 ID Gemini Enterprise를 나타내기 위해 ID 공급업체에 등록한 OAuth 애플리케이션의 고유 식별자입니다.
      클라이언트 보안 비밀번호 Gemini Enterprise를 나타내기 위해 ID 공급업체에 등록한 OAuth 애플리케이션과 연결된 기밀 키입니다.
      승인 URL 사용자가 Gemini Enterprise에 에이전트 액세스 권한을 부여하는 데 사용하는 URL입니다. 예를 들면 https://accounts.google.com/o/oauth2/v2/auth?client_id=123...abc.apps.googleusercontent&redirect_uri=https%3A%2F%2Fvertexaisearch.cloud.google.com%2Foauth-redirect&oauth-redirect&include_granted_scopes=true&response_type=code&access_type=offline&prompt=consent입니다.
      토큰 URL 승인 코드를 액세스 토큰으로 교환하는 데 사용되는 엔드포인트입니다. 예를 들어 에이전트가 Google에서 호스팅되는 경우 토큰 URL은 https://oauth2.googleapis.com/token입니다.
      범위 Gemini Enterprise가 사용자를 대신하여 수행할 수 있는 작업 또는 액세스할 수 있는 데이터를 정의하는 권한입니다. Gemini Enterprise는 사용자 승인 중에 이러한 범위를 요청합니다. 예를 들면 https://www.googleapis.com/auth/cloud-platform입니다.

      범위를 지정할 때는 다음 사항을 고려하세요.
      • 공백으로 구분된 범위 목록을 제공합니다. 예를 들면 read write입니다.
      • 사용자가 로그인하고 에이전트를 사용할 수 있도록 범위가 충분한지 확인합니다.
      PKCE 인증 사용 설정됨 에이전트에 Proof Key for Code Exchange가 필요한 경우 이 옵션을 선택합니다.

  8. 앱의 최종 사용자가 에이전트를 사용할 수 있도록 하려면 다음을 수행합니다.

    1. 에이전트의 사용자 권한 탭으로 이동합니다. 앱 > APP_NAME > 에이전트 > AGENT_NAME > 사용자 권한

    2. 사용자 추가를 클릭합니다.

    3. 에이전트에 사용자 권한 역할 추가 대화상자에서 사용자, 그룹 또는 모든 사용자에게 에이전트 사용자 역할을 할당합니다.

이그레스 거버넌스 정책 설정 및 적용

Agent Gateway를 사용하면 시맨틱 및 IAM 제어 정책을 평가하고 이그레스 에이전트 트래픽에 적용할 수 있습니다. 세분화된 이그레스 정책을 만들어 A2A 에이전트의 에이전트 간 액세스를 관리할 수 있습니다.

에이전트 레지스트리 내의 특정 항목에 대한 에이전트의 액세스를 제한하는 허용 및 거부 규칙을 정의합니다.

이그레스 거버넌스 규칙을 만들어 에이전트에 적용하려면 다음 중 하나를 수행합니다.

다음 단계