구성요소 수명 주기 및 검색

Agent Registry를 사용하면 모듈식 에이전트 구성요소를 등록, 탐색, 연결할 수 있으므로 개발자와 조정자 에이전트가 조직 전반에서 AI 기능을 찾고 재사용할 수 있습니다. 에이전트 레지스트리가 자동 및 수동 등록 전반에서 구성요소를 나타내는 방식을 이해하면 기능을 검색하고 바인딩 및 인증 제공업체를 사용하여 연결하는 데 도움이 됩니다.

AI 생태계

4가지 유형의 모듈식 에이전트 구성요소를 등록, 탐색, 제어하여 AI 생태계를 통합할 수 있습니다.

  • 에이전트: 계획, 추론, 도구 호출, 다른 에이전트와의 공동작업을 수행하는 자율 AI 행위자입니다.
  • MCP 서버: 모델 컨텍스트 프로토콜 (MCP)을 구현하여 표준화된 도구와 데이터 리소스를 노출하는 프로그램입니다.
  • 엔드포인트: 에이전트가 액세스하는 대상 URL(일반적으로 REST API)입니다.
  • 스킬: 에이전트의 기능을 확장하는 독립형 안내 패키지 및 선택적 스크립트 또는 인라인 A2A 스킬입니다.

Agent Registry의 에이전트 구성요소 표현

에이전트 레지스트리에서 자동 또는 수동 등록을 통해 에이전트 구성요소를 등록할 수 있습니다. Agent Registry가 구성요소를 나타내는 방식은 구성요소 유형과 등록 모델에 따라 다릅니다.

에이전트, MCP 서버, 엔드포인트

에이전트, MCP 서버 또는 엔드포인트가 등록되는 방식과 관계없이 Agent Registry는 이를 표준 리소스 이름이 있는 읽기 전용 Agent, McpServer 또는 Endpoint 검색 리소스로 나타냅니다. 오케스트레이터 에이전트, 클라이언트 애플리케이션, 개발자와 같은 에이전트 구성요소의 소비자는 탐색 리소스를 사용하여 레지스트리에서 사용 가능한 모든 구성요소를 나열, 검색, 확인합니다.

에이전트 레지스트리가 이러한 검색 리소스를 만들고 업데이트하는 방법은 구성요소가 등록되는 방식에 따라 다릅니다.

  • 자동 등록: Agent Registry는 지원되는 런타임에서 직접 메타데이터를 수집하고 해당 Agent 또는 McpServer 검색 리소스를 자동으로 만들고 업데이트합니다. 자동으로 등록된 구성요소에는 Agent Registry에 Service 리소스가 없습니다. 대신 Agent Registry는 런타임에서 기본 배포 또는 워크로드를 업데이트하거나 삭제할 때 변경사항을 동기화합니다.
  • 수동 등록: 구성요소를 수동으로 등록하거나 업데이트하면 에이전트 레지스트리에서 다음 두 가지 리소스를 만들거나 업데이트합니다.
    • 자체 리소스 이름으로 식별되는 쓰기 가능한 Service 리소스입니다. 이 리소스를 사용하여 구성요소를 업데이트하거나 등록 해제합니다. Service 리소스를 수정하거나 삭제하면 에이전트 레지스트리의 항목만 변경되고 기본 배포는 수정되거나 삭제되지 않습니다.
    • Service 리소스의 메타데이터를 기반으로 자동으로 생성되고 업데이트되는 에이전트 구성요소 유형의 읽기 전용 검색 리소스입니다.
      • Agent 리소스: 조정자 에이전트, 클라이언트 애플리케이션, 개발자가 에이전트를 찾고 호출하기 위해 읽는 읽기 전용 탐색 리소스입니다.
      • McpServer 리소스: MCP 서버의 표준화된 도구와 데이터 리소스를 노출하는 읽기 전용 검색 리소스입니다.
      • Endpoint 리소스: 에이전트가 액세스하는 외부 URL 및 REST API의 읽기 전용 탐색 리소스입니다.

Service 리소스 사양 플래그가 읽기 전용 리소스 컬렉션에 매핑되는 방법에 대한 자세한 내용은 서비스 리소스 및 검색 리소스를 참조하세요.

