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