에이전트 레지스트리 설정

Agent Registry에서 AI 에이전트 및 모델 컨텍스트 프로토콜 (MCP) 서버 를 등록하고 검색하려면 프로젝트에서 Agent Registry API를 사용 설정해야 합니다. Google Cloud Agent Registry는 프로젝트 수준에서 작동하므로 API가 사용 설정된 특정 프로젝트 내에 배포된 에이전트를 검색하고 관리할 수 있습니다.

이 문서에서는 Agent Registry를 설정하고 필요한 API를 사용 설정하는 방법을 설명합니다.

시작하기 전에

Agent Registry를 설정하려면 기존 프로젝트를 사용하거나 새 프로젝트를 만듭니다.

필요한 역할

Agent Registry를 설정하는 데 필요한 권한을 얻으려면 관리자에게 your Google Cloud project에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

gcloud CLI 환경 설정

Agent Registry에 Google Cloud CLI를 사용하려면 다음 단계를 따르세요.

  1. 콘솔에서 Cloud Shell을 활성화합니다. Google Cloud

    Cloud Shell 활성화

    콘솔 하단에 Cloud Shell 세션이 시작되고 명령줄 프롬프트가 표시됩니다. Google Cloud Cloud Shell은 Google Cloud CLI가 사전 설치된 셸 환경으로, 현재 프로젝트의 값이 이미 설정되어 있습니다. 세션이 초기화되는 데 몇 초 정도 걸릴 수 있습니다.

  2. alpha 구성요소를 설치합니다.

    gcloud components install alpha

  3. 최신 버전의 Google Cloud CLI가 설치되어 있는지 확인합니다.

    gcloud components update

Agent Registry API 사용 설정

콘솔

API 사용 설정에 필요한 역할

API를 사용 설정하려면 serviceusage.services.enable 권한이 포함된 서비스 사용량 관리자 IAM 역할(roles/serviceusage.serviceUsageAdmin)이 필요합니다. 역할 부여 방법 알아보기

API 사용 설정하기

gcloud

프로젝트에서 Agent Registry API를 사용 설정합니다.

gcloud services enable agentregistry.googleapis.com \
    --project=PROJECT_ID

PROJECT_ID를 프로젝트의 ID로 바꿉니다.

Agent Registry API를 사용 설정한 후 이 프로젝트에서 에이전트를 등록하고 검색할 수 있습니다.

권한 부여

Agent Registry에서 서비스를 보고 관리하려면 사용자에게 적절한 ID 및 액세스 관리 권한을 부여해야 합니다.

사용자에게 다음 Agent Registry 역할 중 하나 이상을 부여합니다.

  • Agent Registry API 뷰어 (roles/agentregistry.viewer): 에이전트, 도구, 속성을 봅니다.
  • Agent Registry API 편집자 (roles/agentregistry.editor): Agent Registry 리소스에 대한 액세스를 수정합니다.
  • Agent Registry API 관리자 (roles/agentregistry.admin): 에이전트 수동 등록 및 메타데이터 업데이트를 비롯한 모든 작업을 수행합니다.

프로젝트에서 IAM 역할을 부여하는 방법을 알아보려면 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

Agent Registry 프로젝트 변경

Agent Registry를 사용하는 프로젝트를 변경하고 이전 프로젝트에서 종속 항목을 삭제하려면 해당 프로젝트에서 Agent Registry API를 사용 중지합니다. 그런 다음 다른 프로젝트에서 Agent Registry API를 사용 설정할 수 있습니다. 데이터는 이전되지 않으며 이 새 프로젝트에서 리소스를 다시 만들어야 합니다.

Agent Registry API 사용 중지

더 이상 Agent Registry가 필요하지 않으면 프로젝트에서 Agent Registry API를 사용 중지합니다.

콘솔

  1. 콘솔에서 Agent Registry API 관리 페이지로 이동합니다. Google Cloud

    Agent Registry API로 이동

  2. 프로젝트 선택 도구에서 Agent Registry를 설정한 Google Cloud 프로젝트를 선택합니다.

  3. API 사용 중지 를 클릭합니다.

  4. 확인 대화상자에서 사용 중지 를 클릭합니다.

gcloud 

gcloud services disable agentregistry.googleapis.com \
  --project=PROJECT_ID

PROJECT_ID를 프로젝트의 ID로 바꿉니다.

다음 단계