设置项目和开发环境

为帮助您开始使用 Vertex AI，本页将引导您完成如何创建 Google Cloud 项目并启用 Vertex AI API 的操作。如果您没有执行这些任务的权限，请让管理员为您设置项目并启用 Vertex AI。本页还介绍了如何在本地开发环境中设置 Google Cloud CLI。

设置项目

如需设置项目，请按以下步骤操作：

  1. 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.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI API.

    Enable the API

    5.

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI API.

    Enable the API

    8.

设置身份验证

    Select the tabs for how you plan to access the API:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

  1. Install the Google Cloud CLI.

  2. To initialize the gcloud CLI, run the following command: 

    gcloud init

  3. Update and install gcloud components:

    gcloud components update
    gcloud components install beta

    4. 如需设置 gcloud CLI 以使用服务账号模拟（而不是您的用户凭据）向 Google API 进行身份验证，请运行以下命令： 

    gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

    如需了解详情，请参阅服务账号模拟。

    客户端库

    如需在本地开发环境中使用客户端库，请安装并初始化 gcloud CLI，然后使用您的用户凭据设置应用默认凭据。

    1. Install the Google Cloud CLI.

    2. To initialize the gcloud CLI, run the following command: 

      gcloud init

    3. Update and install gcloud components:

      gcloud components update
      gcloud components install beta

    4. If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

    如需了解详情，请参阅 Google Cloud 身份验证文档中的 为本地开发环境设置 ADC。

    如需设置本地 ADC 文件以使用服务账号模拟（而不是您的用户凭据）向 Google API 进行身份验证，请运行以下命令： 

    gcloud auth application-default login --impersonate-service-account=SERVICE_ACCT_EMAIL

    如需了解详情，请参阅服务账号模拟。

    REST

    如需在本地开发环境中使用 REST API，请使用您提供给 gcloud CLI 的凭据。

    1. Install the Google Cloud CLI.

    2. To initialize the gcloud CLI, run the following command: 

      gcloud init

    3. Update and install gcloud components:

      gcloud components update
      gcloud components install beta

    如需了解详情，请参阅 Google Cloud 身份验证文档中的使用 REST 时进行身份验证。

    您可以使用服务账号模拟为 REST API 请求生成访问令牌。如需了解详情，请参阅模拟的服务账号。

    如需了解如何为生产环设置身份验证，请参阅 Google Cloud 身份验证文档中的 Set up Application Default Credentials for code running on Google Cloud。

让管理员为您设置 Vertex AI 项目

本部分介绍了管理员如何授予使用 Vertex AI 所需的角色。

  1. 确定一个有意义的项目名称和项目 ID 来标识您的项目。 如果您属于某个组织或计划创建多个项目，请考虑需遵循或可以遵循哪些命名惯例和文件夹层次结构，以使项目组织清晰。
  2. 所需的角色：
    1. 大多数 Vertex AI 功能的访问权限由 Vertex AI User (roles/aiplatform.user) IAM 角色授予，并且应足以满足大多数 Vertex AI 用户的需求。如需完全控制 Vertex AI 资源，您可以请求 Vertex AI Administrator (roles/aiplatform.admin) 角色。如需了解这些角色与其他 Vertex AI 角色之间的区别，请参阅使用 IAM 进行 Vertex AI 访问权限控制。
    2. 如果您还打算在 Google Cloud 中使用 Vertex AI Workbench 实例，请让您的管理员为您授予项目的 Notebooks Administrator (roles/notebooks.admin) IAM 角色，以及项目或 Compute Engine 默认服务账号的 Service Account User (roles/iam.serviceAccountUser) IAM 角色。
    3. 此外，如需启用必要的 API，您需要 Service Usage Admin (roles/serviceusage.serviceUsageAdmin) IAM 角色，或者您的管理员需要按照前几个步骤为您启用 API。
  3. 让您的管理员为您启用 Vertex AI API。如果您已获得 Service Usage Admin (roles/serviceusage.serviceUsageAdmin) IAM 角色，则将能够自行执行此操作。

后续步骤