在 Gemini 協助下說明及修正錯誤

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

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

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

總覽

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

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

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

事前準備

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

    必要的角色

    如要取得使用 Gemini in Colab Enterprise 所需的權限，請要求管理員將專案的下列 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 可以說明這項錯誤，就會顯示「說明錯誤」按鈕。

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

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

    6. 評估內容後，您可以執行下列任一操作：

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

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

    修正錯誤

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

    1. 在 Google Cloud 控制台中，前往 Colab Enterprise 的「My notebooks」(我的筆記本) 頁面。

      前往「我的筆記本」

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

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

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

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

    5. 按一下「修正錯誤」按鈕。

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

    6. 評估建議，然後執行下列任一操作：

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

    停用 Gemini in Colab Enterprise

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

    如要為特定使用者停用 Gemini in Colab Enterprise，管理員必須撤銷該使用者的「Gemini for Google Cloud 使用者」 (roles/cloudaicompanion.user) 角色。請參閱撤銷單一身分與存取權管理角色。

    後續步驟