设置项目和开发环境

为帮助您开始使用 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.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

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

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    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. 如果您使用的是外部身份提供方 (IdP)，则必须先使用联合身份登录 gcloud CLI。

      3. 如需初始化 gcloud CLI，请运行以下命令： 

        gcloud init

      4. 初始化 gcloud CLI 后，对其进行更新并安装所需组件： 

        gcloud components update
gcloud components install beta

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

        gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

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

        客户端库

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

        1. Install the Google Cloud CLI.

        2. 如果您使用的是外部身份提供方 (IdP)，则必须先使用联合身份登录 gcloud CLI。

        3. 初始化 gcloud CLI 后，对其进行更新并安装所需组件： 

          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.

          If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

        Google Cloud

        如需设置本地 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. 如果您使用的是外部身份提供方 (IdP)，则必须先使用联合身份登录 gcloud CLI。

        3. 初始化 gcloud CLI 后，对其进行更新并安装所需组件： 

          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 角色，则将能够自行执行此操作。

        后续步骤