독립형 스킬

에이전트, MCP 서버, 엔드포인트와 달리 독립형 스킬은 별도의 Service 리소스와 읽기 전용 탐색 리소스를 사용하지 않습니다. 대신 Agent Registry는 관리 및 검색을 위한 최상위 Skill 리소스와 변경 불가능한 버전이 지정된 스냅샷을 위한 하위 SkillRevision 리소스, 소유권 범위를 지정하는 Publisher 리소스를 사용하여 각 스킬을 나타냅니다.

  • 자동 등록: Google 관리 스킬은 모든 프로젝트에서 Skill 및 SkillRevision 리소스로 자동으로 사용할 수 있습니다.
  • 수동 등록: 비공개 독립형 스킬을 등록하거나 업데이트할 때 Skill 리소스를 만들거나 업데이트하고 변경 불가능한 SkillRevision 리소스를 Agent Registry에 직접 업로드합니다. 소비자는 동일한 Skill 및 SkillRevision 리소스를 사용하여 기술을 나열, 검색, 가져옵니다.

등록 모델

에이전트 레지스트리는 에이전트 구성요소를 등록하는 두 가지 모델을 지원합니다.

특성 자동 등록 수동 등록
범위 배포된 구성요소의 범위는 단일 프로젝트로 지정됩니다. 기본 제공 Google 에이전트, Google 및 Google Cloud 원격 MCP 서버, Google 관리 스킬은 프로젝트 전반에서 사용할 수 있습니다. 단일 프로젝트로 범위가 지정되거나 여러 프로젝트에서 중앙 집중식으로 관리됩니다.
구성 Gemini Enterprise Agent Platform의 Agent Runtime, 기본 제공되는 Google 에이전트, Google 및 Google Cloud 원격 MCP 서버, Google 관리 스킬은 자동으로 등록됩니다. Google Kubernetes Engine (GKE) 및 Cloud Run 워크로드에는 선택 배포 라벨 또는 플래그가 필요합니다. Agent Registry에서 Service 또는 Skill 리소스를 만들어야 합니다.
런타임 Agent Runtime, GKE, Cloud Run, Google 관리형 런타임 Compute Engine, GKE, Cloud Run, 온프레미스 시스템, 외부 클라우드 플랫폼
대상 구성요소 에이전트, MCP 서버, Google 관리형 독립형 스킬 커스텀 또는 외부 에이전트, MCP 서버, 엔드포인트, 비공개 독립형 스킬
메타데이터 업데이트 런타임 환경 또는 에이전트 카드 엔드포인트에서 자동으로 동기화됩니다. 에이전트 레지스트리에서 Service 리소스를 수정하거나 새 SkillRevision 리소스를 업로드하여 수동으로 업데이트해야 합니다.

자동 등록

자동 등록은 에이전트 레지스트리에서 수동으로 리소스를 만들 필요 없이 지원되는 Google Cloud 런타임에서 에이전트, MCP 서버, Google 관리형 독립형 스킬을 수집합니다. Agent Runtime에 배포된 에이전트, Google Workspace 및 Gemini Enterprise의 기본 제공 Google 에이전트, Google 및Google Cloud 원격 MCP 서버, Google 관리형 독립형 기술은 자동으로 등록됩니다. GKE 배포 및 Cloud Run 워크로드의 경우 에이전트 또는 MCP 서버를 배포할 때 기능 유형 라벨 또는 플래그를 추가하여 자동 등록을 사용 설정합니다.

자동 등록 중에 에이전트 레지스트리는 구성요소의 엔드포인트, 레지스트리 식별자, 런타임 참조, 공지된 A2A 기술 또는 MCP 도구를 에이전트 레지스트리의 탐색 리소스로 추출합니다.

자동 등록 구성에 대한 자세한 내용은 에이전트에 자동 등록 사용 및 MCP 서버 등록을 참조하세요.

수동 등록

