이 문서에서는 에이전트 레지스트리와 관련된 주요 용어와 개념을 설명합니다.
A2A 스킬
스킬과 비교하기
에이전트의 에이전트 카드(agent-card.json) 내에 인라인으로 나열된 기능 설명입니다. A2A 기술은 다른 에이전트가 작업을 위임할 시기와 방법을 알 수 있도록 에이전트가 실행할 수 있는 작업과 통신 인터페이스를 설명합니다.
에이전트 레지스트리는 Agent2Agent (A2A) 사양의 0.3 및 1.0 버전을 지원합니다.
에이전트
AI 생태계의 자율 행위자로, 식별자와 보유한 특정 A2A 기술 또는 기술로 정의됩니다.
에이전트 식별자
에이전트의 전역적으로 고유하고 변경 불가능한 Uniform Resource Name (URN)입니다. 이 식별자는 소비자가 에이전트를 조회하고 호출할 수 있는 안정적인 참조를 제공하며, 기본 인프라 변경사항이나 코드 업데이트와 관계없이 일정하게 유지됩니다.
지원되는 런타임 전반의 자세한 URN 문법 형식은 에이전트 식별자를 참고하세요.
에이전트 레지스트리는 인벤토리 추적, 레지스트리 검색, 필터링에 에이전트 식별자를 사용합니다. IAM에서 액세스 및 인증을 관리하려면 대신 에이전트 보안 주체를 사용하세요.
에이전트 보안 주체
에이전트에 할당된 고유한 Identity and Access Management (IAM) ID로, 에이전트가 권한을 보유하고, 다운스트림 리소스에 액세스하고, 감사 로그를 생성할 수 있습니다. 확인 가능한 Google Cloud 서비스 계정 또는 관리 워크로드 아이덴티티(예: 에이전트의 컴퓨팅 런타임에 직접 바인딩된 SPIFFE ID)의 형태를 취합니다.
주 구성원 문자열은 런타임 리소스 경로를 통합하고 엔진 인스턴스, 프로젝트 전체 주 구성원 집합, 조직 전체 주 구성원 집합의 세 가지 범위를 지원합니다.
전체 구문 및 액세스 제어 안내는 에이전트 주 구성원을 참고하세요.
에이전트형 구성요소
AI 생태계 내에서 에이전트 레지스트리를 통해 등록, 검색, 관리할 수 있는 모듈식 기능 엔티티입니다. 레지스트리는 에이전트 구성요소를 에이전트, MCP 서버, 엔드포인트, 스킬의 네 가지 기본 유형으로 분류합니다.
Agentic Workflows
AI 에이전트가 작업을 완료하기 위해 도구 사용, 추론, 실행 경로를 독립적으로 결정하는 일련의 단계입니다.
인증 제공업체
에이전트 ID 인증 관리자 내의 구성으로, 에이전트를 특정 외부 도구 및 애플리케이션에 연결하고 인증 유형을 정의하기 위한 API 키 또는 OAuth 토큰과 같은 사용자 인증 정보를 저장, 획득, 관리합니다.
바인딩
소스 에이전트와 대상 리소스(예: 다른 에이전트, MCP 서버, 엔드포인트) 간의 연결입니다. 바인딩을 생성하면 오케스트레이터 에이전트가 다운스트림 기능과 상호작용할 수 있는 명시적 관계가 설정됩니다. 바인딩은 위임된 권한을 지원하기 위해 에이전트를 인증 제공업체와 연결하는 데도 사용됩니다.
데이터 리소스
에이전트가 대답을 그라운딩하거나 작업을 알리기 위해 액세스할 수 있는 MCP 서버에 의해 노출되는 특정 데이터 컨텍스트 또는 데이터 세트입니다.
탐색
설명, 태그 또는 기술을 기반으로 레지스트리를 쿼리하여 기존 에이전트, MCP 도구 또는 엔드포인트를 찾는 프로세스입니다.
에이전트 레지스트리의 검색은 AI 오케스트레이터가 사용할 수 있는 소비 중심 기능에 중점을 둡니다. 이미 등록된 기능을 검색하여 AI 시스템을 빌드하고 오케스트레이션합니다.
Agent Registry의 이 프로세스는 App Hub와 같은 인프라 검색과 다릅니다. 인프라 검색은 Google Cloud 프로젝트에서 등록되지 않은 컴퓨팅 리소스를 식별합니다.
엔드포인트
Agent Registry API의 경우 에이전트가 액세스하는 대상 URL(일반적으로 REST API)을 나타내는 리소스입니다. 이러한 대상을 관리 가능한 리소스로 추상화함으로써 에이전트 레지스트리를 사용하면 에이전트가 액세스할 수 있는 외부 서비스를 중앙에서 관리할 수 있습니다.
엔드포인트 식별자
등록된 엔드포인트의 전역적으로 고유하고 변경 불가능한 Uniform Resource Name (URN)입니다. 에이전트 식별자 및 MCP 서버 식별자와 마찬가지로 이 URN은 타겟 API 대상을 검색하기 위한 안정적인 레지스트리 참조를 제공합니다. 자세한 내용은 엔드포인트 식별자를 참고하세요.
거버넌스 범위
에이전트 레지스트리 리소스가 등록되고 관리되는 지리적 및 아키텍처 경계입니다.
Google 관리형 MCP 서버는 global 위치에만 등록됩니다.
지원되는 리전 위치 또는 global 위치에서 에이전트, MCP 서버, 엔드포인트를 수동으로 등록하고 바인딩을 만들 수 있습니다. 리전 게이트웨이는 리전 리소스와 global MCP 서버로 향하는 트래픽을 관리하고 라우팅할 수 있습니다.
전체 지역 범위 지정 규칙 및 정책 요구사항은 에이전트 등록처 위치를 참고하세요.
모델 컨텍스트 프로토콜(MCP)
AI 모델을 데이터 소스 및 도구에 연결하는 데 사용되는 개방형 표준으로, 맞춤형 플러그인을 대체합니다.
MCP 서버 (또는 서버)
모델 컨텍스트 프로토콜 (MCP)을 구현하여 AI 에이전트에 표준화된 도구와 데이터 리소스를 제공하는 서비스입니다.
MCP 서버 식별자
MCP 서버의 전역적으로 고유하고 변경 불가능한 Uniform Resource Name (URN)입니다. 에이전트 식별자와 마찬가지로 이 URN은 특정 도구 모음을 검색하기 위한 안정적인 참조를 제공합니다.
MCP 서버 식별자는 레지스트리 조회 및 인벤토리 관리에 사용되는 논리적 이름입니다. 자세한 내용은 MCP 서버 식별자를 참고하세요.
등록
레지스트리에 에이전트, MCP 서버, 엔드포인트와 같은 에이전트 구성요소를 추가하는 프로세스입니다. Agent Registry는 다음과 같은 등록 메커니즘을 제공합니다.
- 자동 등록: Agent Runtime과 같은 지원되는Google Cloud AI 리소스의 자동 수집 자동 등록은 단일 프로젝트 범위 내에서 작동합니다.
- 수동 등록: 중앙 집중식 검색 및 거버넌스를 위해 여러 Google Cloud 프로젝트에 배포된 커스텀 또는 외부 에이전트 구성요소 또는 에이전트의 수동 온보딩
런타임 참조
에이전트, MCP 서버 또는 엔드포인트를 호스팅하는 실제 런타임 위치 또는 컴퓨팅 인프라로, 에이전트 레지스트리 API에서 agentregistry.googleapis.com/system/RuntimeReference 속성으로 표시됩니다. 예를 들어 런타임 참조는 Agent Runtime 추론 엔진, GKE 배포 또는 Cloud Run 서비스를 가리킬 수 있습니다.
런타임 참조 경로는 IAM 정책 평가를 위해 에이전트 주 구성원 내에 삽입됩니다. 자세한 내용은 런타임 참조를 참고하세요.
서비스
Agent Registry API의 경우 레지스트리에 맞춤 또는 외부 에이전트 구성요소를 수동으로 등록하는 데 사용되는 쓰기 가능한 리소스입니다. Service는 레지스트리에 수동으로 추가된 에이전트, MCP 서버 또는 엔드포인트를 나타냅니다. Service 리소스를 만들어 에이전트 레지스트리에서 자동으로 수집하지 않는 에이전트 구성요소의 엔드포인트와 메타데이터를 정의합니다.
제공한 사양에 따라 Agent Registry는 이 Service를 검색을 위해 소비자 측에 읽기 전용 Agent, McpServer 또는 Endpoint 리소스로 자동으로 투영합니다.
Service 리소스를 사용하여 레지스트리 항목을 만들거나 수정하거나 삭제합니다. 하지만 이러한 항목을 가져오거나, 나열하거나, 검색하려면 읽기 전용 Agent, McpServer 또는 Endpoint 리소스를 쿼리합니다.
기술
A2A 기술과 비교합니다.
작업을 완료하기 위한 특정 안내와 선택적 스크립트를 제공하여 에이전트의 기능을 확장하는 에이전트 레지스트리에 최상위 리소스로 등록된 독립형 패키지입니다. 스킬에는 명령어 파일 (SKILL.md), 선택적 스크립트, 메타데이터 애셋이 포함됩니다.
스킬은 Uniform Resource Name (URN)으로 식별됩니다. 정확한 형식은 게시자에 따라 다릅니다. 예시는 다음과 같습니다.
- 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입니다.
Google에서 만든 스킬은 Agent Registry를 설정하면 즉시 표시됩니다. 하지만 자체 스킬을 등록할 수도 있습니다. 에이전트 레지스트리에서 에이전트 및 MCP 서버의 형제 리소스로 스킬을 등록합니다. 각 스킬에는 기본 버전이 있으며 버전이 지정된 여러 스킬 버전이 포함될 수 있습니다.
플랫폼 관리자는 런타임 해결을 위해 수명 주기 상태를 관리하고 기본 버전 포인터를 설정하여 스킬을 관리합니다.
스킬 버전
스킬 패키지의 변경 불가능한 버전이 지정된 스냅샷입니다. 수정을 사용하면 상위 스킬의 식별자를 변경하지 않고 스킬 안내나 스크립트를 업데이트할 수 있습니다.
스킬 수정사항을 관리하여 스킬의 버전 제어를 허용할 수 있습니다.
게시자
Agent Registry에서 스킬을 만들고 등록하는 항목입니다.
자동 입력된 게시자에는 cloud.google.com 및 discoveryengine.googleapis.com과 같은 Google 게시자와 인증된 파트너가 포함됩니다. 이러한 게시자의 Google 생성 스킬은 에이전트 레지스트리를 설정할 때 즉시 표시됩니다.
생성한 스킬은 기본 private 게시자에게 자동으로 할당되므로 특정 스킬의 게시된 ID에는 private-이 접두사로 붙습니다. 맞춤 게시자 리소스를 등록할 수 없습니다.
등록된 스킬의 게시자 세부정보를 검토하고 검사합니다.
도구
에이전트가 호출할 수 있는 MCP 서버에서 제공하는 결정적 함수입니다.