Gemini 지원을 통해 Colab Enterprise 노트북에서 코드 작성

Gemini 지원을 통해 Colab Enterprise 노트북에서 코드 작성

이 문서에서는 Google Cloud 포트폴리오의 제품인 Colab Enterprise의 Gemini를 사용하여 Colab Enterprise 노트북에서 코드를 작성하는 방법을 설명합니다.

Google Cloud 용 Gemini가 사용자의 데이터를 사용하는 방법과 시점을 알아보세요.

이 문서는 Colab Enterprise를 사용하는 데이터 분석가, 데이터 과학자, 데이터 개발자를 대상으로 합니다. 노트북 환경에서 코드를 작성하는 방법을 알고 있다고 가정합니다.

시작하기 전에

1. Colab Enterprise의 Gemini가 Google Cloud 사용자 계정 및 프로젝트에 설정되어 있는지 확인합니다.
2. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

3. Enable the Vertex AI, Cloud AI Companion, Dataform, and Compute Engine APIs.

   Enable the APIs

4. Enable the Vertex AI, Cloud AI Companion, Dataform, and Compute Engine APIs.

   Enable the APIs

필요한 역할

사용자 계정에 Colab Enterprise 노트북에서 Gemini 지원을 사용하여 코드를 작성하는 데 필요한 권한이 있는지 확인하려면 관리자에게 사용자 계정에 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

• Colab Enterprise 사용자 (roles/aiplatform.colabEnterpriseUser)
• Google Cloud용 Gemini 사용자 (roles/cloudaicompanion.user)

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

관리자는 커스텀 역할이나 다른 사전 정의된 역할을 통해 사용자 계정에 필요한 권한을 부여할 수도 있습니다.

필수 역할 하나 이상에 dataform.repositories.list 권한이 포함되어 있습니다. 프로젝트에서 dataform.repositories.list 권한이나 코드 생성자(roles/dataform.codeCreator) 역할을 부여받은 사용자는 Dataform API 또는 Dataform 명령줄 인터페이스(CLI)를 사용하여 해당 프로젝트의 코드 애셋 이름을 나열할 수 있습니다. 관리자가 아닌 사용자가 BigQuery Studio를 사용할 때 직접 만들었거나 공유받은 코드 애셋만 볼 수 있습니다.

Colab Enterprise의 Gemini 설정

Google Cloud용 Gemini 제품은 아직 초기 단계의 기술로, 그럴듯해 보이지만 실제로는 잘못된 출력을 생성할 수 있습니다. Google Cloud 제품용 Gemini의 모든 출력을 사용 전에 미리 검사하는 것이 좋습니다. 자세한 내용은 Google Cloud 용 Gemini 및 책임감 있는 AI를 참고하세요.

Gemini 기능을 사용하려면 다음 단계를 따르세요.

1. Google Cloud 콘솔에서 Colab Enterprise Notebooks 페이지로 이동합니다.

   Notebooks로 이동

2. 내 노트북 탭에서 열려는 노트북을 클릭합니다. 노트북을 만들지 않았으면 노트북을 만듭니다.

3. 툴바에서 pen_spark 코딩 도우미 버튼을 클릭하고 사용하려는 기능을 선택합니다.

   
   • 코드 완성은 입력하는 동안 코드를 제안합니다.
   • 코드 생성은 원하는 대상의 설명에서 코드를 생성하고 코드의 오류 수정사항을 제안합니다.

   pen_spark 코딩 도우미 버튼이 활성화되어 있지 않거나 버튼을 클릭해도 기능 목록이 표시되지 않으면 프로젝트를 위해 Colab Enterprise에서 Gemini 설정을 참고하세요.

코드 완성 사용

Colab Enterprise 노트북에서 코드 완성을 사용하려면 다음 단계를 따르세요.

1. Google Cloud 콘솔에서 Colab Enterprise Notebooks 페이지로 이동합니다.

   Notebooks로 이동

2. 리전 메뉴에서 노트북이 포함된 리전을 선택합니다.

3. 내 노트북 탭에서 열려는 노트북을 클릭합니다.

4. 툴바에서 pen_spark 코딩 도우미 버튼을 클릭하고 아직 선택되지 않았다면 코드 완성을 선택합니다.

