Configura un proyecto y un entorno de desarrollo

Para ayudarte a comenzar a usar Gemini Enterprise Agent Platform, en esta página, se explica cómo crear un Cloud de Confiance by S3NS proyecto y habilitar las APIs de Agent Platform. Si no tienes los permisos para realizar estas tareas, pídele a un administrador que configure un proyecto y habilite Gemini Enterprise Agent Platform 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. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance 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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Cloud de Confiance project.

  3. Enable the Gemini Enterprise Agent Platform API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

Configura la autenticación

    Selecciona las pestañas según cómo planeas acceder a la API:

    Console

    Cuando usas la consola de Cloud de Confiance para acceder a los servicios y las APIs de Cloud de Confiance by S3NS , no necesitas configurar la autenticación.

    gcloud

    1. Instala Google Cloud CLI.

    2. Configura gcloud CLI para usar tu identidad federada.

      Para obtener más información, consulta Accede a la gcloud CLI con tu identidad federada.

    3. Para inicializar gcloud CLI, ejecuta el siguiente comando: 

      gcloud init

    4. Después de inicializar gcloud CLI, actualízala y, luego, instala los componentes necesarios: 

      gcloud components update
gcloud components install beta

    Para configurar la gcloud CLI con el objetivo de usar la identidad temporal como cuenta de servicio y autenticarte en las APIs de Google, en lugar de tus credenciales de usuario, ejecuta el comando siguiente: 

    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 la gcloud CLI y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

    1. Instala Google Cloud CLI.

    2. Configura gcloud CLI para usar tu identidad federada.

      Para obtener más información, consulta Accede a la gcloud CLI con tu identidad federada.

    3. Después de inicializar gcloud CLI, actualízala y, luego, instala los componentes necesarios: 

      gcloud components update
gcloud components install beta

    4. Crea credenciales de autenticación locales para tu cuenta de usuario: 

      gcloud auth application-default login

      Si se devuelve un error de autenticación, confirma que accediste a la gcloud CLI con tu identidad federada.

    Para obtener más información, consulta Configura ADC para un entorno de desarrollo local en la documentación de autenticación de Cloud de Confiance .

    Para configurar tu archivo ADC local con el objetivo de usar la identidad temporal como cuenta de servicio y 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 proporciones a la gcloud CLI.

    1. Instala Google Cloud CLI.

    2. Configura gcloud CLI para usar tu identidad federada.

      Para obtener más información, consulta Accede a la gcloud CLI con tu identidad federada.

    3. Después de inicializar gcloud CLI, actualízala y, luego, instala los componentes necesarios: 

      gcloud components update
gcloud components install beta

    Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Cloud de Confiance .

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

    Para obtener información sobre cómo configurar la autenticación para un entorno de producción, consulta Configura las credenciales predeterminadas de la aplicación para el código que se ejecuta en Cloud de Confiance en la documentación de autenticación de Cloud de Confiance .

Pídele a un administrador que configure un proyecto de Gemini Enterprise Agent Platform para ti

En esta sección, se describe cómo un administrador otorga los roles necesarios para usar Gemini Enterprise Agent Platform.

  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 Gemini Enterprise Agent Platform se otorga a través del rol de IAM Usuario de Gemini Enterprise Agent Platform (roles/aiplatform.user) y debería ser suficiente para la mayoría de los usuarios de Gemini Enterprise Agent Platform. Para obtener un control total de los recursos de Gemini Enterprise Agent Platform, puedes solicitar el rol Administrador de Gemini Enterprise Agent Platform (roles/aiplatform.admin). Para explorar las diferencias entre estos y otros roles de Gemini Enterprise Agent Platform, consulta Control de acceso de Gemini Enterprise Agent Platform con IAM.
    2. Si también planeas usar instancias de la estación de trabajo de Agent Platform de Gemini Enterprise en Cloud de Confiance by S3NS, pídele a tu administrador que te otorgue el rol de IAM de administrador de Notebooks (roles/notebooks.admin) para el proyecto, así como el rol de IAM de usuario de cuenta de servicio (roles/iam.serviceAccountUser) para 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 a tu administrador que habilite las APIs de Agent Platform 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?