使用程式碼完成和生成功能

本文說明如何使用 Gemini in Colab Enterprise (Gemini for Google Cloud 產品之一),輔助您在 Colab Enterprise 筆記本中編寫及產生程式碼。

瞭解 Gemini for Google Cloud 如何使用您的資料,以及使用時機

本文件適用於使用 Colab Enterprise 的資料分析師、數據資料學家和資料開發人員。本文假設您已瞭解如何在筆記本環境中編寫程式碼。

事前準備

  1. 確認您已為 Google Cloud 使用者帳戶和專案設定 Gemini in Colab Enterprise。
  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

  5. 必要的角色

    如要取得在 Colab Enterprise 中使用 Gemini 所需的權限,請要求管理員為您授予專案的下列 IAM 角色:

    如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和機構的存取權」。

    您或許還可透過自訂角色或其他預先定義的角色取得必要權限。

    啟用程式碼完成和生成功能

    如要啟用程式碼補全和程式碼產生功能,請按照下列步驟操作:

    1. 在 Google Cloud 控制台中,前往 Colab Enterprise 的「My notebooks」頁面。

      前往「我的筆記本」

    2. 按一下工具列中的 「幫我編寫程式碼」按鈕,然後選取要使用的功能。

      「Help me code」按鈕下方的 Gemini in Colab Enterprise 功能清單,包括程式碼補全和程式碼產生功能。
      • 程式碼完成功能會在您輸入內容時提供程式碼建議。
      • 程式碼生成:根據所需內容的說明生成程式碼。

      如果 「幫我寫程式碼」按鈕未啟用,或是點選按鈕後未顯示功能清單,請參閱在專案的 Colab Enterprise 中設定 Gemini

    使用程式碼完成功能

    如要在 Colab Enterprise 筆記本中使用程式碼補全功能,請按照下列步驟操作:
    1. 在 Google Cloud 控制台中,前往 Colab Enterprise 的「My notebooks」頁面。

      前往「我的筆記本」

    2. 在「Region」選單中,選取含有筆記本的區域。

    3. 按一下要開啟的筆記本。

    4. 在工具列中按一下 pen_spark「幫我編寫程式碼」按鈕,然後選取「Code completion」(程式碼完成) (如果尚未選取)。
    5. 在筆記本的程式碼儲存格中開始輸入程式碼。 Colab Enterprise 會以灰色斜體文字顯示可能的程式碼補全方式。

      舉例來說,如果您輸入 import p,Colab Enterprise 可能會建議您輸入可匯入 pandas as pd 的程式碼,接著輸入可讀取 CSV 檔案並將內容儲存在 pandas 資料框架中的一行程式碼。

    6. 如要接受程式碼完成建議,請按下 Tab 鍵。

    使用程式碼產生功能

    如要使用 Gemini 為 Google Cloud生成程式碼,請按照下列步驟操作:

    1. 在 Google Cloud 控制台中,前往 Colab Enterprise 的「My notebooks」頁面。

      前往「我的筆記本」

    2. 在「Region」選單中,選取含有筆記本的區域。

    3. 按一下要開啟的筆記本。

    4. 在工具列中按一下 「幫我編寫程式碼」按鈕,然後選取「Code generation」(程式碼產生) (如果尚未選取)。

    5. 在筆記本中新增空白程式碼儲存格,或點選沒有任何程式碼的程式碼儲存格。

    6. 依序按一下 「可用的 AI 功能」和「產生程式碼」

    7. 「Generate」欄位中,輸入要產生程式碼的說明,然後按下 Enter 鍵。

    8. 如要關閉「Generate」面板,請按一下 「Close」

    關閉程式碼完成和生成功能

    如要關閉程式碼完成和程式碼產生功能,請按照下列步驟操作:

    1. 在 Colab Enterprise 工具列中,按一下 「幫我編寫程式碼」按鈕。

    2. 清除要關閉的功能。

    疑難排解

    本節說明如何解決在 Colab Enterprise 中使用 Gemini 時發生的問題。

    Gemini 功能無法運作

    在 Colab Enterprise 筆記本中輸入內容時,系統不會顯示程式碼完成建議。 或者,pen_spark「幫我寫程式碼」按鈕未顯示在程式碼單元格上方。

    您可能已在 Colab Enterprise 設定中關閉「顯示依據相關資訊提供的程式碼完成建議」設定。

    如要解決這個問題,請按照下列步驟操作:

    1. 按一下 「切換標題顯示設定」
    2. 在「工具」選單中,按一下「設定」
    3. 按一下「編輯器」
    4. 選取「顯示依據相關資訊提供的程式碼完成建議」
    5. 按一下 [儲存]

    後續步驟