이 문서에서는 Agent Registry와 관련된 주요 용어와 개념을 설명합니다.
A2A 스킬
스킬과 비교하세요.
에이전트의
에이전트 카드
(agent-card.json) 내에 인라인으로 표시되는 선언적 기능 메타데이터 블록입니다. A2A 스킬은 에이전트 간 통신 인터페이스
와 A2A 호환 에이전트가 보유한 고급 기능을 설명합니다.
Agent Registry는 Agent2Agent (A2A) 사양의 버전 0.3 및 1.0을 지원합니다.
에이전트
AI 생태계의 자율적 행위자로, 식별자와 보유한 특정 A2A 스킬 또는 스킬로 정의됩니다.
에이전트 식별자
에이전트의 전역적으로 고유하고 변경할 수 없는 이름입니다. 이 논리적 식별자는 소비자가 에이전트를 호출할 수 있는 안정적인 참조를 제공하며 기본 인프라 변경과 관계없이 일정하게 유지됩니다.
에이전트 식별자는 수집 중에 Agent Registry에서 자동으로 생성되며 URN (Uniform Resource Name) 형식을 따릅니다. 정확한 형식은 에이전트가 배포되는 위치에 따라 다릅니다. 예시는 다음과 같습니다.
- Gemini Enterprise Agent Platform의 에이전트 런타임:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:reasoningEngines:AGENT_ID - Cloud Run 서비스:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:run:services:SERVICE_NAME - GKE 배포:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:containers:CLUSTER_NAME:namespace:NAMESPACE:deployment:DEPLOYMENT_NAME - Gemini Enterprise:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:discoveryengine:INSTANCE_ID:root - Google Workspace:
urn:agent:googleapis.com:locations:global:workspaceagent:workspaceagent--a2a - 수동으로 등록된 에이전트:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:AGENT_ID
에이전트 주 구성원
에이전트에 할당된 고유한 Identity and Access Management (IAM) 식별자로, 에이전트가 권한을 보유하고 감사를 받을 수 있도록 합니다. 에이전트 또는 서버에 바인딩된 확인 가능한 Google Cloud 서비스 계정 또는 관리형 워크로드 아이덴티티(예: SPIFFE ID)의 형식을 취합니다.
이 아이덴티티는 에이전트 런타임의 컴퓨팅 리소스에 직접 바인딩되므로 주 구성원 문자열에는 기본 리소스의 정확한 경로가 포함됩니다. 예를 들어 Gemini Enterprise Agent Platform 배포의 에이전트 런타임에 대한 에이전트 주 구성원은 다음과 같습니다.
principal://agents.global.org-ORGANIZATION_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/REGION/reasoningEngines/REASONING_ENGINE_ID
Agent Registry는 에이전트의 세부정보를 볼 때 이 아이덴티티를 출력 전용 속성으로 표시합니다.
에이전트형 구성요소
Agent Registry에서 등록, 검색, 관리할 수 있는 AI 생태계 내의 모듈식 기능 항목입니다. 레지스트리는 에이전트형 구성요소를 에이전트, MCP 서버, 엔드포인트, 스킬의 네 가지 기본 유형으로 분류합니다.
에이전트형 워크플로
AI 에이전트가 작업을 완료하기 위해 도구 사용, 추론, 실행 경로를 독립적으로 결정하는 단계의 시퀀스입니다.
인증 제공업체
에이전트를 특정 외부 도구 및 애플리케이션에 연결하고 인증 유형을 정의하기 위해 API 키 또는 OAuth 토큰과 같은 사용자 인증 정보를 저장, 획득, 관리하는 Agent Identity 인증 관리자 내의 구성입니다.
바인딩
소스 에이전트와 대상 리소스(예: 다른 에이전트, MCP 서버 또는 엔드포인트) 간의 연결입니다. 바인딩을 만들면 오케스트레이터 에이전트가 다운스트림 기능과 상호작용할 수 있는 명시적 관계를 설정할 수 있습니다. 바인딩은 위임된 권한을 지원하기 위해 에이전트를 인증 제공업체와 연결하는 데도 사용됩니다.
데이터 리소스
에이전트가 응답을 근거로 삼거나 작업을 알리기 위해 액세스할 수 있는 MCP 서버에서 노출되는 특정 데이터 컨텍스트 또는 데이터세트입니다.
탐색
설명, 태그 또는 스킬을 기반으로 기존 에이전트, MCP 도구 또는 엔드포인트를 찾기 위해 레지스트리를 쿼리하는 프로세스입니다.
Agent Registry의 탐색은 AI 오케스트레이터가 사용할 수 있는 소비 중심 기능에 중점을 둡니다. 이미 등록된 기능을 검색하여 AI 시스템을 빌드하고 오케스트레이션합니다.
Agent Registry의 이 프로세스는 Google Cloud 프로젝트에서 등록되지 않은 컴퓨팅 리소스를 식별하는 App Hub와 같은 인프라 탐색과 다릅니다.
엔드포인트
Agent Registry API의 경우 에이전트가 액세스하는 대상 URL(일반적으로 REST API)을 나타내는 리소스입니다. Agent Registry를 사용하면 이러한 대상을 관리 가능한 리소스로 추상화하여 에이전트가 액세스할 수 있는 외부 서비스를 중앙에서 관리할 수 있습니다.
모델 컨텍스트 프로토콜 (MCP)
AI 모델을 데이터 소스 및 도구에 연결하는 데 사용되는 개방형 표준으로, 맞춤형 플러그인을 대체합니다.
MCP 서버 (또는 서버)
AI 에이전트에 표준화된 도구 및 데이터 리소스를 제공하기 위해 모델 컨텍스트 프로토콜 (MCP) 을 구현하는 서비스입니다.
MCP 서버 식별자
MCP 서버의 전역적으로 고유하고 변경할 수 없는 URN (Uniform Resource Name)입니다. 에이전트 식별자와 마찬가지로 이 이름은 특정 도구 모음을 검색하기 위한 안정적인 참조를 제공합니다.
형식은 기본 제공 Google 서비스인지 등록된 외부 서버인지에 따라 다릅니다. 예시는 다음과 같습니다.
- Google Cloud 원격 MCP 서버:
urn:mcp:googleapis.com:projects:PROJECT_NUMBER:locations:global:SERVER_NAME - 수동으로 등록된 MCP 서버:
urn:mcp:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:SERVER_ID
등록
에이전트, MCP 서버 또는 엔드포인트와 같은 에이전트형 구성요소를 레지스트리에 추가하는 프로세스입니다. Agent Registry는 다음과 같은 등록 메커니즘을 제공합니다.
- 자동 등록: Agent Runtime과 같은 지원되는 Google Cloud AI 리소스의 자동 수집입니다. 자동 등록은 단일 프로젝트의 범위 내에서 작동합니다.
- 수동 등록: 중앙 집중식 검색 및 관리를 위해 여러 Google Cloud 프로젝트에 배포된 커스텀 또는 외부 에이전트형 구성요소 또는 에이전트의 수동 온보딩입니다.
리소스 URI
에이전트 또는 MCP 서버를 호스팅하는 실제 런타임 위치 또는 인프라입니다. URI (Uniform Resource Identifier)는 이 런타임 리소스를 식별하는 고유한 문자 시퀀스입니다. 예를 들어 리소스 URI는 Agent Runtime 엔드포인트, Google Kubernetes Engine (GKE) 배포 또는 Cloud Run 서비스일 수 있습니다.
리소스 URI는 에이전트 식별자 또는 MCP 서버 식별자와 다릅니다. 이러한 값은 레지스트리에서 에이전트와 MCP 서버를 식별하는 URN 형식의 고유한 이름입니다. 반면 리소스 URI는 에이전트 또는 서버가 실행되는 실제 컴퓨팅 리소스를 가리킵니다.
에이전트의 리소스 URI 경로는 IAM 정책에서 해당 리소스를 고유하게 식별하기 위해 에이전트 주 구성원 문자열 내에 삽입됩니다. 교차 프로젝트 등록의 경우 리소스 URI는 컴퓨팅 리소스가 있는 프로젝트를 참조합니다.
Agent Registry는 에이전트의 세부정보를 볼 때 이 URI를 출력 전용 속성으로 표시합니다.
리소스 URI를 사용하여 토폴로지
그래프에서 쿼리를 빌드하여
특정 에이전트의 트래픽 흐름과 관계를 시각화할 수 있습니다. Agent Registry API에서 이 값은 agentregistry.googleapis.com/system/RuntimeReference 속성으로 표시됩니다.
서비스
Agent Registry API의 경우 커스텀 또는
외부 에이전트형 구성요소를 레지스트리에 수동으로 등록하는 데 사용되는 쓰기 가능한 리소스입니다. Service는 레지스트리에 수동으로 추가된 에이전트, MCP 서버 또는 엔드포인트를 나타냅니다. Service 리소스를 만들고 관리하여 Agent Registry에서 자동으로 수집하지 않는 에이전트형 구성요소의 엔드포인트와 메타데이터를 정의합니다.
제공하는 사양에 따라 Agent Registry는 이 Service를 검색을 위한 읽기 전용 Agent, McpServer 또는 Endpoint 리소스로 소비자 측에 자동으로 프로젝션합니다.
항상 Service 리소스를 사용하여 레지스트리 항목을 만들거나 수정하거나 삭제합니다. 하지만 이러한 항목을 가져오거나 나열하거나 검색하려면 읽기 전용 Agent, McpServer 또는 Endpoint 리소스를 쿼리합니다.
스킬
A2A 스킬과 비교하세요.
작업을 완료하기 위한 특정 안내, 자연어 또는 코드를 제공하여 agent의 기능을 확장하는
Agent Registry에 최상위 리소스로 등록된 독립형 실행 가능한 패키지입니다.
스킬에는 안내 파일 (SKILL.md), 런타임 실행 스크립트, 메타데이터 애셋이 포함됩니다.
스킬은 URN (Uniform Resource Name)으로 식별됩니다. 정확한 형식 은 게시자에 따라 다릅니다. 예시는 다음과 같습니다.
- Google에서 만든 스킬:
urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID. 예를 들어urn:skill:discoveryengine.googleapis.com:discoveryengine:report-writing입니다. - 수동으로 등록된 스킬:
urn:skill:projects-PROJECT_NUMBER:locations:LOCATION:private-SKILL_ID. 예를 들어urn:skill:projects-123456789:locations:global:private-create-docs입니다.
Agent Registry를 설정하면 Google에서 만든 스킬이 즉시 표시됩니다. 하지만 자체 스킬을 등록할 수도 있습니다. Agent Registry에서 에이전트 및 MCP 서버의 형제 리소스로 스킬을 등록합니다. 각 스킬에는 기본 버전이 있으며 버전이 지정된 여러 스킬 버전이 포함될 수 있습니다.
플랫폼 관리자는 수명 주기 상태를 관리하고 런타임 해결을 위한 기본 버전 포인터를 설정하여 스킬을 관리합니다.
스킬 버전
변경할 수 없는 버전이 지정된 스킬 패키지의 스냅샷입니다. 버전을 사용하면 상위 스킬의 식별자를 변경하지 않고도 스킬 안내 또는 코드를 업데이트할 수 있습니다.
스킬 버전을 관리하여 스킬의 버전 관리를 허용할 수 있습니다.
게시자
Agent Registry에서 스킬을 만들고 등록하는 항목입니다.
미리 채워진 게시자에는 cloud.google.com 및 discoveryengine.googleapis.com과 같은 Google 게시자와 확인된 파트너가 포함됩니다. Agent Registry를 설정하면 이러한 게시자의 Google에서 만든 스킬이 즉시 표시됩니다.
만든 스킬은 기본 private
게시자에게 자동으로 할당되므로 특정 스킬의 게시된 ID에는
private-가 접두사로 붙습니다. 커스텀 게시자 리소스는 등록할 수 없습니다.
등록된 스킬의 게시자 세부정보를 검토하고 검사합니다.
도구
에이전트가 호출할 수 있는 MCP 서버에서 제공하는 결정적 함수입니다.