이 문서에서는 에이전트 레지스트리와 관련된 주요 용어와 개념을 설명합니다.
에이전트
AI 생태계의 자율 행위자로, 식별자와 보유한 특정 기술로 정의됩니다.
에이전트 식별자
에이전트의 전역적으로 고유하고 변경 불가능한 이름입니다. 이 논리적 식별자는 소비자가 에이전트를 호출할 수 있는 안정적인 참조를 제공하며, 기본 인프라 변경과 관계없이 일정하게 유지됩니다.
에이전트 식별자는 수집 중에 에이전트 레지스트리에 의해 자동으로 생성되며 Uniform Resource Name (URN) 형식을 따릅니다. 정확한 형식은 에이전트가 배포된 위치에 따라 다릅니다. 예시는 다음과 같습니다.
- Vertex AI Agent Engine:
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:SERVICE_ID
상담사 주 구성원
에이전트에 할당된 고유 IAM 식별자로, 권한을 보유하고 감사를 받을 수 있습니다. 확인 가능한 Google Cloud서비스 계정 또는 관리형 워크로드 아이덴티티(예: 에이전트 또는 서버에 바인딩된 SPIFFE ID)의 형태를 취합니다.
이 ID는 에이전트 런타임의 컴퓨팅 리소스에 직접 바인딩되므로 주 구성원 문자열에는 기본 리소스의 정확한 경로가 포함됩니다. 예를 들어 Vertex AI Agent Engine 배포의 에이전트 주 구성원은 다음과 같습니다.
principal://agents.global.org-ORGANIZATION_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/REGION/reasoningEngines/REASONING_ENGINE_ID
에이전트 레지스트리는 에이전트의 세부정보를 볼 때 이 ID를 출력 전용 속성으로 표시합니다.
에이전트형 워크플로
AI 에이전트가 작업을 완료하기 위해 도구 사용, 추론, 실행 경로를 독립적으로 결정하는 일련의 단계입니다.
인증 제공업체
에이전트 ID 인증 관리자 내의 구성으로, 에이전트를 특정 외부 도구 및 애플리케이션에 연결하고 인증 유형을 정의하기 위한 API 키 또는 OAuth 토큰과 같은 사용자 인증 정보를 저장, 획득, 관리합니다.
Binding
소스 에이전트와 대상 리소스(예: 다른 에이전트, MCP 서버, 엔드포인트) 간의 연결입니다. 바인딩을 만들면 오케스트레이터 에이전트가 다운스트림 기능과 상호작용할 수 있는 명시적 관계가 설정됩니다. 바인딩은 위임된 권한을 지원하기 위해 에이전트를 인증 제공업체와 연결하는 데도 사용됩니다.
데이터 리소스
에이전트가 대답을 뒷받침하거나 작업을 알리기 위해 액세스할 수 있는 MCP 서버에 의해 노출되는 특정 데이터 컨텍스트 또는 데이터 세트입니다.
탐색
설명, 태그 또는 기술을 기반으로 기존 에이전트 또는 MCP 도구를 찾기 위해 레지스트리를 쿼리하는 프로세스입니다. 기술별 검색은 Agent2Agent (A2A) 프로토콜을 구현하는 에이전트와 같이 에이전트 카드를 통해 기능을 노출하는 에이전트에서 사용할 수 있습니다.
엔드포인트
Agent Registry API의 경우 에이전트가 액세스하는 대상 URL(일반적으로 REST API)을 나타내는 리소스입니다. 이러한 대상을 관리 가능한 리소스로 추상화함으로써 에이전트 레지스트리를 사용하면 에이전트가 액세스할 수 있는 외부 서비스를 중앙에서 관리할 수 있습니다.
모델 컨텍스트 프로토콜(MCP)
AI 모델을 데이터 소스 및 도구에 연결하는 데 사용되는 개방형 표준으로, 맞춤 플러그인을 대체합니다.
MCP 서버 (또는 서버)
모델 컨텍스트 프로토콜 (MCP)을 구현하여 AI 에이전트에 표준화된 도구와 데이터 리소스를 제공하는 서비스입니다.
MCP 서버 식별자
MCP 서버의 전역적으로 고유하고 변경 불가능한 통합 리소스 이름 (URN)입니다. 에이전트 식별자와 마찬가지로 이 이름은 특정 도구 모음을 검색하기 위한 안정적인 참조를 제공합니다.
형식은 내장 Google 서비스인지 등록된 외부 서버인지에 따라 다릅니다. 예시는 다음과 같습니다.
- Google Cloud 원격 MCP 서버:
urn:mcp:googleapis.com:projects:PROJECT_NUMBER:locations:global:SERVICE_NAME - 수동으로 등록된 MCP 서버:
urn:mcp:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:SERVICE_ID
등록
레지스트리에 서비스를 추가하는 프로세스입니다. 에이전트 레지스트리는 다음과 같은 등록 메커니즘을 제공합니다.
- 자동 등록: 지원되는 Google Cloud워크로드(예: Vertex AI Agent Engine)의 자동 수집
- 수동 등록: 맞춤 또는 외부 워크로드의 수동 온보딩
리소스 URI
에이전트 또는 MCP 서버를 호스팅하는 실제 런타임 위치 또는 인프라입니다. Uniform Resource Identifier (URI)는 이 런타임 리소스를 식별하는 고유한 문자 시퀀스입니다. 예를 들어 리소스 URI는 Vertex AI 엔드포인트, GKE 배포 또는 Cloud Run 서비스일 수 있습니다.
리소스 URI는 에이전트 식별자 또는 MCP 서버 식별자와 다릅니다. 이러한 값은 레지스트리에서 에이전트와 MCP 서버를 식별하는 URN 형식의 고유한 이름입니다. 반면 리소스 URI는 에이전트 또는 서버가 실행되는 실제 컴퓨팅 리소스를 가리킵니다.
에이전트의 리소스 URI 경로는 IAM 정책에서 해당 워크로드를 고유하게 식별하기 위해 에이전트 주 구성원 문자열 내에 삽입됩니다.
에이전트 세부정보를 확인하면 에이전트 레지스트리에 이 URI가 출력 전용 속성으로 표시됩니다.
리소스 URI를 사용하여 토폴로지 그래프에서 쿼리를 빌드하여 특정 에이전트의 트래픽 흐름과 관계를 시각화할 수 있습니다. 에이전트 등록 API에서 이 값은 agentregistry.googleapis.com/system/RuntimeReference 속성으로 표시됩니다.
서비스
에이전트 레지스트리 API의 경우 레지스트리에 맞춤 또는 외부 워크로드를 수동으로 등록하는 데 사용되는 쓰기 가능한 리소스입니다. 서비스는 레지스트리에 수동으로 추가된 에이전트, MCP 서버 또는 엔드포인트를 나타냅니다. Service 리소스를 만들어 에이전트 레지스트리에서 자동으로 수집하지 않는 워크로드의 엔드포인트와 메타데이터를 정의합니다.
제공된 사양에 따라 에이전트 레지스트리는 이 서비스를 검색을 위해 소비자 측에 읽기 전용 Agent, McpServer 또는 Endpoint 리소스로 자동으로 투영합니다.
레지스트리 항목을 생성, 수정 또는 삭제할 때는 항상 Service 리소스를 사용합니다. 하지만 이러한 항목을 가져오거나, 나열하거나, 검색하려면 읽기 전용 Agent, McpServer 또는 Endpoint 리소스를 쿼리합니다.
기술
A2A 에이전트가 보유한 상위 수준 기능입니다. 기술은 A2A 에이전트 카드에서 추출되며 에이전트 검색의 기본 데이터 포인트 역할을 합니다.
도구
에이전트가 호출할 수 있는 MCP 서버에서 제공하는 결정적 함수입니다.