Configurar um projeto e um ambiente de desenvolvimento

Para começar a usar a Vertex AI, esta página mostra como criar um projeto do Google Cloud e ativar as APIs da Vertex AI. Se você não tiver permissões para executar essas tarefas, peça a um administrador para configurar um projeto e ativar a Vertex AI para você. Nesta página, também mostramos como configurar a CLI do Google Cloud no seu ambiente de desenvolvimento local.

Configurar um projeto

Siga estas etapas para configurar um projeto:

  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.

Configurar a autenticação

    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. Para configurar a CLI da gcloud para usar a representação da conta de serviço para autenticação nas APIs do Google, em vez de suas credenciais de usuário, execute o seguinte comando: 

    gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

    Para mais informações, consulte Identidade temporária de conta de serviço.

    Bibliotecas de cliente

    Para usar bibliotecas de cliente em um ambiente de desenvolvimento local, instale e inicialize o gcloud CLI e configure o Application Default Credentials com suas credenciais de usuário.

    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.

    Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local na documentação de autenticação do Google Cloud.

    Para configurar o arquivo ADC local para usar a identidade temporária de conta de serviço para autenticação nas APIs do Google, em vez de suas credenciais de usuário, execute o seguinte comando: 

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

    Para mais informações, consulte Identidade temporária de conta de serviço.

    REST

    Para usar a API REST em um ambiente de desenvolvimento local, use as credenciais fornecidas para a 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

    Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.

    É possível usar a representação de conta de serviço para gerar um token de acesso para solicitações da API REST.identidade temporária de conta de serviço Para mais informações, consulte Conta de serviço representada.

    Para informações sobre como configurar a autenticação para um ambiente de produção, consulte Set up Application Default Credentials for code running on Google Cloud na documentação de autenticação do Google Cloud.

Pedir a um administrador para configurar um projeto da Vertex AI para você

Nesta seção, descrevemos como um administrador concede os papéis necessários para usar a Vertex AI.

  1. Determine um nome e ID de projeto significativos para facilitar a identificação. Se você faz parte de uma organização ou planeja criar vários projetos, considere quais convenções de nomenclatura e hierarquias de pasta são seguidas ou podem ser seguidas, para deixar a organização do projeto clara.
  2. Papéis necessários:
    1. O acesso à maioria dos recursos da Vertex AI é concedido pelo papel do IAM Usuário da Vertex AI (roles/aiplatform.user) e é suficiente para a maioria dos usuários da Vertex AI. Para ter controle total dos recursos da Vertex AI, solicite o papel (roles/aiplatform.admin) Administrador da Vertex AI. Para entender as diferenças entre esses e outros papéis da Vertex AI, consulte Controle de acesso da Vertex AI com IAM.
    2. Se você também pretende usar instâncias do Vertex AI Workbench no Google Cloud, peça ao administrador para conceder a você o papel do IAM Administrador de notebooks (roles/notebooks.admin) no projeto, bem como o papel do IAM Usuário da conta de serviço (roles/iam.serviceAccountUser) no projeto ou na conta de serviço padrão do Compute Engine.
    3. Além disso, para ativar as APIs necessárias, você precisa do papel do IAM de Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin) ou seu administrador precisa ativar as APIs para você, seguindo as primeiras etapas.
  3. Peça para o administrador ativar as APIs Vertex AI para você. Se você recebeu o papel do IAM de Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin), poderá fazer isso por conta própria.

A seguir