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