에이전트를 등록하면 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를 사용하여 배포된 에이전트는 추가 구성 없이 등록됩니다.
- 기본 제공 Google 에이전트: Google Workspace 및 Gemini Enterprise 에이전트와 같이 Google에서 직접 제공하는 에이전트는 구성 없이 검색할 수 있습니다.
- Google Kubernetes Engine: Google Kubernetes Engine (GKE)에 배포된 컨테이너화된 에이전트는 특정 Agent Registry 기능 유형 라벨을 포함할 때 등록됩니다.
등록 중에 캡처된 에이전트의 메타데이터와 A2A 스킬은 에이전트의 프로토콜에 따라 다릅니다.
- Agent2Agent (A2A) 프로토콜을 구현하는 에이전트: A2A는 에이전트가 기능과 ID를 선언할 수 있는 개방형 표준입니다. 에이전트가 이 프로토콜을 구현하는 경우 Agent Registry는 에이전트 카드에서 에이전트의 A2A 스킬 을 자동으로 추출하고 레지스트리를 채웁니다.
- A2A 프로토콜을 구현하지 않는 에이전트: Agent Registry는 에이전트를 등록하지만 추론 URL 및 A2A 스킬과 같은 메타데이터를 자동으로 캡처할 수 없습니다. 에이전트를 검색할 수 있도록 이 정보를 제공하려면 수동 등록을 사용하세요.
자동 등록을 지원하는 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에서 에이전트를 빌드하고 관리할 때 이러한 등록된 스킬을 참조하여 에이전트의 기능을 확장할 수 있습니다. 독립형 스킬을 등록하고 관리하는 방법에 대한 자세한 내용은 스킬 등록 및 스킬 관리를 참조하세요.