에이전트를 등록하면 Agent Registry 내에서 검색 가능한 구성요소가 됩니다. 에이전트의 A2A 기술을 게시하면 조직의 다른 개발자와 오케스트레이터 에이전트가 내 작업을 찾아 재사용하여 전반적인 AI 개발을 가속화할 수 있습니다.
Agent Registry는 Agent2Agent (A2A) 프로토콜 및 사양과 원활하게 통합됩니다. A2A는 에이전트가 기능과 ID를 선언할 수 있는 개방형 표준입니다. Agent Registry는 A2A 사양 버전 0.3 및 1.0을 지원합니다. 자세한 내용은 에이전트 카드 스키마를 참고하세요.
Agent Runtime에 따라 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은 에이전트의 이름과 유형 (
AGENT)을 Agent Registry에 자동으로 등록합니다. 자세한 내용은 Cloud Run에서 에이전트 등록을 참고하세요.
등록 중에 에이전트에 대해 색인이 생성된 메타데이터와 기능은 에이전트가 Agent2Agent (A2A) 프로토콜을 구현하는지에 따라 달라집니다.
- A2A 프로토콜을 구현하는 에이전트: 시스템은 에이전트의 에이전트 카드 (
/.well-known/agent-card.json)를 쿼리하여 광고된 A2A 기술과 기능을 레지스트리 카탈로그에 자동으로 추출합니다. - A2A 프로토콜을 구현하지 않는 에이전트 (표준 REST 또는 gRPC 엔드포인트): Agent Registry는 에이전트를 등록하지만 엔드포인트 URL, 에이전트 ID, A2A 기술과 같은 메타데이터를 자동으로 캡처할 수 없습니다. 기능을 A2A가 아닌 에이전트와 연결하려면 수동 등록 또는 기술 등록을 사용하세요.
자동 등록을 지원하는 Google Cloud 런타임에 관한 자세한 내용은 자동 등록 사용을 참고하세요.
수동 등록
외부 플랫폼, 온프레미스, 자동 검색을 지원하지 않는 Google Cloud런타임 또는 여러Google Cloud 프로젝트에 호스팅된 에이전트의 경우 수동 등록을 사용해야 합니다.
에이전트를 수동으로 등록하려면 에이전트의 엔드포인트와 구성을 정의하는 Service 리소스를 만들기 위해 에이전트 등록 API, Google Cloud CLI 또는 Terraform을 사용합니다. 이 쓰기 가능한 Service 리소스에는 에이전트의 세부정보도 포함되어 있습니다. Service이 생성되면 레지스트리에서 검색에 사용할 수 있는 읽기 전용 Agent 리소스를 생성합니다.
다음 두 가지 유형의 에이전트를 수동으로 등록할 수 있습니다.
- A2A 호환 에이전트: A2A 사양(
A2A_AGENT_CARD)을 구현하는 에이전트입니다. 레지스트리에서 에이전트 카드(agent-card.json) 엔드포인트를 검색하여 A2A 기술을 색인합니다. - 표준 REST 에이전트: 표준 REST API 엔드포인트와 같이 A2A 사양 (
NO_SPEC)을 구현하지 않는 원격 에이전트입니다.
에이전트를 수동으로 등록하는 방법을 알아보려면 수동 등록 사용을 참고하세요.
프로젝트 간 등록 고려사항
조직에서 Agent Gateway를 사용하는 중앙 집중식 거버넌스 아키텍처를 사용하는 경우 중앙 거버넌스 프로젝트에 Agent-to-Anywhere 이그레스 게이트웨이를 배포하고 여러 스포크 또는 워크로드 프로젝트에 배포된 에이전트를 등록할 수 있습니다.
자동 등록은 로컬 프로젝트의 리소스만 검색하므로 중앙 거버넌스 프로젝트의 레지스트리에 원격 에이전트를 수동으로 등록해야 합니다. 교차 프로젝트 등록을 사용하면 중앙 게이트웨이에서 에이전트를 찾아 관리할 수 있습니다. 자세한 내용은 다른 프로젝트에서 에이전트 등록을 참고하세요.
독립형 스킬 통합
Agent Registry를 사용하면 에이전트의 독립형 스킬을 최상위 리소스로 관리하고 제어할 수 있습니다.
독립형 스킬은 레지스트리에 Skill 리소스로 등록되므로 관리자는 스킬 수정사항을 사용하여 세분화된 액세스 정책을 적용하고 버전 기록을 관리할 수 있습니다.
Gemini Enterprise에서 에이전트를 빌드하고 관리할 때 등록된 이러한 스킬을 참조하여 에이전트의 기능을 확장할 수 있습니다. 독립형 스킬을 등록하고 관리하는 방법에 대한 자세한 내용은 스킬 등록 및 스킬 관리를 참고하세요.