Install packages and import libraries

내 진행 상황 확인하기

/ 5

Load the Gemini models

내 진행 상황 확인하기

/ 5

Run Set system instructions cell in notebook.

내 진행 상황 확인하기

/ 5

Run Thinking level cell in notebook

내 진행 상황 확인하기

/ 5

Run Configure the temperature parameter cell in notebook

내 진행 상황 확인하기

/ 5

Run Generate content stream cell in notebook

내 진행 상황 확인하기

/ 5

Run Thought summaries cell in notebook

내 진행 상황 확인하기

/ 5

Run Multi-turn chat cell in notebook

내 진행 상황 확인하기

/ 5

Run Safety filters cell in notebook

내 진행 상황 확인하기

/ 5

Run Send asynchronous requests cell in notebook

내 진행 상황 확인하기

/ 5

Run Multimodality cell in notebook

내 진행 상황 확인하기

/ 5

Run Media resolution cell in notebook

내 진행 상황 확인하기

/ 5

Run Structured output cell in notebook

내 진행 상황 확인하기

/ 5

Run Search as a tool cell in notebook

내 진행 상황 확인하기

/ 5

Run Code Execution cell in notebook

내 진행 상황 확인하기

/ 5

Run URL context cell in notebook

내 진행 상황 확인하기

/ 5

Run Function calling cell in notebook

내 진행 상황 확인하기

/ 4

Run Streaming function calling cell in notebook

내 진행 상황 확인하기

/ 4

Run Multimodal function responses cell in notebook

내 진행 상황 확인하기

/ 4

Run Thought signatures cell in notebook

내 진행 상황 확인하기

/ 4

Run Count tokens and compute tokens cell in notebook

내 진행 상황 확인하기

/ 4

이 실습에는 학습을 지원하는 AI 도구가 통합되어 있을 수 있습니다.
참고: 일관된 고성능 환경을 보장하기 위해 이 실습에서는 일부 모델 요청에 대해 캐시된 응답을 제공할 수 있습니다.

GSP1150

Google Cloud 사용자 주도형 실습

개요

모델은 텍스트, 코드, 이미지를 처리하도록 설계된 다목적 모델입니다. 정교한 추론과 멀티모달 분석이 필요한 복잡한 작업을 처리합니다. Gemini는 코딩, STEM 주제, 웹 개발, 디버깅에서 탁월한 성능을 발휘합니다. 특히 코드를 생성하고 미묘한 프롬프트를 해결하는 데 효과적입니다.

모델은 고빈도 워크플로에 최적화된 빠르고 효율적인 모델로, 기업은 품질 저하 없이 작업을 자동화하고 응답성이 뛰어난 애플리케이션을 빌드할 수 있습니다. 거의 실시간에 가까운 응답 속도와 우수한 가격 대비 성능을 제공하기 때문에 기업은 매력적인 프로덕션 규모 환경을 제공할 수 있습니다.

이 실습에서는 모델의 주요 기능을 확인하고 새로운 API 기능을 소개하는 예시를 실행합니다.

기본 요건

이 실습을 시작하기 전에 다음 개념을 숙지해야 합니다.

  • 기본 Python 프로그래밍
  • 일반적인 API 개념
  • Agent Platform Workbench의 Jupyter 노트북에서 Python 코드를 실행하는 방법

목표

이 실습에서는 모델을 사용하여 다음 작업을 수행합니다.

  • 사고 수준으로 텍스트를 생성하고 추론을 제어합니다.
  • 모델 파라미터와 시스템 요청 사항을 구성합니다.
  • 오디오, 코드, 동영상 등의 멀티모달 데이터를 처리합니다.
  • 함수 호출과 코드 실행 같은 고급 기능을 구현합니다.

설정 및 요건

실습 시작 버튼을 클릭하기 전에

다음 안내를 확인하세요. 실습에는 시간 제한이 있으며 일시중지할 수 없습니다. 실습 시작을 클릭하면 타이머가 시작됩니다. 이 타이머는 Google Cloud 리소스를 사용할 수 있는 시간이 얼마나 남았는지를 표시합니다.

