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

Agent Registry는 AI 생태계를 표준화된 리소스로 구성하므로 단일 프로젝트 또는 관리 경계에서 에이전트, MCP 서버, 엔드포인트, 기술을 등록, 탐색, 제어할 수 있습니다. 에이전트 레지스트리가 쓰기 가능한 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 참고 문서를 참조하세요.

프로젝트 간 데이터 모델

관리 경계를 구성하면 Agent Registry가 관리 프로젝트에서 모든 구성원 프로젝트의 탐색 및 거버넌스를 중앙 집중화합니다.

관리 프로젝트에서 리소스를 쿼리, 나열 또는 검색할 때 Agent Registry는 다음 범위 지정 규칙을 적용하여 리소스를 중복하거나 엔드포인트 충돌을 일으키지 않고 통합 카탈로그를 제공합니다.

리소스 카테고리 관리 경계의 범위 설명
자동 검색된 리소스 구성원 프로젝트에서 집계됨 멤버 프로젝트에서 자동으로 검색된 에이전트와 MCP 서버는 관리 프로젝트의 위치에서 나열하거나 검색할 때 관리 프로젝트 뷰로 집계됩니다. 에이전트 또는 MCP 서버를 보거나 나열하거나 검색할 때 요청에 관리 프로젝트 ID 또는 구성원 프로젝트 ID를 지정할 수 있습니다. 리소스 이름은 에이전트 레지스트리가 구성요소에 할당하는 ID를 보존하고 요청에 지정된 프로젝트를 사용합니다.
수동으로 등록된 리소스 생성된 프로젝트로 범위 지정 커스텀 에이전트, 외부 MCP 서버, Service 리소스로 수동 등록된 엔드포인트는 생성된 프로젝트로 범위가 지정됩니다. 관리 경계 전반에 표시되도록 관리 프로젝트에서 만들거나 단일 프로젝트 내에서만 표시되도록 구성원 프로젝트에서 만듭니다.
결합 생성된 프로젝트로 범위 지정 Binding 리소스는 생성된 프로젝트로 범위가 지정됩니다. 경계 전체 공개 상태를 위해 관리 프로젝트에서 만들거나 단일 프로젝트 공개 상태를 위해 구성원 프로젝트에서 만듭니다.
독립형 기술 및 게시자 생성된 프로젝트로 범위 지정 커스텀 독립형 Skill, SkillRevision, Publisher 리소스는 생성된 프로젝트로 범위가 지정되며 구성원 프로젝트에서 관리 프로젝트로 집계되지 않습니다. Google 관리형 독립형 기술은 에이전트 레지스트리를 설정할 때 모든 프로젝트에서 자동으로 검색할 수 있습니다.
특정 AI 응용 분야가 생성된 프로젝트로 범위 지정 읽기 전용 AiApplication 리소스 및 연결된 구성요소 뷰는 애플리케이션이 생성된 프로젝트 및 위치로 범위가 지정됩니다.

지원되는 제품 및 구성요소

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

자동 등록

에이전트 레지스트리는 프로젝트 내 또는 관리 경계의 구성원 프로젝트 전반에 배포된 지원되는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 조직에서 작성한 자체 독립형 스킬

다음 단계