设置和配置设置

本文档介绍了在安装 Google Cloud Data Agent Kit IDE 扩展程序后如何配置初始设置。

准备工作

在开始之前，请完成安装 Data Agent Kit 中的步骤，包括选择要使用的服务。在您选择某个服务之前，Google Cloud 数据代理工具包菜单中未选择的服务的相应部分会显示集成未启用。

配置 Google Cloud 项目和区域

如果您尚未配置项目和区域，请按以下步骤操作。

  1. 如需打开 Data Cloud 设置编辑器，请点击活动栏中的 Google Cloud Data Agent Kit 图标。
  2. 展开设置，然后点击设置。
  3. 选择通用。
  4. 选择项目 ID 和区域。项目 ID 必须与您在 gcloud CLI 中指定的项目 ID 一致。
  5. 点击保存。

查看所需角色

当您选择要使用的服务时，Data Agent Kit 会检查您的 Identity and Access Management (IAM) 角色。

  1. 如需打开 Data Cloud 设置编辑器，请点击活动栏中的 Google Cloud Data Agent Kit 图标。
  2. 展开设置，然后点击设置。
  3. 点击服务集成。

  4. 选择要使用的服务，然后点击下一步。

    如果您缺少任何必需的角色或 API，系统会打开缺少权限页面。其中列出了每个所选服务的建议 IAM 权限以及必须启用的 API。

  5. 如需获取使用 Data Agent Kit 所需的任何缺失权限，请点击电子邮件列表以将列表发送给您的管理员，或点击复制列表。请让您的管理员为您授予项目的相应 IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

配置 BigQuery 区域

  1. 如需打开 Data Cloud 设置编辑器，请点击活动栏中的 Google Cloud Data Agent Kit 图标。
  2. 展开设置，然后点击设置。
  3. 选择 BigQuery。
  4. 选择 BigQuery 区域。
  5. 点击保存。

查看 Serverless 运行时（适用于 Apache Spark）

  1. 如需打开 Data Cloud 设置编辑器，请点击活动栏中的 Google Cloud Data Agent Kit 图标。
  2. 展开设置，然后点击设置。
  3. 选择 Apache Spark。系统会显示项目的所有无服务器运行时。
  4. 如需查看无服务器运行时配置，请点击其名称。

创建 Serverless Runtime for Apache Spark

  1. 如需打开 Data Cloud 设置编辑器，请点击活动栏中的 Google Cloud Data Agent Kit 图标。
  2. 展开设置，然后点击设置。
  3. 选择 Apache Spark。
  4. 点击创建。
  5. 填写相应字段，然后点击保存。

删除 Serverless Runtime for Apache Spark

  1. 如需打开 Data Cloud 设置编辑器，请点击活动栏中的 Google Cloud Data Agent Kit 图标。
  2. 展开设置，然后点击设置。
  3. 选择 Apache Spark。
  4. 对于要删除的无服务器运行时，请点击删除。

设置调度器

  1. 如需打开 Google Cloud Data Agent Kit 设置编辑器，请点击活动栏中的 Google Cloud Data Agent Kit 图标。
  2. 展开设置，然后点击设置。
  3. 点击 Scheduler。
  4. 选择项目和区域。项目和区域不必与您在“常规”标签页上选择的项目和区域一致。
  5. 选择一个 Managed Service for Apache Airflow 环境来设置工作流。
  6. 点击保存。

安装依赖项

某些 Google Cloud Data Agent Kit 操作需要在安装扩展程序后安装其他软件。在某些情况下，系统会提示您同意自动安装。在其他情况下，您必须手动安装软件。

Orchestration Pipelines

如需在 IDE 中使用 Orchestration Pipelines，请安装以下内容：

笔记本

Google Cloud Data Agent Kit 生成的 Notebooks 包含一个已注释掉的 %pip install --upgrade bigframes 代码单元。如果您的内核中未安装 BigQuery DataFrames，请取消注释并运行该单元格，然后再运行笔记本的其余部分。

如需允许代理执行笔记本中的代码单元格，您可以在 IDE 设置中启用 google.datacloud.executeCellToolForNotebookMCP 设置。 此设置可为 Notebook Model Context Protocol (MCP) 启用 execute_cell 工具。

问题排查

如果您遇到问题，请尝试退出 Google Cloud Data Agent Kit 和 gcloud CLI，然后重新登录。如需查找诊断和解决配置错误的其他方法，请参阅排查数据代理工具包问题。

报告问题

如需报告问题，请执行以下操作：

  1. 在活动栏的“Google Cloud Data Agent Kit”菜单中，点击报告 bug。
  2. 在随即打开的表单中，记录问题，然后点击提交。

后续步骤