에이전트 레지스트리 설정

Agent Registry에서 AI 에이전트, 모델 컨텍스트 프로토콜 (MCP) 서버, 독립형 스킬, 엔드포인트를 등록하고 검색하려면 Google Cloud 프로젝트에서 Agent Registry API를 사용 설정해야 합니다. 에이전트 레지스트리를 사용 설정하는 프로젝트는 거버넌스 프로젝트 역할을 합니다. 에이전트 레지스트리 거버넌스 프로젝트를 사용하면 해당 프로젝트에 배포된 지원되는 워크로드를 자동으로 검색하고 별도의 Google Cloud 프로젝트, 온프레미스 환경 또는 외부 클라우드에서 호스팅되는 원격 구성요소를 수동으로 등록할 수 있습니다.

시작하기 전에

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

필요한 역할

에이전트 레지스트리를 설정하는 데 필요한 권한을 얻으려면 관리자에게 Google Cloud 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

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

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

Google Cloud CLI 환경 설정

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

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

    Cloud Shell 활성화

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

  2. gcloud components update 명령어를 사용하여 gcloud CLI를 최신 버전으로 업데이트합니다.

    gcloud components update

  3. 프리뷰 기능을 사용하려면 gcloud components install 명령어를 사용하여 alpha 구성요소를 설치합니다.

    gcloud components install alpha

Agent Registry API 사용 설정

콘솔

API 사용 설정에 필요한 역할

API를 사용 설정하려면 serviceusage.services.enable 권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할 (roles/owner)을 통해 이 권한이 이미 있을 수 있습니다. 그렇지 않으면 서비스 사용량 관리자 역할 (roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할 부여 방법 알아보기

API 사용 설정하기

gcloud

gcloud services enable 명령어를 사용하여 프로젝트에서 Agent Registry API를 사용 설정합니다.

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

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

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

권한 부여

Agent Registry에서 리소스를 보고 관리하려면 사용자에게 적절한 Identity and Access Management (IAM) 권한을 부여해야 합니다.

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

  • Agent Registry API 뷰어 (roles/agentregistry.viewer): 에이전트, MCP 서버, 도구, 독립형 스킬, 스킬 버전, 게시자, 엔드포인트, 바인딩을 보고 검색합니다.
  • Agent Registry API 편집자 (roles/agentregistry.editor): 에이전트, MCP 서버, 도구, 엔드포인트, 독립형 스킬, 스킬 버전의 등록, 업데이트, 삭제를 포함한 Agent Registry 리소스를 보고 수정합니다.
  • Agent Registry API 관리자 (roles/agentregistry.admin): 에이전트, MCP 서버, 도구, 엔드포인트, 독립형 기술, 기술 버전, 바인딩, 기술 IAM 정책 등록 및 관리를 포함하여 Agent Registry 리소스에 대한 모든 작업을 수행합니다.
  • 에이전트 레지스트리 사용자 (roles/agentregistry.user): 모든 에이전트 레지스트리 리소스를 보고 에이전트, MCP 서버 또는 엔드포인트에 대한 수정 액세스 권한 없이 독립형 스킬 및 스킬 버전을 만들고 업데이트하고 삭제합니다.

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

에이전트 레지스트리 프로젝트 변경

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

Agent Registry API 사용 중지

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

콘솔

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

    Agent Registry API로 이동

  2. 프로젝트 선택 도구에서 에이전트 레지스트리를 설정한 Google Cloud 프로젝트를 선택합니다.

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

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

gcloud

gcloud services disable 명령어를 사용하여 프로젝트에서 Agent Registry API를 사용 중지합니다.

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

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

다음 단계