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