GSP1293

總覽

本實驗室將介紹 Gemini 2.0 Flash 模型的程式碼執行功能。Gemini 2.0 Flash 是 Google DeepMind 推出的全新多模態生成式 AI 模型。Gemini 2.0 Flash 的速度、品質和進階推理能力皆有所提升，包括更強的理解力、程式設計和遵循指令的能力。

這個模型的關鍵功能是執行程式碼，也就是直接在 API 生成及執行 Python 程式碼的能力。如要讓 API 生成及執行 Python 程式碼並傳回結果，可以使用本實驗室示範的程式碼執行功能。

有了這項程式碼執行能力，模型就能生成程式碼、執行及觀察結果，並在必要時修正程式碼、從結果中反覆學習，直到生成最終內容。這項功能特別適合需要以程式碼進行推理的應用程式，例如解數學方程式或處理文字。

Gemini

Gemini 是由 Google DeepMind 開發的一系列強大生成式 AI 模型，可以解讀及生成文字、程式碼、圖像、音訊和影片等多種形式的內容。

在 Vertex AI 使用 Gemini API

Vertex AI 中的 Gemini API 提供統一的介面，讓開發人員輕鬆與 Gemini 模型互動，將強大的 AI 功能整合至自家應用程式。如要瞭解最新資訊和最新版本的特定功能，請參閱官方的 Gemini 說明文件。

Gemini 模型

• Gemini Pro：適用於下列複雜的推論作業：
  • 分析及總結大量資訊。
  • 進行精細的跨模態 (文字、程式碼、圖像等) 推論。
  • 運用內容豐富的程式碼集有效解決問題。
• Gemini Flash：速度和效率最優異，具備下列優勢：
  • 回覆時間不到一秒，處理量高。
  • 品質高、費用較為低廉，適合各種工作。
  • 具備經過強化的多模態功能，包括更強大的空間理解能力、新的輸出模態 (文字、音訊、圖像)，並能使用原生工具，例如使用 Google 搜尋，以及執行程式碼和第三方函式。

事前準備

開始這個實驗室之前，您應已熟悉下列概念：

• 基本 Python 程式設計。
• 一般 API 概念。
• 在 Vertex AI Workbench 使用 Jupyter 筆記本執行 Python 程式碼。

目標

在本實驗室，您將瞭解如何透過 Gemini 2.0 Flash 模型，利用 Vertex AI 中的 Gemini API 和 Google Gen AI SDK for Python 生成及執行程式碼。

您將完成下列工作：

• 利用文字提示生成及執行 Python 程式碼範例
• 透過多輪對話中的程式碼執行功能探索資料
• 在串流工作階段使用程式碼執行功能

設定和需求

瞭解以下事項後，再點選「Start Lab」按鈕

請詳閱以下操作說明。實驗室活動會計時，且中途無法暫停。點選「Start Lab」後就會開始計時，顯示可使用 Google Cloud 資源的時間。

您將在真正的雲端環境完成實作實驗室活動，而不是模擬或示範環境。為此，我們會提供新的暫時憑證，供您在實驗室活動期間登入及存取 Google Cloud。

為了順利完成這個實驗室，請先確認：

• 可以使用標準的網際網路瀏覽器 (Chrome 瀏覽器為佳)。

注意事項：請使用無痕模式 (建議選項) 或私密瀏覽視窗執行此實驗室，這可以防止個人帳戶和學員帳戶之間的衝突，避免個人帳戶產生額外費用。

• 是時候完成實驗室活動了！別忘了，活動一旦開始將無法暫停。

注意事項：務必使用實驗室專用的學員帳戶。如果使用其他 Google Cloud 帳戶，可能會產生額外費用。

如何開始研究室及登入 Google Cloud 控制台

1. 點選「Start Lab」按鈕。如果實驗室會產生費用，畫面上會出現選擇付款方式的對話方塊。左側的「Lab Details」窗格會顯示下列項目：

   • 「Open Google Cloud console」按鈕
   • 剩餘時間
   • 必須在這個研究室中使用的臨時憑證
   • 完成這個實驗室所需的其他資訊 (如有)

2. 點選「Open Google Cloud console」；如果使用 Chrome 瀏覽器，也能按一下滑鼠右鍵，選取「在無痕視窗中開啟連結」。

   接著，實驗室會啟動相關資源，並開啟另一個分頁，顯示「登入」頁面。

   提示：您可以在不同的視窗中並排開啟分頁。

   注意：如果頁面中顯示「選擇帳戶」對話方塊，請點選「使用其他帳戶」。

3. 如有必要，請將下方的 Username 貼到「登入」對話方塊。

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

   您也可以在「Lab Details」窗格找到 Username。

4. 點選「下一步」。

5. 複製下方的 Password，並貼到「歡迎使用」對話方塊。

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

   您也可以在「Lab Details」窗格找到 Password。

6. 點選「下一步」。

   重要事項：請務必使用實驗室提供的憑證，而非自己的 Google Cloud 帳戶憑證。 注意：如果使用自己的 Google Cloud 帳戶來進行這個實驗室，可能會產生額外費用。

7. 按過後續的所有頁面：

   • 接受條款及細則。
   • 由於這是臨時帳戶，請勿新增救援選項或雙重驗證機制。
   • 請勿申請免費試用。