5. 노트북의 코드 셀에서 코드 입력을 시작합니다. Colab Enterprise는 회색 기울임꼴 텍스트로 코드를 완성할 수 있는 방법을 제안합니다.

   예를 들어 import p를 입력하면 Colab Enterprise에서 pandas as pd를 가져오고 CSV 파일을 읽고 내용을 pandas 데이터 프레임에 저장하는 행이 뒤따르는 코드 완성을 제안할 수 있습니다.
   

6. 추천 코드 완성을 수락하려면 탭 키를 누릅니다.

코드 생성 사용

Google Cloud용 Gemini를 사용하여 코드를 생성하려면 다음 단계를 따르세요.

1. Google Cloud 콘솔에서 Colab Enterprise Notebooks 페이지로 이동합니다.

   Notebooks로 이동

2. 리전 메뉴에서 노트북이 포함된 리전을 선택합니다.

3. 내 노트북 탭에서 열려는 노트북을 클릭합니다.

4. 툴바에서 pen_spark 코드 작성 지원 버튼을 클릭하고 아직 선택되지 않았다면 코드 생성을 선택합니다.

5. 노트북의 빈 코드 셀에서 생성을 클릭합니다.

6. pen_spark Generate(생성) 필드에 생성하려는 코드의 설명을 입력한 다음 Enter 키를 누릅니다.

7. Generate 패널을 닫으려면 Close를 클릭합니다.

오류 해결

Preview — Error fixing

This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Google Cloud 에서 코드의 오류를 수정하는 데 도움이 되는 Gemini를 사용하려면 다음 단계를 따르세요.

1. Google Cloud 콘솔에서 Colab Enterprise Notebooks 페이지로 이동합니다.

   Notebooks로 이동

2. 리전 메뉴에서 노트북이 포함된 리전을 선택합니다.

3. 내 노트북 탭에서 열려는 노트북을 클릭합니다.

4. 툴바에서 pen_spark 코드 작성 지원 버튼을 클릭하고 아직 선택되지 않았다면 코드 생성을 선택합니다.

5. 노트북의 코드 셀에 오류가 포함된 코드를 입력한 후 셀을 실행합니다. 예를 들어 닫는 괄호가 누락된 print(1을 입력할 수 있습니다.

   코드 셀이 실행되면 Colab Enterprise에서 코드 셀 아래에 오류 메시지를 출력합니다. Colab Enterprise의 Gemini에 코드를 수정할 수 있는 제안이 있으면 오류 수정 버튼이 표시됩니다.

6. 오류 수정 버튼을 클릭합니다.

   Colab Enterprise에 코드의 추천 수정사항이 표시됩니다.

7. 추천을 평가한 후 다음 중 하나를 수행합니다.

   • 추천을 수락하려면  제안 수락을 클릭합니다.
   • 제안을 거부하려면  제안 거부를 클릭합니다.

Gemini 기능 사용 중지하기

Colab Enterprise에서 Gemini 기능을 사용 중지하려면 다음 단계를 따르세요.

1. Colab Enterprise 툴바에서 pen_spark 코딩 도우미 버튼을 클릭합니다.

2. 사용 중지하려는 Gemini 기능을 선택 해제합니다.

문제 해결

이 섹션에서는 Colab Enterprise에서 Gemini를 사용할 때 발생하는 문제를 해결하는 방법을 설명합니다.

Gemini 기능이 작동하지 않음

Colab Enterprise 노트북에 입력해도 코드 완성 제안이 표시되지 않습니다. 또는 pen_spark 코딩 도우미 버튼이 코드 셀 위에 표시되지 않습니다.

Colab Enterprise 설정에서 코드 완성 제안을 자동으로 표시 설정을 사용 중지했을 수 있습니다.

이 문제를 해결하려면 다음 단계를 따르세요.

1.  헤더 공개 상태 전환을 클릭합니다.
2. 도구 메뉴에서 설정을 클릭합니다.
3. 편집기를 클릭합니다.
4. 코드 완성 제안을 자동으로 표시를 선택합니다.
5. 저장을 클릭합니다.

다음 단계

• Google Cloud용 Gemini 개요를 읽어봅니다.

• Google Cloud 용 Gemini에서 사용자 데이터를 사용하는 방법을 알아보세요.