使用 Gemini 輔助功能解釋及修正錯誤

本文說明如何使用 Gemini in Colab Enterprise (Gemini for Google Cloud 產品之一)，協助您解釋並修正 Colab Enterprise 筆記本中的錯誤。

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

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

總覽

當您執行會產生錯誤的程式碼時，Colab Enterprise 中的 Gemini 可以提供修正建議或說明錯誤，協助您解決問題。

如果是語法錯誤，系統會顯示「Fix error」按鈕。按一下這個按鈕，即可查看程式碼的修正建議。詳情請參閱「修正錯誤」。

如果是其他類型的錯誤，畫面上會顯示「Explain error」按鈕。按一下這個按鈕，即可查看錯誤說明和可能的解決方法。詳情請參閱「使用錯誤說明」。

事前準備

  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.

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

    Enable the APIs

    5.

    必要的角色

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

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

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

    使用錯誤說明

    如要使用 Gemini Google Cloud 來解釋程式碼中的錯誤，請按照下列步驟操作：

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

      前往「我的筆記本」

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

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

    4. 在筆記本的程式碼儲存格中，輸入含有錯誤的程式碼，然後執行儲存格。舉例來說，您可以輸入 print(a + random())，而無須定義 a。

      程式碼儲存格執行後，Colab Enterprise 會在程式碼儲存格下方列印錯誤訊息。如果 Gemini in Colab Enterprise 有此錯誤的說明，畫面上會顯示「Explain error」按鈕。

    5. 按一下「說明錯誤」按鈕。

      Colab Enterprise 會開啟聊天對話方塊，其中包含錯誤的說明。對話方塊也可能會提供解決問題的最佳化建議和建議變更。

    6. 評估內容後，你可以採取下列任一做法：

      • 如要複製建議變更，請按一下 「複製」按鈕。然後將程式碼貼到筆記本的程式碼儲存格中。
      • 如要在筆記本中新增含有建議變更的程式碼儲存格，請按一下 「Add code cell」按鈕。新增程式碼儲存格不會移除含有錯誤的原始程式碼儲存格。
      • 使用即時通訊對話方塊，與 Gemini 討論錯誤。

    7. 如要關閉即時通訊對話方塊，請按一下 「關閉」。

    修正錯誤

    如要使用 Gemini for Google Cloud 修正程式碼中的語法錯誤，請按照下列步驟操作：

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

      前往「我的筆記本」

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

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

    4. 在筆記本的程式碼儲存格中，輸入含有錯誤的程式碼，然後執行儲存格。例如，您可能會輸入 print(1，但缺少一個右括號。

      程式碼儲存格執行後，Colab Enterprise 會在程式碼儲存格下方列印錯誤訊息。如果 Gemini in Colab Enterprise 有可修正程式碼的建議，系統會顯示「修正錯誤」按鈕。

    5. 按一下「Fix error」按鈕。

      Colab Enterprise 會顯示程式碼的修正建議。

    6. 評估建議，然後採取下列任一做法：

      • 如要接受建議，請按一下「接受建議」圖示 。
      • 如要拒絕建議，請按一下 「拒絕建議」。

    停用 Gemini in Colab Enterprise

    如要為 Google Cloud 專案停用 Gemini in Colab Enterprise，管理員必須停用 Gemini for Google Cloud API。請參閱停用服務。

    如要為特定使用者關閉 Gemini in Colab Enterprise，管理員需要撤銷該使用者的 Gemini for Google Cloud 使用者 (roles/cloudaicompanion.user) 角色。請參閱「撤銷單一 IAM 角色」。

    後續步驟