실무형 실습을 통해 시뮬레이션이나 데모 환경이 아닌 실제 클라우드 환경에서 실습 활동을 진행할 수 있습니다. 실습 시간 동안 Google Cloud에 로그인하고 액세스하는 데 사용할 수 있는 새로운 임시 사용자 인증 정보가 제공됩니다.

이 실습을 완료하려면 다음을 준비해야 합니다.

  • 표준 인터넷 브라우저 액세스 권한(Chrome 브라우저 권장)
참고: 이 실습을 실행하려면 시크릿 모드(권장) 또는 시크릿 브라우저 창을 사용하세요. 개인 계정과 학습자 계정 간의 충돌로 개인 계정에 추가 요금이 발생하는 일을 방지해 줍니다.
  • 실습을 완료하기에 충분한 시간(실습을 시작하고 나면 일시중지할 수 없음)
참고: 이 실습에는 학습자 계정만 사용하세요. 다른 Google Cloud 계정을 사용하는 경우 해당 계정에 비용이 청구될 수 있습니다.

실습을 시작하고 Google Cloud 콘솔에 로그인하는 방법

  1. 실습 시작 버튼을 클릭합니다. 실습 비용을 결제해야 하는 경우 결제 수단을 선택할 수 있는 대화상자가 열립니다. 오른쪽에는 다음과 같은 항목이 포함된 실습 설정 및 액세스 패널이 있습니다.

    • Google Cloud 콘솔 열기 버튼
    • 이 실습에 사용해야 하는 임시 사용자 인증 정보(사용자 이름 및 비밀번호)
    • 필요한 경우 실습 진행을 위한 기타 정보

    실습 타이머는 페이지 상단에 있으며 남은 시간을 표시합니다.

  2. Google Cloud 콘솔 열기를 클릭합니다(Chrome 브라우저를 실행 중인 경우 마우스 오른쪽 버튼으로 클릭하고 시크릿 창에서 링크 열기를 선택합니다).

    실습에서 리소스가 가동되면 다른 탭이 열리고 로그인 페이지가 표시됩니다.

    팁: 두 개의 탭을 각각 별도의 창으로 나란히 정렬하세요.

    참고: 계정 선택 대화상자가 표시되면 다른 계정 사용을 클릭합니다.
  3. 필요한 경우 아래의 사용자 이름을 복사하여 로그인 대화상자에 붙여넣습니다.

    {{{user_0.username | "Username"}}}

    실습 설정 및 액세스 패널에서도 사용자 이름을 확인할 수 있습니다.

  4. 다음을 클릭합니다.

  5. 아래의 비밀번호를 복사하여 시작하기 대화상자에 붙여넣습니다.

    {{{user_0.password | "Password"}}}

    실습 설정 및 액세스 패널에서도 비밀번호를 확인할 수 있습니다.

  6. 다음을 클릭합니다.

    중요: 실습에서 제공하는 사용자 인증 정보를 사용해야 합니다. Google Cloud 계정 사용자 인증 정보를 사용하지 마세요. 참고: 이 실습에 자신의 Google Cloud 계정을 사용하면 추가 요금이 발생할 수 있습니다.
  7. 이후에 표시되는 페이지를 클릭하여 넘깁니다.

    • 이용약관에 동의하세요.
    • 임시 계정이므로 복구 옵션이나 2단계 인증을 추가하지 마세요.
    • 무료 체험판을 신청하지 마세요.

잠시 후 Google Cloud 콘솔이 이 탭에서 열립니다.

참고: Google Cloud 제품 및 서비스에 액세스하려면 탐색 메뉴를 클릭하거나 검색창에 제품 또는 서비스 이름을 입력합니다. 탐색 메뉴 아이콘 및 검색창

작업 1. 환경 구성

이 섹션에서는 패키지를 설치하고 라이브러리를 가져옵니다.

Agent Platform Workbench에서 노트북 열기

  1. Google Cloud 콘솔의 탐색 메뉴(탐색 메뉴 아이콘)에서 Agent Platform > Notebooks > Workbench를 클릭합니다.

  2. 인스턴스를 찾아 JupyterLab 열기 버튼을 클릭합니다.

Workbench 인스턴스의 JupyterLab 인터페이스가 새 브라우저 탭에서 열립니다.

