安装 Data Agent Kit

借助 Google Cloud Data Agent Kit，您可以在自己偏好的 IDE 或智能体编码环境中处理 Google Cloud 数据资源。根据您的设置，您可以安装 IDE 扩展程序或插件。

Data Agent Kit 预安装了以下 Google Cloud服务：

  • Cloud Shell
  • Cloud Workstations

准备工作

在安装 Data Agent Kit 之前，请执行以下操作。

设置本地环境

在本地机器上，安装您偏好的 IDE 或编程智能体以及 Node.js。

  1. 安装并设置 IDE、agentic CLI 或编码智能体。如果已安装，请将其更新到最新版本。
  2. 安装 Node.js。

设置 Google Cloud

  1. 如果您还没有 Google Cloud 项目，请创建一个。
  2. 启用结算功能。

所需的角色

Data Agent Kit 会在您需要额外权限才能完成任务时通知您。您只需获得所用服务的权限。 如需查看数据代理工具包中每个服务所需的权限和 API 的完整列表，请参阅权限。

安装扩展程序或插件

安装过程取决于您使用的 IDE 或编码代理。

VS Code

如需在 VS Code 中使用 Data Agent Kit，请安装该扩展程序：

  1. 在 IDE 中，点击扩展程序或按 Ctrl/Cmd+Shift+X。
  2. 搜索 Google Cloud Data Agent Kit。
  3. 点击安装。
  4. 如果系统提示，请重启 IDE。扩展程序成功安装后，Google Cloud Data Agent Kit 图标会添加到活动栏中。

您还可以从 Visual Studio Marketplace 安装该扩展程序。

Antigravity

点击即可展开您所用 Antigravity 工具的说明。

Antigravity IDE

如需在 Antigravity IDE 中使用 Data Agent Kit，请安装该扩展程序。

  1. 在 IDE 中，点击扩展程序或按 Ctrl/Cmd+Shift+X。
  2. 搜索 Google Cloud Data Agent Kit。
  3. 点击安装。
  4. 如果系统提示，请重启 IDE。扩展程序成功安装后，Google Cloud Data Agent Kit 图标会添加到活动栏中。

Antigravity CLI

如需将 Data Agent Kit 与 Antigravity CLI 搭配使用，请安装相应插件。在终端中，运行以下命令：

agy plugin install https://github.com/GoogleCloudPlatform/data-agent-kit-plugin

Antigravity 2.0

如需将 Data Agent Kit 与 Antigravity CLI 搭配使用，请安装相应插件。

  1. 点击设置。
  2. 在设置窗格中，点击自定义。
  3. 找到 Build with Google 插件，然后点击自定义。
  4. 在列表中找到 Google Cloud Data Agent Kit，然后点击下载。

适用于 VS Code 的 Antigravity 扩展程序

如需在使用 Antigravity for VS Code 扩展程序时在 VS Code 中使用 Data Agent Kit，请执行以下操作：

  1. 在 VS Code 状态栏中，点击 Antigravity - Settings。
  2. 在设置窗格中，点击自定义。
  3. 找到 Build with Google 插件，然后点击自定义。
  4. 在列表中找到 Google Cloud Data Agent Kit，然后点击下载。

Claude Code CLI

如需将 Data Agent Kit 与 Claude Code CLI 搭配使用，请安装该插件。在终端中运行以下命令：

claude plugin install data-agent-kit-starter-pack@claude-plugins-official

Codex CLI

如需将 Data Agent Kit 与 Codex CLI 搭配使用，请安装相应插件。在终端中运行以下命令：

codex plugin marketplace aadd GoogleCloudPlatform/data-agent-kit-plugin
codex plugin add dak@dak-marketplace

光标

如需在 Cursor 中使用 Data Agent Kit，请安装该扩展程序。

  1. 在 IDE 中，点击扩展程序或按 Ctrl/Cmd+Shift+X。
  2. 搜索 Google Cloud Data Agent Kit。
  3. 点击安装。
  4. 如果系统提示，请重启 IDE。扩展程序成功安装后，Google Cloud Data Agent Kit 图标会添加到活动栏中。

基于 VS Code 的 IDE

如需在所有其他基于 VS Code 的 IDE 中使用 Data Agent Kit，请安装该扩展程序。

  1. 在 IDE 中，点击扩展程序或按 Ctrl/Cmd+Shift+X。
  2. 搜索 Google Cloud Data Agent Kit。
  3. 点击安装。
  4. 如果系统提示，请重启 IDE。扩展程序成功安装后，Google Cloud Data Agent Kit 图标会添加到活动栏中。

登录 Data Agent Kit

安装扩展程序或插件后，您必须登录。

扩展程序登录

如果您安装了 IDE 扩展程序，则必须向 Google Cloud Data Agent Kit 进行身份验证。

  1. 如果登录对话框未自动打开，请在 IDE 窗口底部的状态栏中查找 Google Cloud Data Agent Kit 登录链接，然后点击该链接。

    或者，您也可以按 Ctrl/Cmd+Shift+P 打开命令面板，然后搜索并选择 Google Cloud Data Agent Kit：登录。

  2. 按照提示完成登录。

    系统会显示一个网页，确认身份验证已完成。

  3. 关闭该页面，然后返回到 IDE。

插件登录

安装并登录 Google Cloud CLI。Data Agent Kit 插件同时使用 gcloud CLI 凭据和应用默认凭据 (ADC) 中的凭据。

  1. 在本地机器上或 IDE 中打开终端。
  2. 如果您之前未安装 gcloud CLI，请按照安装 gcloud CLI 中的步骤下载并安装 gcloud CLI。
  3. 在终端中，运行 gcloud init 以初始化 gcloud CLI： 
    gcloud init
  4. 运行以下命令，然后按照提示进行身份验证并设置应用默认凭证： 
    gcloud auth login && gcloud auth application-default login
  5. 将 gcloud CLI 更新到最新版本： 
    gcloud components update

问题排查

如果您遇到问题，请尝试退出账号，然后重新登录。如需查找诊断和解决安装错误的其他方法，请参阅问题排查。

后续步骤