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