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

Agent Registry는 AI 생태계를 표준화된 리소스로 구성하여 에이전트, MCP 서버, 엔드포인트, 기술을 등록, 탐색, 제어할 수 있도록 합니다. Agent Registry가 쓰기 가능한 Service 리소스를 읽기 전용 검색 리소스와 분리하는 방법과 자동 및 수동 등록을 지원하는 제품을 이해하면 레지스트리를 설계하고 관리하는 데 도움이 됩니다.

에이전트 구성요소

Agent Registry를 사용하면 다음과 같은 유형의 에이전트 구성요소를 등록, 검색, 제어할 수 있습니다.

  • 에이전트: 특정 작업을 수행하고, 도구를 호출하고, 다른 에이전트와 공동작업하는 자율 AI 행위자입니다.
  • MCP 서버: 모델 컨텍스트 프로토콜 (MCP)을 구현하여 표준화된 데이터 리소스와 도구를 노출하는 프로그램입니다. 도구는 MCP 서버에서 노출하는 결정론적 함수로, 에이전트가 특정 작업을 수행하기 위해 호출할 수 있습니다.
  • 엔드포인트: 에이전트가 액세스하는 대상 URL(일반적으로 REST API)입니다. Agent Registry는 이러한 대상을 관리 가능한 리소스로 추상화하여 에이전트가 액세스할 수 있는 외부 API를 중앙에서 제어할 수 있게 해줍니다.
  • 기술: 에이전트가 할 수 있는 작업을 확장하는 모듈식 기능입니다. 독립형 기술은 레지스트리에서 직접 관리되는 안내 및 선택적 스크립트의 패키지입니다. A2A 기술은 에이전트의 에이전트 카드에 있는 기능 설명으로, 다른 에이전트에게 언제 어떻게 통신해야 하는지 알려줍니다. 자세한 내용은 기술 아키텍처를 참조하세요.

서비스 리소스 및 검색 리소스

에이전트 레지스트리가 구성요소를 나타내는 방식은 구성요소 유형과 등록 모델에 따라 다릅니다. 구성요소 수명 주기 및 검색에 관한 자세한 내용은 구성요소 수명 주기 및 검색을 참고하세요.

에이전트, MCP 서버, 엔드포인트

에이전트, MCP 서버 또는 엔드포인트가 자동으로 등록되든 수동으로 등록되든 관계없이 Agent Registry는 이를 읽기 전용 Agent, McpServer 또는 Endpoint 검색 리소스로 나타냅니다. 조정자 에이전트, 클라이언트 애플리케이션, 개발자와 같은 소비자는 이러한 검색 리소스를 사용하여 등록된 구성요소를 나열, 검색, 확인합니다.

자동으로 등록된 구성요소의 경우 Agent Registry는 지원되는 런타임에서 직접 메타데이터를 수집하고 Service 리소스 없이 탐색 리소스를 만듭니다.

에이전트, MCP 서버 또는 엔드포인트를 수동으로 등록하면 Agent Registry는 다음 항목을 만들어 구성요소 검색에서 관리 작업을 분리합니다.

  • 쓰기 가능한 Service 리소스: 에이전트 구성요소 유형, 인터페이스 URL, 설명, 프로토콜 바인딩, 기능 사양을 포함한 구성요소의 메타데이터를 저장합니다. 기본 배포를 수정하거나 삭제하지 않고 메타데이터 업데이트 또는 구성요소 등록 취소와 같은 관리 작업을 위해 Service 리소스를 만들거나 업데이트하거나 삭제합니다.
  • 탐색 리소스: Service 리소스를 만들거나 업데이트하면 에이전트 레지스트리가 메타데이터를 읽고 레지스트리의 구성요소를 나타내는 Agent, McpServer 또는 Endpoint 탐색 리소스를 자동으로 만들거나 업데이트합니다.

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

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

이러한 플래그 쌍은 상호 배타적입니다. 둘 이상의 쌍에서 플래그를 지정하면 오류가 반환됩니다. 잘못된 구성요소 유형에 플래그 쌍을 지정하면 Agent Registry는 지정한 플래그와 일치하는 컬렉션에 검색 리소스를 만듭니다. 예를 들어 엔드포인트를 등록할 때 --agent-spec-type=no-spec를 전달하면 Endpoint 리소스 대신 Agent 리소스가 생성되므로 유형별 쿼리 및 거버넌스 정책이 예상대로 적용되지 않습니다.

독립형 스킬

독립형 기술은 별도의 Service 리소스를 사용하지 않습니다. 대신 최상위 Skill 리소스, 하위 SkillRevision 리소스, Publisher 리소스를 사용하여 직접 기술을 등록, 버전 관리, 쿼리합니다.

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

지원되는 제품 및 구성요소

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

자동 등록

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

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

구성요소 유형 지원되는 제품
에이전트
MCP 서버
Skills Google 관리 스킬은 모든 프로젝트에서 검색할 수 있습니다.

수동 등록

거버넌스 프로젝트 외부의 별도 Google Cloud 프로젝트, 온프레미스 인프라 또는 외부 클라우드에 호스팅된 에이전트, MCP 서버 또는 엔드포인트인 원격 구성요소의 경우 Service 리소스를 사용하여 거버넌스 프로젝트에 구성요소를 수동으로 등록합니다. 또한 Service 리소스를 사용하여 A2A 프로토콜을 구현하지 않는 지원되지 않는 런타임 또는 에이전트에 구성요소를 수동으로 등록합니다. 커스텀 독립형 기술의 경우 Skill 리소스를 사용합니다.

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

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

다음 단계