프로젝트 및 개발 환경 설정

Gemini Enterprise Agent Platform을 시작하기 위해 이 페이지에서는 Google Cloud 프로젝트를 만들고 Agent Platform API를 사용 설정하는 방법을 안내합니다. 이러한 작업을 수행할 권한이 없는 경우 관리자에게 프로젝트를 설정하고 Gemini Enterprise Agent Platform을 사용 설정해 달라고 요청합니다. 또한 이 페이지에서는 로컬 개발 환경에서 Google Cloud CLI를 설정하는 방법도 설명합니다.

프로젝트 설정

프로젝트를 설정하려면 다음 단계를 따르세요.

  1. Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Gemini Enterprise Agent Platform API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Gemini Enterprise Agent Platform API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    8.

인증 설정

    API에 액세스하려는 방법에 해당하는 탭을 선택하세요.

    콘솔

    Google Cloud 콘솔을 사용하여 Google Cloud 서비스 및 API에 액세스하는 경우 인증을 설정할 필요가 없습니다.

    gcloud

    1. Google Cloud CLI를 설치합니다.

    2. 외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.

    3. gcloud CLI를 초기화하려면, 다음 명령어를 실행합니다. 

      gcloud init

    4. gcloud CLI를 초기화한 후 업데이트하고 필요한 구성요소를 설치합니다. 

      gcloud components update
gcloud components install beta

    서비스 계정 가장 기능을 사용하여 사용자 인증 정보 대신 Google API에 인증하도록 gcloud CLI를 설정하려면 다음 명령어를 실행합니다. 

    gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

    자세한 내용은 서비스 계정 가장을 참고하세요.

    클라이언트 라이브러리

    로컬 개발 환경에서 클라이언트 라이브러리를 사용하려면 gcloud CLI를 설치 및 초기화한 다음 사용자 인증 정보로 애플리케이션 기본 사용자 인증 정보를 설정하세요.

    1. Google Cloud CLI를 설치합니다.

    2. 외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.

    3. gcloud CLI를 초기화한 후 업데이트하고 필요한 구성요소를 설치합니다. 

      gcloud components update
gcloud components install beta

    4. 로컬 셸을 사용하는 경우 사용자 계정에 대한 로컬 인증 사용자 인증 정보를 만듭니다. 

      gcloud auth application-default login

      Cloud Shell을 사용하는 경우 이 작업을 수행할 필요는 없습니다.

      인증 오류가 반환되고 외부 ID 공급업체(IdP)를 사용하는 경우 제휴 ID로 gcloud CLI에 로그인했는지 확인합니다.

    자세한 내용은 Google Cloud 인증 문서의 로컬 개발 환경의 ADC 설정을 참고하세요.

    서비스 계정 가장 기능을 사용하여 사용자 인증 정보 대신 Google API에 인증하도록 로컬 ADC 파일을 설정하려면 다음 명령어를 실행합니다. 

    gcloud auth application-default login --impersonate-service-account=SERVICE_ACCT_EMAIL

    자세한 내용은 서비스 계정 가장을 참고하세요.

    REST

    로컬 개발 환경에서 REST API를 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.

    1. Google Cloud CLI를 설치합니다.

    2. 외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.

    3. gcloud CLI를 초기화한 후 업데이트하고 필요한 구성요소를 설치합니다. 

      gcloud components update
gcloud components install beta

    자세한 내용은 Google Cloud 인증 문서의 REST 사용을 위한 인증을 참조하세요.

    서비스 계정 가장 기능을 사용하여 REST API 요청의 액세스 토큰을 생성할 수 있습니다. 자세한 내용은 가장 서비스 계정을 참조하세요.

    프로덕션 환경의 인증 설정에 대한 자세한 내용은 Google Cloud 인증 문서의 Google Cloud에서 실행되는 코드의 애플리케이션 기본 사용자 인증 정보 설정 을 참고하세요.

관리자에게 Gemini Enterprise Agent Platform 프로젝트 설정 요청

이 섹션에서는 관리자가 Gemini Enterprise Agent Platform을 사용하는 데 필요한 역할을 부여하는 방법을 설명합니다.

  1. 프로젝트를 식별할 수 있는 의미 있는 프로젝트 이름과 프로젝트 ID를 결정합니다. 조직에 속해 있거나 여러 프로젝트를 만들려는 경우 어떤 이름 지정 규칙과 폴더 계층 구조를 따르거나 따를 수 있는지 고려하여 프로젝트 구성을 명확히 하세요.
  2. 필요한 역할:
    1. 대부분의 Gemini Enterprise Agent Platform 기능에 대한 액세스 권한은 Gemini Enterprise Agent Platform 사용자 (roles/aiplatform.user) IAM 역할이 부여하며, 대부분의 Gemini Enterprise Agent Platform 사용자에게 충분합니다. Gemini Enterprise Agent Platform 리소스를 완전히 제어하려면 Gemini Enterprise Agent Platform 관리자 (roles/aiplatform.admin) 역할을 요청할 수 있습니다. 이러한 역할과 다른 Gemini Enterprise 에이전트 플랫폼 역할 간의 차이점을 살펴보려면 IAM으로 Gemini Enterprise 에이전트 플랫폼 액세스 제어를 참고하세요.
    2. Google Cloud에서 Gemini Enterprise Agent Platform Workbench 인스턴스도 사용하려면 관리자에게 프로젝트에 대한 Notebooks 관리자 (roles/notebooks.admin) IAM 역할과 프로젝트 또는 Compute Engine 기본 서비스 계정에 대한 서비스 계정 사용자 (roles/iam.serviceAccountUser) IAM 역할을 부여해 달라고 요청하세요.
    3. 또한 필요한 API를 사용 설정하려면 서비스 사용량 관리자 (roles/serviceusage.serviceUsageAdmin) IAM 역할이 필요하거나 관리자가 처음 몇 단계를 수행하여 사용자에 대해 API를 활성화해야 합니다.
  3. 관리자에게 Agent Platform API를 사용 설정해 달라고 요청하세요. 서비스 사용량 관리자 (roles/serviceusage.serviceUsageAdmin) IAM 역할을 부여받은 경우 이 작업을 직접 수행할 수 있습니다.

다음 단계