Gemini Code Assist 도구 사용 설정

이 문서에서는 Gemini Code Assist 도구를 사용 설정하는 방법을 설명합니다.Google Cloud 관리자는 IDE에서 개발자를 위한 도구를 사용 설정하려면 이 단계를 완료해야 합니다.

도구에 관한 자세한 내용은 Gemini Code Assist 도구 개요를 참조하세요. IDE에서 사용할 도구를 구성하려면 Gemini Code Assist 도구 구성을 참조하세요.

시작하기 전에

  1. Gemini Code Assist를 설정합니다.

  2. Make sure that billing is enabled for your Google Cloud project.

  3. Enable the Developer Connect API.

    Enable the API

    Developer Connect는 사용자 계정과 Gemini Code Assist 도구 서비스 간에 연결을 만드는 데 사용됩니다.

필요한 역할

Gemini Code Assist 도구를 사용 설정하는 데 필요한 권한을 얻으려면 관리자에게 Google Cloud 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

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

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

도구 사용 설정

  1. Google Cloud 콘솔에서 Gemini Code Assist 도구 페이지로 이동합니다.

    도구로 이동

  2. 사용 설정하려는 도구를 찾은 다음 사용 설정을 클릭합니다. 도구 세부정보 페이지가 열립니다.

  3. 구성 섹션에서 도구의 Developer Connect 계정 커넥터를 만들 리전을 선택합니다. 사용 가능한 리전은 Developer Connect 위치에 나열되어 있습니다.

  4. 사용 설정을 클릭합니다.

    이 도구는 프로젝트에 사용 설정되며 개발자는 IDE에서 사용할 수 있습니다.

    IDE에서 도구를 사용하려면 계정에 연결하라는 메시지가 표시됩니다. IDE에서 도구를 사용하려면 연결을 클릭하고 안내에 따라 계정을 연결합니다. 도구를 사용하지 않으려면 연결 단계를 건너뛰어도 됩니다.

  5. 사용자가 도구에 인증할 수 있도록 하려면 커스텀 역할을 만들어 사용자에게 부여해야 합니다.

    1. 다음 명령어를 실행하여 커스텀 역할을 만듭니다.

      gcloud iam roles create ROLE_NAME \
    --project=PROJECT \
    --title="Gemini Code Assist Tools User" \
    --description="custom role for tools user" \
    --permissions=cloudaicompanion.codeToolsSettings.get,cloudaicompanion.codeToolsSettings.list,cloudaicompanion.settingBindings.codeToolsSettingsGet,cloudaicompanion.settingBindings.codeToolsSettingsList,cloudaicompanion.instances.queryEffectiveSetting

      다음을 바꿉니다.

      • ROLE_NAME을 커스텀 역할에 지정할 이름으로 바꿉니다.
      • PROJECT를 Google Cloud 프로젝트 ID로 바꿉니다.

    2. 다음 명령어를 실행하여 사용자에게 커스텀 역할을 부여합니다.

      gcloud projects add-iam-policy-binding PROJECT \
    --member=PRINCIPAL_TYPE:PRINCIPAL \
    --role=projects/PROJECT/roles/ROLE_NAME

      다음을 바꿉니다.

      • PROJECT를 Google Cloud 프로젝트 ID로 바꿉니다.
      • PRINCIPAL_TYPE을 커스텀 역할을 부여하려는 주 구성원 유형으로 바꿉니다. 주 구성원 유형에 관한 자세한 내용은 주 구성원 식별자를 참조하세요.
      • PRINCIPAL을 주 구성원 식별자로 바꿉니다.

      • ROLE_NAME을 커스텀 역할에 지정한 이름으로 바꿉니다.

        다음 예시에서는 test-project 프로젝트의 단일 사용자 luka@example.com에게 커스텀 역할 tools-user를 부여합니다.

        gcloud projects add-iam-policy-binding test-project \
    --member=user:luka@example.com \
    --role=projects/test-project/roles/tools-user

      사용자에게 커스텀 역할을 부여하면 사용자는 Gemini Code Assist 채팅에서 @TOOL_NAME을 사용하여 도구에 프롬프트를 표시하여 사용 설정된 Gemini Code Assist 도구에 인증할 수 있습니다. 여기서 TOOL_NAME은 도구의 이름입니다.

다음 단계