에이전트 레지스트리는 에코시스템의 에이전트형 구성요소를 환경 내에서 검색할 수 있는 세 가지 주요 유형으로 분류합니다.
- 에이전트: 특정 기술을 보유한 자율 행위자입니다. 기술은 에이전트의 높은 수준의 기능을 나타내며 검색을 위한 기본 메커니즘입니다.
- MCP 서버: 표준화된 데이터 리소스 및 도구 제공업체입니다. 도구는 에이전트가 특정 작업을 수행하기 위해 호출할 수 있는 MCP 서버에서 노출하는 결정적 함수입니다.
- 엔드포인트: 에이전트가 액세스하는 대상 URL(일반적으로 REST API)입니다. 이러한 대상을 관리 가능한 리소스로 추상화하여 에이전트 레지스트리를 사용하면 에이전트가 액세스할 수 있는 외부 API를 중앙에서 관리할 수 있습니다.
에이전트 레지스트리에서 사용하는 이러한 개념 및 기타 개념에 대한 자세한 내용은 주요 개념을 참고하세요.
에이전트 레지스트리 API는 읽기 및 쓰기 작업을 구분합니다. 에이전트 레지스트리에서
Service는 레지스트리에 수동으로 추가하는 에이전트, MCP 서버 또는 엔드포인트를 나타내는 쓰기 가능한 API 리소스입니다. 에이전트 레지스트리는 지원되는 Google Cloud 런타임에 배포된 에이전트
와 서버도 자동으로 등록합니다.
Agent Registry API API를 사용 설정하여 에이전트, MCP 서버, 엔드포인트를 등록하고 관리합니다. 쓰기 가능한 Service 리소스를 사용하여 레지스트리의 항목을 수동으로 만들고, 업데이트하고, 삭제할 수 있습니다. 그런 다음 읽기 전용 Agent, McpServer 또는 Endpoint 리소스를 쿼리하여 등록된 에이전트, 서버, 엔드포인트를 각각 가져오고, 나열하고, 검색합니다.
시작하려면 에이전트 레지스트리 설정을 참고하세요.
레지스트리에 에이전트 구성요소 등록
에이전트 레지스트리는 자동 및 수동의 두 가지 등록 메커니즘을 통해 에이전트 및 MCP 서버 카탈로그를 유지합니다. Service 리소스를 사용하여 항목을 수동으로 만들고, 업데이트하고, 삭제합니다.
| 등록 메커니즘 | 설명 | 등록된 구성요소 | 지원되는 Google Cloud 제품 |
|---|---|---|---|
| 자동 등록 | 에이전트 레지스트리를 구성하고 사용하여 지원되는 Google Cloud 런타임에 배포된 특정 리소스를 자동으로 검색하고 수집할 수 있습니다. 개방형 Agent2Agent (A2A) 프로토콜을 구현하는 에이전트의 경우 레지스트리는 에이전트 카드에서 기능과 역량도 자동으로 추출합니다. | 에이전트 | |
| MCP 서버 | 공식 Google 및 Google Cloud 원격 MCP 서버 | ||
| 수동 등록 |
지원되지 않는
런타임의 외부 리소스, 커스텀 에이전트 구성요소 또는 A2A
프로토콜을 구현하지 않는 표준 REST 에이전트의 경우 레지스트리에서 Service 리소스를 만들어 수동으로 등록해야 합니다.
|
에이전트 | 원격 에이전트 |
| MCP 서버 | 지원되지 않는 런타임의 커스텀 에이전트 구성요소 또는 외부 MCP 서버 |
다음 단계
- 주요 개념을 검토하여 에이전트 레지스트리에서 사용되는 필수 용어를 숙지합니다.
- 에이전트 레지스트리를 설정합니다.
- 에이전트의 자동 등록과 수동 등록의 차이점에 대해 알아봅니다.