노트북 설정하기

  1. 파일을 엽니다.

  2. 커널 선택 대화상자에서 사용 가능한 커널 목록 중 Python 3(로컬)을 선택합니다.

  3. 노트북의 시작하기 섹션을 실행합니다. 프로젝트 ID와 위치가 사전 구성되어 있습니다.

참고: 노트북 셀 실행 중 429 응답이 발생하는 경우 1분 동안 기다린 다음 다시 셀을 실행하여 계속 진행하세요.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 패키지 설치 및 라이브러리 가져오기

작업 2. Gemini 모델 로드

  • 노트북에서 Gemini 모델 로드 섹션의 셀을 실행하여 genai 클라이언트를 초기화하고 모델 변수를 정의합니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 노트북의 Gemini 3 모델 로드 섹션 실행

작업 3. Gemini의 기능 살펴보기

이 섹션에서는 주요 Gemini 3 Pro 모델의 기능과 API 기능을 살펴봅니다. 노트북에서 기능을 살펴본 후에는 이 안내 페이지로 돌아와 진행 상황을 확인해야 합니다.

시스템 요청 사항 설정

  • 시스템 요청 사항 설정 섹션으로 이동한 다음 셀을 실행하여 모델의 동작(영어를 스페인어로 번역)을 정의합니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 노트북의 시스템 요청 사항 설정 섹션 실행

사고 수준

  • 사고 수준 섹션으로 이동합니다. 셀을 실행하여, thinking_level 파라미터를 조정하면 모델의 추론 프로세스 깊이가 어떻게 달라지는지 확인합니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 노트북의 사고 수준 섹션 실행

온도 파라미터 구성

  • 온도 파라미터 구성 섹션에서 코드를 실행하여 대답 생성의 무작위성을 조정합니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 노트북의 온도 파라미터 구성 섹션 실행

콘텐츠 스트림 생성

  • 콘텐츠 스트림 생성 섹션을 실행하여, 모델이 처리가 완전히 완료될 때까지 기다리지 않고 대답을 청크 단위로 제공하는 방식을 확인합니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 노트북의 콘텐츠 스트림 생성 섹션 실행

사고 요약

  • 사고 요약 셀을 실행하여 모델의 최종 답변 전 중간 추론 단계를 검사합니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 노트북의 사고 요약 섹션 실행

멀티턴 채팅

  • 멀티턴 채팅 섹션을 완료하여 이전 프롬프트의 컨텍스트를 유지하는 채팅 세션을 시작합니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 노트북의 멀티턴 채팅 섹션 실행

안전 필터

  • 안전 필터 섹션으로 이동한 다음 셀을 실행하여 증오심 표현, 괴롭힘, 기타 카테고리에 대한 차단 기준을 구성합니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 노트북의 안전 필터 섹션 실행

비동기식 요청 보내기

  • 비동기식 요청 보내기 섹션을 실행하여 비동기 메서드를 사용하여 비차단 요청을 보내는 방법을 알아봅니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 노트북의 비동기식 요청 보내기 섹션 실행

멀티모달리티

  • 멀티모달리티 섹션에서 코드를 실행하여 이미지, 동영상, 텍스트 프롬프트를 비롯한 다양한 미디어 유형을 분석합니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 노트북의 멀티모달리티 섹션 실행

미디어 해상도

  • 미디어 해상도 섹션을 완료하여 다양한 해상도 설정이 모델의 시각적 세부 사항 분석에 어떤 영향을 미치는지 비교해 봅니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 노트북의 미디어 해상도 섹션 실행

구조화된 출력

  • 구조화된 출력 셀을 실행하여 모델이 JSON 같은 특정 형식으로 대답하도록 강제합니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 노트북의 구조화된 출력 섹션 실행

Google 검색을 사용한 그라운딩

  • Google 검색을 사용한 그라운딩 섹션을 실행하여 모델의 대답을 Google 검색의 실시간 데이터에 그라운딩합니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 노트북의 Google 검색을 사용한 그라운딩 섹션 실행

코드 실행

  • 코드 실행 섹션으로 이동한 다음 셀을 실행하여 모델이 Python 코드를 작성하고 실행해 수학 문제를 해결할 수 있게 합니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 노트북의 코드 실행 섹션 실행

URL 컨텍스트

  • URL 컨텍스트 섹션을 완료하여 모델이 제공된 URL에서 직접 콘텐츠를 처리하고 요약하는 방법을 확인합니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 노트북의 URL 컨텍스트 섹션 실행