Google Cloud 控制台稍後會在這個分頁開啟。

注意：如要使用 Google Cloud 產品和服務，請點選「導覽選單」，或在「搜尋」欄位輸入服務或產品名稱。

工作 1：開啟 Vertex AI Workbench 中的筆記本

1. 前往 Google Cloud 控制台，依序點按「導覽選單」圖示 >「Vertex AI」>「Workbench」。

2. 找出 執行個體，點按「Open JupyterLab」按鈕。

Workbench 執行個體的 JupyterLab 介面會在新瀏覽器分頁中開啟。

工作 2：設定筆記本

1. 開啟 檔案。

2. 出現「Select Kernel」對話方塊時，從可用核心清單中選取「Python 3」。

3. 完成筆記本的「Getting Started」和「Import libraries」部分。

   • 「專案 ID」請使用 ，「位置」則請使用 。

注意事項：您可以略過標有「Colab only」字樣的筆記本儲存格。如果執行筆記本儲存格後出現 429 回應，稍候 1 分鐘再重新執行儲存格，應該就能繼續操作。

點選「Check my progress」，確認目標已達成。 設定筆記本。

工作 3：在 Gemini 2.0 執行程式碼

在這個部分，您將使用 Gemini API 生成及執行 Python 程式碼。

載入 Gemini 模型

筆記本中的下列程式碼會載入 Gemini 2.0 Flash 模型。如要瞭解 Vertex AI 中的所有 Gemini 模型，請參閱說明文件。

1. 執行筆記本的載入 Gemini 模型部分。

指定程式碼執行工具

筆記本中的下列程式碼會在 Tool 定義中傳遞 code_execution，藉此初始化程式碼執行工具。稍後您會將這項工具登錄至模型，以便生成及執行 Python 程式碼。

1. 執行筆記本的指定程式碼執行工具部分。

生成及執行程式碼

筆記本中的下列程式碼會向 Gemini 模型傳送提示，要求模型生成及執行 Python 程式碼，計算前 50 個質數的總和。程式碼執行工具已導入，因此模型能生成及執行程式碼。

1. 執行筆記本的生成及執行程式碼部分。

查看生成的程式碼

筆記本中的下列程式碼會逐一檢查回覆，查看當中是否含有 part.executable_code，以便顯示生成的 Python 程式碼。

1. 執行筆記本的查看生成的程式碼部分。

查看程式碼執行結果

筆記本中的下列程式碼會逐一檢查回覆，查看當中是否含有 part.code_execution_result，以便顯示執行結果。

1. 執行筆記本的查看程式碼執行結果部分。

點選「Check my progress」，確認目標已達成。 在 Gemini 2.0 執行程式碼。

工作 4：在對話工作階段執行程式碼

這部分說明如何使用 Gemini API 在有記錄的互動式對話中執行程式碼。您可以建立對話工作階段，讓模型生成及執行 Python 程式碼。首先，請要求模型生成含雜訊的時間序列資料樣本，並輸出具有 10 個資料點的樣本。

接著逐一檢查回覆，以便顯示任何生成的程式碼和執行結果，然後要求模型將平滑化資料序列新增至時間序列資料，並顯示結果。最後要求模型針對時間序列資料生成描述性統計資料，並顯示結果。

1. 執行筆記本的在對話工作階段執行程式碼部分。

點選「Check my progress」，確認目標已達成。 在對話工作階段執行程式碼。

工作 5：在串流工作階段執行程式碼

您也可以使用程式碼執行功能，搭配 Gemini API 的串流輸出內容。下列程式碼示範 Gemini API 如何生成及執行程式碼，同時串流傳送結果。

1. 執行筆記本的在串流工作階段執行程式碼部分。

點選「Check my progress」，確認目標已達成。 在串流工作階段執行程式碼。

恭喜！

恭喜！您已順利學會如何使用 Gemini 2.0 生成及執行 Python 程式碼，包括如何串流傳送輸出內容。這項功能可讓您建立更具互動性的動態應用程式。您現在可以運用這些技能打造創新解決方案，簡化工作流程。歡迎持續探索 Gemini 2.0 的無限可能，瞭解這項工具如何為您的專案提供助力！

後續行動/瞭解詳情

歡迎參考下列資源，進一步瞭解 Gemini：

• Gemini 簡介
• Vertex AI 生成式 AI 說明文件
• 透過 YouTube 瞭解生成式 AI
• 探索 Vertex AI 教戰手冊，瀏覽及搜尋眾多精心挑選的生成式 AI 筆記本。
• 前往 Google Cloud 生成式 AI 存放區，查看其他筆記本和範例。

Google Cloud 教育訓練與認證

協助您瞭解如何充分運用 Google Cloud 的技術。我們的課程會介紹專業技能和最佳做法，讓您可以快速掌握要領並持續進修。我們提供從基本到進階等級的訓練課程，並有隨選、線上和虛擬課程等選項，方便您抽空參加。認證可協助您驗證及證明自己在 Google Cloud 技術方面的技能和專業知識。

使用手冊上次更新日期：2025 年 2 月 11 日

實驗室上次測試日期：2025 年 2 月 11 日

Copyright 2025 Google LLC 保留所有權利。Google 和 Google 標誌是 Google LLC 的商標，其他公司和產品名稱則有可能是其關聯公司的商標。