에이전트 등록

에이전트를 등록하면 Agent Registry 내에서 검색 가능한 구성요소가 됩니다. 에이전트의 A2A 스킬을 게시하면 조직의 다른 개발자와 오케스트레이터 에이전트가 작업을 찾고 재사용하여 전반적인 AI 개발을 가속화할 수 있습니다.

Agent Registry는 Agent2Agent (A2A) 프로토콜 및 사양과 원활하게 통합됩니다. A2A는 에이전트가 기능과 ID를 선언할 수 있는 개방형 표준입니다. Agent Registry는 A2A 사양의 0.3 버전과 1.0 버전을 지원합니다. 자세한 내용은 에이전트 카드 스키마를 참조하세요.

에이전트 런타임에 따라 Agent Registry는 두 가지 기본 등록 메커니즘을 지원합니다. 자동 등록 및 수동 등록.

에이전트 런타임에 맞는 등록 메커니즘을 선택하세요.

자동 등록

지원되는 Google Cloud 런타임은 기본적으로 또는 선택 배포 단계를 통해 동일한 프로젝트 내에서 에이전트를 Agent Registry에 등록합니다. 자동 등록은 프로젝트 수준에서 작동하며 다른 Google Cloud 프로젝트에 배포된 에이전트를 자동으로 검색하지 않습니다.

자동 등록은 다음 Google Cloud 런타임에서 지원됩니다.

  • Gemini Enterprise Agent Platform의 에이전트 런타임: SDK를 사용하여 배포된 에이전트는 추가 구성 없이 등록됩니다. 자세한 내용은 Agent Runtime에서 에이전트 등록을 참조하세요.
  • 기본 제공 Google 에이전트: Google Workspace 및 Gemini Enterprise 에이전트와 같이 Google에서 직접 제공하는 에이전트는 구성 없이 검색할 수 있습니다. 자세한 내용은 기본 제공 Google 에이전트 등록을 참조하세요.
  • Google Kubernetes Engine: Google Kubernetes Engine (GKE)에 배포된 컨테이너화된 에이전트는 AI 에이전트 기능 유형 라벨 및 에이전트 카드 주석으로 구성될 때 등록됩니다. GKE 클러스터 런타임 컨트롤러는 인트로스펙션 스캔을 실행하고 메타데이터를 Agent Registry에 게시합니다. 자세한 내용은 GKE에서 에이전트 등록을 참조하세요.
  • Cloud Run: Cloud Run 서비스 또는 작업에 배포된 컨테이너화된 에이전트는 기능 및 ID 유형 플래그와 함께 배포될 때 등록됩니다. Cloud Run은 에이전트의 이름, URL, 유형 (AGENT)을 Agent Registry에 자동으로 등록합니다. 자세한 내용은 Cloud Run에서 에이전트 등록을 참조하세요.

등록 중에 에이전트에 대해 색인이 생성된 메타데이터 및 기능은 에이전트가 Agent2Agent (A2A) 프로토콜을 구현하는지 여부에 따라 다릅니다.

  • A2A 프로토콜을 구현하는 에이전트: 시스템은 에이전트의 에이전트 카드 (/.well-known/agent-card.json)를 쿼리하여 광고된 A2A 스킬과 기능을 레지스트리 카탈로그로 자동으로 추출합니다.
  • A2A 프로토콜을 구현하지 않는 에이전트 (표준 REST 또는 gRPC 엔드포인트): 시스템은 에이전트의 인터페이스 URL과 전송 바인딩을 등록하지만 시맨틱 기능을 자동으로 추출할 수는 없습니다. 기능을 비 A2A 엔드포인트와 연결하려면 수동 등록을 사용하여 기능을 설명하거나 AI 애플리케이션 내에서 독립형 스킬 및 MCP 서버에 연결하면 됩니다.

자동 등록을 지원하는 Google Cloud 런타임에 대한 자세한 내용은 자동 등록 사용을 참조하세요.

수동 등록

외부 플랫폼, 온프레미스, 자동 검색을 지원하지 않는 Google Cloud 런타임 또는 여러 Google Cloud 프로젝트에 호스팅된 에이전트의 경우 수동 등록을 사용해야 합니다.

에이전트를 수동으로 등록하려면 Agent Registry API, Google Cloud CLI 또는 Terraform을 사용하여 에이전트의 엔드포인트와 구성을 정의하는 Service 리소스를 만듭니다. 이 쓰기 가능한 Service 리소스에는 에이전트의 세부정보도 포함되어 있습니다. Service가 생성되면 레지스트리는 검색에 사용할 수 있는 읽기 전용 Agent 리소스를 생성합니다.

두 가지 유형의 에이전트를 수동으로 등록할 수 있습니다.

  • A2A 호환 에이전트: A2A 사양 (A2A_AGENT_CARD)을 구현하는 에이전트입니다. 레지스트리는 에이전트 카드 (agent-card.json) 엔드포인트를 스캔하여 A2A 스킬의 색인을 생성합니다.
  • 표준 REST 에이전트: 표준 REST API 엔드포인트와 같이 A2A 사양 (NO_SPEC)을 구현하지 않는 원격 에이전트입니다.

에이전트를 수동으로 등록하는 방법을 알아보려면 수동 등록 사용을 참조하세요.

프로젝트 간 등록 고려사항

조직에서 에이전트 게이트웨이가 있는 중앙 집중식 거버넌스 아키텍처를 사용하는 경우 중앙 거버넌스 프로젝트에 Agent-to-Anywhere 이그레스 게이트웨이를 배포하고 여러 스포크 또는 워크로드 프로젝트에 배포된 에이전트를 등록할 수 있습니다.

자동 등록은 로컬 프로젝트의 리소스만 검색하므로 중앙 거버넌스 프로젝트의 레지스트리에 원격 에이전트를 수동으로 등록해야 합니다. 프로젝트 간 등록을 사용하면 중앙 게이트웨이가 에이전트를 찾고 관리할 수 있습니다. 안내는 다른 프로젝트에서 에이전트 등록을 참조하세요.

독립형 스킬 통합

Agent Registry를 사용하면 에이전트의 독립형 스킬을 최상위 리소스로 관리하고 제어할 수 있습니다. 독립형 스킬은 레지스트리에 Skill 리소스로 등록되므로 관리자가 세분화된 액세스 정책을 적용하고 버전 기록을 스킬 버전을 사용하여 관리할 수 있습니다.

Gemini Enterprise에서 에이전트를 빌드하고 관리할 때 이러한 등록된 스킬을 참조하여 에이전트의 기능을 확장할 수 있습니다. 독립형 스킬을 등록하고 관리하는 방법에 대한 자세한 내용은 스킬 등록 및 스킬 관리를 참조하세요.