에이전트 레지스트리 데이터 모델

Agent Registry는 생태계의 에이전트 구성요소를 관리하고 검색할 수 있는 네 가지 주요 리소스 유형으로 분류합니다.

• 에이전트: 특정 작업을 실행하고, 도구를 호출하고, 다른 에이전트와 협업하는 자율 AI 행위자입니다.
• MCP 서버: 표준화된 데이터 리소스 및 도구 제공자입니다. 도구는 에이전트가 특정 작업을 실행하기 위해 호출할 수 있는 MCP 서버에 의해 노출되는 결정적 함수입니다.
• 엔드포인트: 에이전트가 액세스하는 타겟 URL(일반적으로 REST API)입니다. 이러한 대상을 관리 가능한 리소스로 추상화함으로써 에이전트 레지스트리를 사용하면 에이전트가 액세스할 수 있는 외부 API를 중앙에서 관리할 수 있습니다.
• 기술: 에이전트가 할 수 있는 작업을 확장하는 모듈식 기능입니다. 에이전트 레지스트리는 레지스트리에서 직접 관리되는 명령어 패키지 및 선택적 스크립트인 독립형 기술과 에이전트의 에이전트 카드에 나열된 기능 설명으로, 다른 에이전트에게 에이전트와 통신해야 하는 시기와 방법을 알려주는 A2A 기술을 구분합니다.

Agent Registry에서 사용하는 이러한 개념과 기타 개념에 대한 자세한 내용은 주요 개념을 참고하세요.

API 리소스

에이전트 등록 API는 에이전트, 엔드포인트, MCP 서버의 읽기 및 쓰기 작업을 분리합니다.

• 쓰기 가능한 API 리소스: 레지스트리에서 Service 리소스를 수동으로 만들거나 업데이트하거나 삭제하여 이러한 에이전트 구성요소를 관리합니다.
• 읽기 전용 API 리소스: 이러한 에이전트 구성요소를 쿼리하거나, 나열하거나, 검색하려면 에이전트 레지스트리 API에 읽기 전용 Agent, McpServer 또는 Endpoint 리소스를 요청합니다.

Service를 만들 때 사용하는 사양 플래그에 따라 결과 읽기 전용 리소스 컬렉션이 결정됩니다.

플래그	리소스 수집	사용 사례	유효한 값
--agent-spec-type --agent-spec-content	Agent(agents)	원격 에이전트 (A2A 호환 또는 표준 REST 에이전트)	a2a-agent-card, no-spec
--endpoint-spec-type --endpoint-spec-content	Endpoint(endpoints)	외부 타겟 REST API 또는 서비스 URL	no-spec
--mcp-server-spec-type --mcp-server-spec-content	McpServer(mcp-servers)	외부 모델 컨텍스트 프로토콜 (MCP) 서버	tool-spec

이러한 플래그 쌍은 상호 배타적입니다. 잘못된 플래그를 지정하면 리소스가 잘못된 컬렉션에 생성되어 유형별 정책과 호환되지 않을 수 있습니다.

독립형 스킬은 Service 투영 모델을 사용하지 않습니다. 대신 Skill, SkillRevision, Publisher API 리소스를 사용하여 스킬을 직접 관리하고, 버전 관리하고, 나열합니다.

시작하려면 에이전트 레지스트리 설정을 참고하세요. 에이전트 레지스트리 API에 대한 자세한 내용은 API 참조 문서를 참고하세요.

지원되는 제품 및 구성요소

에이전트 레지스트리는 지원되는 제품과 구성요소를 등록 방식(자동 또는 수동)에 따라 분류합니다.

자동 등록

에이전트 레지스트리는 프로젝트 내에 배포된 지원되는Google Cloud 워크로드를 자동으로 검색하고 수집합니다. 개방형 Agent2Agent (A2A) 프로토콜을 구현하는 에이전트의 경우 레지스트리가 에이전트 카드에서 A2A 기술과 기능을 자동으로 추출합니다. 에이전트 레지스트리를 설정하면 Google에서 만든 독립형 스킬도 전역적으로 검색할 수 있습니다.

다음 표에는 에이전트 레지스트리에서 자동으로 등록하는 제품과 구성요소가 나와 있습니다.

구성요소 유형	지원되는 제품
에이전트	Gemini Enterprise Agent Platform의 에이전트 런타임 Google Workspace Gemini Enterprise 특정 기능 유형 라벨을 포함한 Google Kubernetes Engine (GKE) 배포 특정 기능 유형 플래그로 구성된 Cloud Run 워크로드
MCP 서버	공식 Google 및 Google Cloud 원격 MCP 서버 특정 기능 유형 라벨을 포함한 Google Kubernetes Engine 배포 특정 기능 유형 플래그로 구성된 Cloud Run 서비스
Skills	Google의 공개 기술은 모든 프로젝트에서 전역적으로 검색 가능합니다.

수동 등록

맞춤 워크로드, 외부 Cloud Run 런타임, 온프레미스 인프라 또는 A2A 프로토콜을 구현하지 않는 에이전트의 경우 쓰기 가능한 Service 리소스를 사용하여 구성요소를 수동으로 등록합니다. 맞춤 독립형 스킬의 경우 Skill 리소스를 사용합니다.

다음 표에는 수동으로 등록하는 제품과 구성요소가 나와 있습니다.

구성요소 유형	지원되는 리소스
에이전트	Compute Engine, Google Kubernetes Engine, Cloud Run, 온프레미스 시스템 또는 외부 클라우드에 배포된 원격 에이전트
MCP 서버	지원되지 않는 런타임 또는 외부 MCP 서버의 맞춤 에이전트 구성요소
엔드포인트	엔드포인트로 관리되는 외부 타겟 REST API 또는 서비스 URL
Skills	조직에서 작성한 자체 독립형 스킬

다음 단계

• 주요 개념을 검토하여 Agent Registry에서 사용되는 필수 용어를 숙지하세요.
• ID 및 식별자에 대해 알아봅니다.
• 에이전트 레지스트리 설정
• 자동 등록과 수동 등록의 차이점에 대해 알아보세요.