에이전트를 등록하면 검색 가능한 서비스가 됩니다. 에이전트의 기술을 게시하면 조직의 다른 개발자와 오케스트레이터 에이전트가 내 작업을 찾아 재사용하여 전체 AI 개발을 가속화할 수 있습니다.
에이전트 런타임에 따라 에이전트 레지스트리에서는 자동 등록과 수동 등록이라는 두 가지 기본 등록 메커니즘을 지원합니다.
이 문서는 에이전트 런타임에 적합한 등록 메커니즘을 선택하는 데 도움이 됩니다.
자동 등록
지원되는 Google Cloud 런타임은 기본적으로 또는 선택적 배포 단계를 통해 에이전트를 에이전트 레지스트리에 등록합니다.
자동 등록은 다음 Google Cloud 런타임에서 지원됩니다.
- Vertex AI Agent Engine: SDK를 사용하여 배포된 에이전트는 추가 구성 없이 등록됩니다.
- 기본 제공 Google 에이전트: Google Workspace 및 Gemini Enterprise 에이전트와 같이 Google에서 직접 제공하는 에이전트는 구성 없이 검색할 수 있습니다.
- Google Kubernetes Engine: GKE에 배포된 컨테이너화된 에이전트는 특정 에이전트 레지스트리 기능 유형 주석을 포함하는 경우 등록됩니다.
등록 중에 캡처된 에이전트의 메타데이터와 기술은 에이전트의 프로토콜에 따라 달라집니다.
- Agent2Agent (A2A) 프로토콜을 구현하는 에이전트: A2A는 에이전트가 기능과 ID를 선언할 수 있는 개방형 표준입니다. 에이전트가 이 프로토콜을 구현하면 에이전트 등록처에서 에이전트 카드에서 에이전트의 기술을 자동으로 추출하여 등록처에 입력합니다.
- A2A 프로토콜을 구현하지 않는 에이전트: Agent Registry는 에이전트를 등록하지만 추론 URL 및 기술과 같은 메타데이터를 자동으로 캡처할 수 없습니다. 에이전트가 검색될 수 있도록 이 정보를 제공하려면 수동 등록을 사용하세요.
자동 등록을 지원하는 런타임에 관한 자세한 내용은 자동 등록 사용을 참고하세요. Google Cloud
수동 등록
외부 플랫폼, 온프레미스 또는 자동 검색을 지원하지 않는 Google Cloud런타임에서 호스팅되는 에이전트의 경우 수동 등록을 사용해야 합니다.
에이전트를 수동으로 등록하려면 에이전트의 엔드포인트와 구성을 정의하는 Service 리소스를 생성하는 에이전트 레지스트리 API를 사용합니다. 이 쓰기 가능한 리소스에는 에이전트의 구체적인 세부정보도 포함되어 있습니다. Service가 생성되면 레지스트리에서 검색에 사용할 수 있는 읽기 전용 Agent 리소스를 생성합니다.
다음 두 가지 유형의 에이전트를 수동으로 등록할 수 있습니다.
- A2A 호환 에이전트: Agent2Agent (A2A) 사양(
A2A_AGENT_CARD)을 구현하는 에이전트입니다. 레지스트리에서 에이전트 카드(agent-card.json) 엔드포인트를 검색하여 기술을 색인합니다. - 표준 REST 에이전트: 표준 REST API 엔드포인트와 같이 A2A 사양 (
NO_SPEC)을 구현하지 않는 원격 에이전트입니다.
에이전트를 수동으로 등록하는 방법을 알아보려면 수동 등록 사용을 참고하세요.