이 문서에서는 Agent Registry와 관련된 주요 용어와 개념을 설명합니다.
에이전트
식별자와 보유한 특정 기능으로 정의되는 AI 생태계의 자율적 행위자입니다.
에이전트 식별자
에이전트의 전역적으로 고유한 변경 불가능한 이름입니다. 이 논리적 식별자는 기본 인프라 변경과 관계없이 소비자가 에이전트를 호출할 수 있는 안정적인 참조를 제공합니다.
에이전트 식별자는 수집 중에 Agent Registry에서 자동으로 생성되며 균일한 리소스 이름 (URN) 형식을 따릅니다. 정확한 형식은 에이전트가 배포되는 위치에 따라 다릅니다. 예시는 다음과 같습니다.
- 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 서비스 계정 또는 관리형 워크로드 ID(예: SPIFFE ID)의 형식을 취합니다.
이 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는 에이전트의 세부정보를 볼 때 이 ID를 출력 전용 속성으로 표시합니다.
에이전트형 구성요소
Agent Registry를 통해 등록, 탐색, 관리할 수 있는 AI 생태계 내의 모듈식 기능 엔티티입니다. 레지스트리는 에이전트형 구성요소 를 세 가지 기본 유형( 에이전트, MCP 서버, 엔드포인트)으로 분류합니다.
에이전트형 워크플로
AI 에이전트가 작업을 수행하기 위해 도구 사용, 추론, 실행 경로를 독립적으로 결정하는 단계의 시퀀스입니다.
인증 제공업체
에이전트를 특정 외부 도구 및 애플리케이션에 연결하고 인증 유형을 정의하기 위해 API 키 또는 OAuth 토큰과 같은 사용자 인증 정보를 저장, 획득, 관리하는 Agent Identity 인증 관리자 의 구성입니다.
바인딩
소스 에이전트와 대상 리소스(예: 다른 에이전트, MCP 서버 또는 엔드포인트) 간의 연결입니다. 바인딩을 만들면 오케스트레이터 에이전트가 다운스트림 기능과 상호작용할 수 있는 명시적 관계를 설정합니다. 바인딩은 위임된 권한을 지원하기 위해 에이전트를 인증 제공업체와 연결하는 데도 사용됩니다.
데이터 리소스
에이전트가 응답을 근거로 삼거나 작업을 알리기 위해 액세스할 수 있는 MCP 서버에서 노출되는 특정 데이터 컨텍스트 또는 데이터세트입니다.
탐색
설명, 태그 또는 기능을 기반으로 기존 에이전트, MCP 도구 또는 엔드포인트를 찾기 위해 레지스트리를 쿼리하는 프로세스입니다.
Agent Registry의 탐색은 AI 오케스트레이터가 사용할 수 있는 소비 중심 기능에 중점을 둡니다. 이미 등록된 기능을 탐색하여 AI 시스템을 빌드하고 오케스트레이션합니다.
Agent Registry의 이 프로세스는 프로젝트에서 등록되지 않은 컴퓨팅 리소스를 식별하는 App Hub와 같은 인프라 탐색과 다릅니다. Google Cloud
엔드포인트
Agent Registry API의 경우 에이전트가 액세스하는 대상 URL(일반적으로 REST API)을 나타내는 리소스입니다. Agent Registry를 사용하면 이러한 대상을 관리 가능한 리소스로 추상화하여 에이전트가 액세스할 수 있는 외부 서비스를 중앙에서 관리할 수 있습니다.
모델 컨텍스트 프로토콜 (MCP)
AI 모델을 데이터 소스 및 도구에 연결하는 데 사용되는 개방형 표준으로, 맞춤형 플러그인을 대체합니다.
MCP 서버 (또는 서버)
AI 에이전트에 표준화된 도구 및 데이터 리소스를 제공하기 위해 모델 컨텍스트 프로토콜 (MCP) 을 구현하는 서비스입니다.
MCP 서버 식별자
MCP 서버의 전역적으로 고유한 변경 불가능한 균일한 리소스 이름 (URN)입니다. 에이전트 식별자와 마찬가지로 이 이름은 특정 도구 모음을 탐색하기 위한 안정적인 참조를 제공합니다.
형식은 기본 제공 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 리소스의 자동 수집입니다.
- 수동 등록: 맞춤 또는 외부 에이전트형 구성요소의 수동 온보딩입니다.
리소스 URI
에이전트 또는 MCP 서버를 호스팅하는 실제 런타임 위치 또는 인프라입니다. 균일한 리소스 식별자 (URI)는 이 런타임 리소스를 식별하는 고유한 문자 시퀀스입니다. 예를 들어 리소스 URI는 Agent Runtime 엔드포인트, Google Kubernetes Engine (GKE) 배포 또는 Cloud Run 서비스일 수 있습니다.
리소스 URI는 에이전트 식별자 또는 MCP 서버 식별자와 다릅니다. 이러한 값은 레지스트리에서 에이전트와 MCP 서버를 식별하는 URN 형식의 고유한 이름입니다. 반대로 리소스 URI는 에이전트 또는 서버가 실행되는 실제 컴퓨팅 리소스를 가리킵니다.
에이전트의 리소스 URI 경로는 에이전트 보안 주체 문자열 내에 삽입되어 IAM 정책에서 해당 리소스를 고유하게 식별합니다.
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 리소스를 쿼리합니다.
스킬
에이전트가 보유한 고급 기능입니다. 기능은 Agent2Agent (A2A) 에이전트 카드에서 추출되며 에이전트 탐색의 기본 데이터 포인트 역할을 합니다.
Agent Registry는 A2A 사양 버전 0.3 및 1.0을 지원합니다.
도구
에이전트가 호출할 수 있는 MCP 서버에서 제공하는 결정적 함수입니다.