Configura un proyecto y un entorno de desarrollo

Para comenzar a usar Vertex AI, en esta página se te guiará a través de la creación de un proyecto de Google Cloud y la habilitación de las APIs de Vertex AI. Si no tienes los permisos para realizar estas tareas, pídele a un administrador que configure un proyecto y habilite Vertex AI por ti. También se describe en esta página cómo configurar Google Cloud CLI en el entorno de desarrollo local.

Configura un proyecto

Sigue estos pasos para configurar un proyecto:

  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.

Configura la autenticación

    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. A fin de configurar la CLI de gcloud para usar la identidad temporal como cuenta de servicio y autenticarse en las APIs de Google, en lugar de tus credenciales de usuario, ejecuta el siguiente comando: 

    gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

    Para obtener más información, consulta Identidad temporal como cuenta de servicio.

    Bibliotecas cliente

    Para usar bibliotecas cliente en un entorno de desarrollo local, instala e inicializa gcloud CLI y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

    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.

    Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local en la documentación de autenticación de Google Cloud.

    Si deseas configurar tu archivo ADC local para usar la identidad temporal como cuenta de servicio a fin de autenticarte en las APIs de Google, en lugar de tus credenciales de usuario, ejecuta el siguiente comando: 

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

    Para obtener más información, consulta Identidad temporal como cuenta de servicio.

    REST

    Para usar la API de REST en un entorno de desarrollo local, debes usar las credenciales que proporcionas 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

    Si deseas obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud.

    Puedes usar la identidad temporal como cuenta de servicio a fin de generar un token de acceso para solicitudes de la API de REST. Para obtener más información, consulta Cuenta de servicio con identidad temporal.

    Si deseas obtener información sobre cómo configurar la autenticación para un entorno de producción, consulta Set up Application Default Credentials for code running on Google Cloud en la documentación de autenticación de Google Cloud.

Pídele a un administrador que configure un proyecto de Vertex AI

En esta sección, se describe cómo un administrador otorga los roles necesarios para usar Vertex AI.

  1. Determina el nombre del proyecto y el ID del proyecto para identificarlo. Si eres parte de una organización o planeas crear varios proyectos, ten en cuenta qué convenciones de nombres y jerarquías de carpetas se siguen, o se podrían seguir, para dejar en claro la organización del proyecto.
  2. Roles necesarios:
    1. El acceso a la mayoría de las capacidades de Vertex AI se otorga mediante el rol de IAM Usuario de Vertex AI (roles/aiplatform.user) y debería ser suficiente para la mayoría de los usuarios de Vertex AI. Para obtener un control total de los recursos de Vertex AI, puedes solicitar el rol Administrador de Vertex AI (roles/aiplatform.admin). Para explorar las diferencias entre estos y otros roles de Vertex AI, consulta Control de acceso de Vertex AI con IAM.
    2. Si también deseas usar instancias de Vertex AI Workbench en Google Cloud, pídele a tu administrador que te otorgue el rol de IAM Administrador de notebooks (roles/notebooks.admin) para el proyecto, así como el rol de IAM Usuario de la cuenta de servicio (roles/iam.serviceAccountUser) en el proyecto o la cuenta de servicio predeterminada de Compute Engine.
    3. Además, para habilitar las APIs necesarias, debes tener el rol de IAM Administrador de Service Usage (roles/serviceusage.serviceUsageAdmin) o tu administrador debe habilitar las APIs por ti siguiendo los primeros pasos.
  3. Pídele al administrador que habilite las APIs de Vertex AI por ti. Si se te otorga el rol de IAM Administrador de Service Usage, (roles/serviceusage.serviceUsageAdmin), podrás hacerlo por tu cuenta.

¿Qué sigue?