在 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 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 角色:

    如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限

    您也可以通过自定义角色或其他预定义角色来获取所需的权限。

    使用错误说明

    如需使用 Gemini Google Cloud 解释代码中的错误,请执行以下操作:

    1. 在 Google Cloud 控制台中,前往 Colab Enterprise 我的笔记本页面。

      前往我的笔记本

    2. 区域菜单中,选择包含笔记本的区域。

    3. 点击要打开的笔记本。

    4. 在笔记本的代码单元中,输入包含错误的代码,然后运行该单元。例如,您可能会输入 print(a + random()),而不定义 a

      代码单元运行后,Colab Enterprise 会在代码单元下方输出一条错误消息。如果 Gemini in Colab Enterprise 可以解释此错误,则会显示解释错误按钮。

    5. 点击说明错误按钮。

      Colab Enterprise 会打开一个聊天对话框,其中包含对错误的说明。该对话框可能还会包含有关如何解决问题的建议和建议的更改。

    6. 评估内容后,您可以执行以下任一操作:

      • 如需复制建议的更改,请点击 复制按钮。然后,将代码粘贴到笔记本的代码单元中。
      • 如需向笔记本添加包含建议更改的代码单元,请点击 添加代码单元按钮。添加代码单元格不会移除包含错误的原始代码单元格。
      • 使用对话框与 Gemini 讨论错误。
    7. 如需关闭聊天对话框,请点击  关闭

    修正错误

    如需使用 Gemini for Google Cloud 帮助您修正代码中的语法错误,请执行以下操作:

    1. 在 Google Cloud 控制台中,前往 Colab Enterprise 我的笔记本页面。

      前往我的笔记本

    2. 区域菜单中,选择包含笔记本的区域。

    3. 点击要打开的笔记本。

    4. 在笔记本的代码单元中,输入包含错误的代码,然后运行该单元。例如,您可能会输入 print(1, 但缺少右括号。

      代码单元运行后,Colab Enterprise 会在代码单元下方输出一条错误消息。如果 Gemini in Colab Enterprise 有可能修复代码的建议,系统会显示修复错误按钮。

    5. 点击修复错误按钮。

      Colab Enterprise 会向您显示建议的代码修复。

    6. 评估建议,然后执行以下某项操作:

      • 如需接受建议,请点击 接受建议
      • 如需拒绝建议,请点击  拒绝建议

    停用 Gemini in Colab Enterprise

    如需为 Google Cloud 项目停用 Colab Enterprise 中的 Gemini,管理员必须停用 Gemini for Google Cloud API。请参阅停用服务

    如需为特定用户停用 Colab Enterprise 中的 Gemini,管理员需要撤消该用户的 Gemini for Google Cloud User (roles/cloudaicompanion.user) 角色。请参阅撤消单个 IAM 角色

    后续步骤