함수 호출

  • 함수 호출 섹션을 실행하여 모델이 외부 정보를 가져오기 위해 호출할 수 있는 커스텀 도구를 정의합니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 노트북의 함수 호출 섹션 실행

스트리밍 함수 호출

  • 스트리밍 함수 호출 셀을 실행하여 스트리밍 대답 내에서 도구 출력을 처리합니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 노트북의 스트리밍 함수 호출 섹션 실행

멀티모달 함수 응답

  • 멀티모달 함수 응답 섹션을 완료하여 함수가 이미지나 차트 같은 비텍스트 데이터를 반환하는 방법을 확인합니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 노트북의 멀티모달 함수 응답 섹션 실행

사고 서명

  • 사고 서명 섹션을 실행하여 모델 추론 체인의 신뢰성을 확인합니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 노트북의 사고 서명 섹션 실행

토큰 집계 및 컴퓨팅

  • 마지막으로 토큰 집계 및 컴퓨팅 셀을 실행하여 프롬프트와 대답의 비용과 크기를 분석합니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 노트북의 토큰 집계 및 컴퓨팅 섹션 실행

수고하셨습니다

실습을 완료하셨습니다. 이 실습에서는 Gemini API와 Google 생성형 AI SDK를 사용하여 Jupyter 노트북에서 모델을 작업했습니다.

다음 단계/더 학습하기

생성형 AI 및 Gemini Enterprise Agent Platform에 대해 자세히 알아보려면 다음 리소스를 확인하세요.

Google Cloud 교육 및 자격증

Google Cloud 기술을 최대한 활용하는 데 도움이 됩니다. Google 강의에는 빠른 습득과 지속적인 학습을 지원하는 기술적인 지식과 권장사항이 포함되어 있습니다. 기초에서 고급까지 수준별 학습을 제공하며 바쁜 일정에 알맞은 주문형, 실시간, 가상 옵션이 포함되어 있습니다. 인증은 Google Cloud 기술에 대한 역량과 전문성을 검증하고 입증하는 데 도움이 됩니다.

설명서 최종 업데이트: 2026년 5월 18일

실습 최종 테스트: 2026년 4월 16일

Copyright 2026 Google LLC. All rights reserved. Google 및 Google 로고는 Google LLC의 상표입니다. 기타 모든 회사명 및 제품명은 해당 업체의 상표일 수 있습니다.

시작하기 전에

  1. 실습에서는 정해진 기간 동안 Google Cloud 프로젝트와 리소스를 만듭니다.
  2. 실습에는 시간 제한이 있으며 일시중지 기능이 없습니다. 실습을 종료하면 처음부터 다시 시작해야 합니다.
  3. 화면 왼쪽 상단에서 실습 시작을 클릭하여 시작합니다.

시크릿 브라우징 사용

  1. 실습에 입력한 사용자 이름비밀번호를 복사합니다.
  2. 비공개 모드에서 콘솔 열기를 클릭합니다.

콘솔에 로그인

    실습 사용자 인증 정보를 사용하여
  1. 로그인합니다. 다른 사용자 인증 정보를 사용하면 오류가 발생하거나 요금이 부과될 수 있습니다.
  2. 약관에 동의하고 리소스 복구 페이지를 건너뜁니다.
  3. 실습을 완료했거나 다시 시작하려고 하는 경우가 아니면 실습 종료를 클릭하지 마세요. 이 버튼을 클릭하면 작업 내용이 지워지고 프로젝트가 삭제됩니다.

현재 이 콘텐츠를 이용할 수 없습니다

이용할 수 있게 되면 이메일로 알려드리겠습니다.

감사합니다

이용할 수 있게 되면 이메일로 알려드리겠습니다.

한 번에 실습 1개만 가능

모든 기존 실습을 종료하고 이 실습을 시작할지 확인하세요.

시크릿 브라우징을 사용하여 실습 실행하기

이 실습을 실행하는 가장 좋은 방법은 시크릿 모드 또는 시크릿 브라우저 창을 사용하는 것입니다. 개인 계정과 학생 계정 간의 충돌로 개인 계정에 추가 요금이 발생하는 일을 방지해 줍니다.