Gemini CLI 사용

Gemini CLI 사용

미리보기 - Private Service Connect 인터페이스

이 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제품 또는 서비스 약관'이 적용됩니다. GA 이전 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

이 페이지에서는 Vertex AI Workbench 인스턴스에서 Gemini CLI (명령줄 인터페이스)를 사용하는 방법을 설명합니다.

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

개요

Gemini CLI는 터미널에서 바로 Gemini에 액세스할 수 있도록 지원하는 오픈소스 AI 에이전트입니다. 자세한 내용은 geminicli.com을 참고하세요.

Gemini CLI는 Vertex AI Workbench 인스턴스에서 사용할 수 있습니다. Gemini CLI를 사용하여 다음 작업을 할 수 있습니다.

• 새 노트북을 만듭니다.
• 노트북 셀을 실행합니다.
• 노트북의 코드 및 텍스트 셀을 작성하고 수정합니다.
• 코드 및 기술 개념을 설명합니다.
• 대략적인 단일 요청 사항을 토대로 여러 파일에 걸친 복잡한 파일 작업을 수행하는 등 Vertex AI Workbench 인스턴스의 로컬 파일 시스템과 상호작용합니다.
• 기본 셸 명령어를 실행합니다.
• Vertex AI 및 BigQuery와 같은 다른 Google Cloud 서비스와 상호작용하는 명령어를 실행합니다.

제한사항

Vertex AI Workbench에서 Gemini CLI를 사용할 때는 다음 제한사항을 고려하세요.

• Gemini CLI는 CLI 전용입니다. 그래픽 채팅 인터페이스와 고급 편집기 내 도구는 포함되지 않습니다.

• Gemini CLI에 노트북 수정을 요청하면 Gemini CLI가 인스턴스의 디스크에서 노트북 파일을 직접 변경합니다. 따라서 노트북 편집기의 실행취소 버튼 또는 Control+Z (macOS의 경우 Command+Z)를 사용하여 Gemini CLI에서 실행한 수정을 실행취소할 수 없습니다. 하지만 Undo your last change와 같은 자연어 명령어를 사용하여 Gemini CLI에 변경사항 실행취소를 요청할 수 있습니다.

시작하기 전에

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

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

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, Notebooks, and Vertex AI APIs.

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 APIs

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, Notebooks, and Vertex AI APIs.

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 APIs

필요한 역할

Vertex AI Workbench에서 Gemini CLI를 사용하려면 Vertex AI Workbench 인스턴스의 사용자와 인스턴스의 서비스 계정에 권한을 부여해야 합니다.

참고: Gemini CLI는 Vertex AI Workbench 인스턴스 환경의 권한 내에서만 작동합니다. 사용자 또는 인스턴스에서 사용하는 서비스 계정에 특정 리소스에 액세스할 권한이 없으면 Gemini CLI도 액세스할 수 없습니다. 권한으로 인해 명령어가 실패하면 관리자에게 필요한 권한을 부여해 달라고 요청하세요.

인스턴스 사용자에게 권한 부여

Vertex AI Workbench 인스턴스에서 Gemini CLI를 사용하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Vertex AI 사용자 (roles/aiplatform.user) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참고하세요.

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

인스턴스의 서비스 계정에 권한 부여

Vertex AI Workbench 인스턴스의 서비스 계정에 Vertex AI Workbench 인스턴스에서 Gemini CLI를 실행하는 데 필요한 권한이 있는지 확인하려면 관리자에게 프로젝트의 Vertex AI Workbench 인스턴스 서비스 계정에 Vertex AI 사용자 (roles/aiplatform.user) IAM 역할을 부여해 달라고 요청하세요.

중요: 이 역할을 사용자 계정이 아닌 Vertex AI Workbench 인스턴스의 서비스 계정에 부여해야 합니다. 역할을 올바른 주 구성원에게 부여하지 않으면 권한 오류가 발생할 수 있습니다.

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

이 사전 정의된 역할에는 aiplatform.endpoints.predict 권한이 포함되어 있습니다. 이 권한은 Vertex AI Workbench 인스턴스에서 Gemini CLI를 실행하는 데 필요합니다.

관리자는 커스텀 역할이나 다른 사전 정의된 역할을 사용하여 Vertex AI Workbench 인스턴스의 서비스 계정에 이 권한을 부여할 수도 있습니다.

Gemini CLI 사용

