에이전트 등록

에이전트를 등록하면 에이전트 레지스트리 내에서 검색 가능한 구성요소가 됩니다. 에이전트의 기술을 게시하면 조직의 다른 개발자와 오케스트레이터 에이전트가 작업을 찾고 재사용하여 전반적인 AI 개발을 가속화할 수 있습니다.

에이전트 런타임에 따라 에이전트 레지스트리는 두 가지 기본 등록 메커니즘을 지원합니다. 자동 등록 및 수동 등록.

이 문서는 에이전트 런타임에 적합한 등록 메커니즘을 선택하는 데 도움이 됩니다.

자동 등록

지원되는 Google Cloud 런타임은 기본적으로 또는 선택 배포 단계를 통해 에이전트 레지스트리 에 에이전트를 등록합니다.

자동 등록은 다음 Google Cloud 런타임에서 지원됩니다.

  • Gemini Enterprise Agent Platform의 에이전트 런타임: SDK를 사용하여 배포된 에이전트는 추가 구성 없이 등록됩니다.
  • 기본 제공 Google 에이전트: Google Workspace 및 Gemini Enterprise 에이전트와 같이 Google에서 직접 제공하는 에이전트는 구성 없이 검색할 수 있습니다.
  • Google Kubernetes Engine: Google Kubernetes Engine (GKE)에 배포된 컨테이너화된 에이전트는 특정 에이전트 레지스트리 기능 유형 주석이 포함된 경우 등록됩니다.

등록 중에 캡처된 에이전트의 메타데이터와 기술은 에이전트의 프로토콜에 따라 다릅니다.

자동 등록을 지원하는 런타임에 대한 자세한 내용은 자동 등록 사용을 참조하세요. Google Cloud

수동 등록

외부 플랫폼, 온프레미스 또는 자동 검색을 지원하지 않는 Google Cloud 런타임에서 호스팅되는 에이전트의 경우 수동 등록을 사용해야 합니다.

에이전트를 수동으로 등록하려면 에이전트 레지스트리 API를 사용하여 에이전트의 엔드포인트와 구성을 정의하는 Service 리소스를 만듭니다. 이 쓰기 가능한 리소스에는 에이전트의 세부정보도 포함되어 있습니다. Service가 생성되면 레지스트리는 디스커버리에 사용할 수 있는 읽기 전용 Agent 리소스를 생성합니다.

두 가지 유형의 에이전트를 수동으로 등록할 수 있습니다.

  • A2A 호환 에이전트: Agent2Agent (A2A) 사양(A2A_AGENT_CARD)을 구현하는 에이전트입니다. 레지스트리는 에이전트 카드(agent-card.json) 엔드포인트를 검사하여 기술을 색인 생성합니다.
  • 표준 REST 에이전트: 표준 REST API 엔드포인트와 같이 A2A 사양 (NO_SPEC)을 구현하지 않는 원격 에이전트입니다.

에이전트를 수동으로 등록하는 방법을 알아보려면 수동 등록 사용을 참조하세요.