수동 등록을 사용하면 Agent Registry에서 직접 리소스를 만들어 원격 또는 커스텀 에이전트, MCP 서버, 엔드포인트, 비공개 독립형 기술을 등록할 수 있습니다. Compute Engine, GKE, Cloud Run, 온프레미스 인프라 또는 외부 클라우드 플랫폼에서 호스팅되는 에이전트, MCP 서버 또는 REST API 엔드포인트를 수동으로 등록할 수 있습니다. 여기에는 A2A 프로토콜을 구현하지 않는 에이전트도 포함됩니다. 또한 수동 등록을 사용하면 별도의 Google Cloud 프로젝트에 배포된 원격 구성요소를 중앙 거버넌스 프로젝트 레지스트리에 등록하여 중앙 집중식 탐색 및 거버넌스를 수행할 수 있습니다.

에이전트, MCP 서버 또는 엔드포인트를 수동으로 등록하려면 Agent Registry에서 Service 리소스를 만들고 구성요소의 인터페이스 URL, 프로토콜 바인딩, --agent-spec-type, --mcp-server-spec-type 또는 --endpoint-spec-type 사양 플래그를 지정합니다. 독립형 기술을 수동으로 등록하려면 ZIP 파일 페이로드로 Skill 리소스를 만듭니다.

수동 등록 구성에 대한 자세한 내용은 에이전트에 수동 등록 사용, 엔드포인트 등록, 기술 등록을 참조하세요.

검색 유형

Google Cloud에서 에이전트 레지스트리의 탐색은 인프라 관리 도구의 탐색과 다릅니다.

  • 사용 검색: Agent Registry는 조정자가 런타임에 호출할 수 있는 등록된 에이전트, MCP 도구, 엔드포인트, 스킬을 찾는 데 중점을 둡니다. 개발자와 에이전트는 자연어 검색, 태그 또는 레지스트리 식별자를 사용하여 Agent Registry를 쿼리하여 워크플로를 완료하는 데 필요한 기능을 찾습니다.
  • 인프라 탐색: App Hub와 같은 서비스는 Google Cloud 프로젝트 전반에서 가상 머신, GKE 서비스, Cloud Run 배포와 같은 물리적 컴퓨팅 리소스를 감지하는 데 중점을 둡니다. App Hub는 이러한 컴퓨팅 애셋을 인프라 상태, 리소스 모니터링, 안정성 추적을 위한 애플리케이션 및 환경으로 구성합니다.

인프라 검색은 워크로드가 실행되는 위치를 추적하는 반면, 에이전트 레지스트리의 소비 검색은 에이전트 또는 도구가 제공하는 기능을 식별합니다.

구성요소 관계

멀티 에이전트 워크플로를 구성하고 아웃바운드 사용자 인증 정보를 관리하려면 바인딩 및 인증 제공업체를 사용하여 구성요소 간에 명시적인 관계를 만듭니다.

결합

바인딩은 레지스트리 식별자(URN)를 사용하여 소스 에이전트와 대상 리소스 간의 방향성 연결을 정의합니다.

  • 에이전트 간 바인딩: 조정자 에이전트가 전문 하위 에이전트를 호출할 수 있는 위임 경로를 설정합니다.
  • 에이전트-MCP 서버 바인딩: 에이전트를 MCP 서버에 연결하여 에이전트를 서버의 게시된 도구 및 데이터 리소스와 연결합니다.
  • 에이전트-엔드포인트 바인딩: 에이전트를 REST API와 같은 등록된 외부 엔드포인트에 연결합니다.

바인딩은 멀티 에이전트 토폴로지에 대한 가시성을 제공하여 팀이 다운스트림 기능과 상호작용하는 에이전트를 감사하는 데 도움이 됩니다. 바인딩을 만들고 관리하는 방법은 바인딩 관리를 참조하세요.

인증 제공업체

에이전트가 외부 도구, MCP 서버 또는 API와 상호작용할 때는 전용 사용자 인증 정보가 필요한 경우가 많습니다. 인증 제공업체는 에이전트를 대신하여 OAuth 토큰 또는 API 키와 같은 사용자 인증 정보를 저장, 획득, 관리하는 에이전트 아이덴티티 인증 관리자의 구성입니다.

바인딩을 인증 제공업체와 연결하면 프롬프트 템플릿이나 에이전트 소스 코드에 보안 비밀을 삽입하지 않고도 에이전트가 외부 대상에 인증할 수 있습니다. 자세한 내용은 도구 및 리소스에 인증을 참조하세요.

다음 단계