1. 콘솔에서 인스턴스 페이지로 이동합니다. Google Cloud

   인스턴스로 이동

2. Vertex AI Workbench 인스턴스 이름 옆에 있는 JupyterLab 열기를 클릭합니다.

   Vertex AI Workbench 인스턴스가 JupyterLab을 엽니다.

3. JupyterLab에서 파일 > 새 런처를 클릭합니다.

4. 런처 탭의 기타 섹션에서 Gemini CLI 타일을 클릭합니다.

5. Gemini CLI 터미널을 처음 여는 경우, Y을(를) 입력하여 약관에 동의합니다.

   Vertex AI Workbench 인스턴스가 the Gemini CLI를 설치합니다.

6. Gemini CLI 터미널에 프롬프트를 입력합니다.

   예를 들어 Create a new notebook named 'test-notebook'를 입력할 수 있습니다. 도움이 될 수 있는 프롬프트의 예를 보려면 샘플 프롬프트를 참고하세요.

샘플 프롬프트

Gemini CLI 사용 방법에 대한 아이디어를 얻으려면 다음 샘플 프롬프트를 참고하세요.

• 'BigQuery 및 Python을 사용하여 bigquery-public-data.ml_datasets.census_adult_income에서 '소득 구간'을 예측하는 모델을 학습시키는 새 노트북을 만듭니다.'

• 'test-file'이라는 노트북을 요약하고 프로젝트의 다음 단계를 제안합니다.'

• '이 디렉터리의 노트북을 빠르게 개략적으로 살펴보고 싶습니다. 모든 .ipynb 파일에 대해 파일의 처음 5줄을 표시해 주세요.'

• 'test-file' 노트북의 콘텐츠를 사용하여 스크립트를 만듭니다.'

• 'Vertex AI Workbench 내에서 BigQuery 테이블의 데이터에 액세스하는 방법을 보여주세요.'

• 'bigquery-public-data.ml_datasets.census_adult_income 테이블을 쿼리하여 소득 구간이 50,000달러를 초과하는 사람 수를 찾습니다.'

• '기본 Google Cloud 프로젝트를 my-project로 설정합니다.'

• 'Cloud Storage 버킷을 만들고 현재 디렉터리의 모든 CSV 파일을 버킷에 업로드합니다.'

• 'Debian 11 이미지와 n1-standard-4 머신 유형으로 Compute Engine 인스턴스를 만듭니다.'

• 'test-script'의 코드를 실행하는 노트북 파일을 만듭니다. 코드를 설명하는 텍스트 셀을 추가합니다.'

Gemini CLI에 대한 액세스 제어

다음 방법을 사용하여 Vertex AI Workbench에서 Gemini CLI에 대한 액세스를 제어할 수 있습니다.

• 관리자는 조직, 폴더 또는 프로젝트 수준에서 특정 Gemini 모델의 사용을 제한하는 조직 정책을 설정할 수 있습니다. Model Garden 모델의 액세스 제어를 참고하세요. Gemini CLI는 JupyterLab에 계속 표시되지만 CLI는 프롬프트에 응답하지 않습니다.

• 관리자는 aiplatform.endpoints.predict 권한을 부여하지 않음으로써 일부 ID가 추론에 Gemini 엔드포인트를 사용하지 못하도록 차단할 수 있습니다.

Gemini CLI 매직 명령어 사용

노트북 파일의 셀 내에서 직접 Gemini CLI를 사용하려면 다음 단계를 따르세요.

1. Gemini CLI가 사용 설정되어 있고 사용자 또는 작성자가 약관에 동의했는지 확인합니다.
2. 새 셀의 첫 번째 줄에 %%geminicli_magic을 입력합니다.
3. 같은 셀에서 다음 줄에 프롬프트를 입력합니다.
4. 셀을 실행합니다.

Gemini CLI가 응답과 함께 아래에 새 셀을 추가합니다.

문제 해결

Vertex AI Workbench 인스턴스에서 Gemini CLI를 사용하는 데 문제가 발생하면 문제 해결 Vertex AI Workbench 에서 일반적인 문제의 도움말을 참고하세요.

다음 단계

• Gemini에 대해 자세히 알아보세요.

• Vertex AI Workbench 노트북에서 BigQuery 데이터를 쿼리하는 방법을 알아보려면 JupyterLab 내에서 BigQuery의 데이터 쿼리를 참고하세요.