Configura un proyecto y un entorno de desarrollo

En esta guía, se describe cómo configurar un Google Cloud proyecto para comenzar a usar Gemini Enterprise Agent Platform Vision.

Configura tu proyecto

  1. Accede a tu Google Cloud cuenta de. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

  2. Instala Google Cloud CLI.

  3. Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

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

    gcloud init

  5. Crea o selecciona un Google Cloud proyecto.

    Roles necesarios para seleccionar o crear un proyecto

    • Selecciona un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
    • Crea un proyecto: Para crear un proyecto, necesitas el rol de creador de proyectos (roles/resourcemanager.projectCreator), que contiene el resourcemanager.projects.create permiso. Obtén información para otorgar roles.

    • Crea un Google Cloud proyecto:

      gcloud projects create PROJECT_ID

      Reemplaza PROJECT_ID por un nombre para el Google Cloud proyecto que estás creando.

    • Selecciona el Google Cloud proyecto que creaste:

      gcloud config set project PROJECT_ID

      Reemplaza PROJECT_ID por el nombre de tu Google Cloud proyecto.

  6. Verifica que la facturación esté habilitada para tu Google Cloud proyecto.

  7. Habilita la API de Vertex AI Vision:

    Roles necesarios para habilitar las APIs

    Para habilitar las APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol Propietario (roles/owner). De lo contrario, puedes obtener este permiso a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén información para otorgar roles. 

    gcloud services enable visionai.googleapis.com

  8. Configura la autenticación:

    1. Asegúrate de tener el rol de IAM de creador de cuentas de servicio (roles/iam.serviceAccountCreator) y el rol de administrador de IAM del proyecto (roles/resourcemanager.projectIamAdmin). Obtén información para otorgar roles.

    2. Crea la cuenta de servicio: 

      gcloud iam service-accounts create SERVICE_ACCOUNT_NAME

      Reemplaza SERVICE_ACCOUNT_NAME por un nombre para la cuenta de servicio.

    3. Otorga el rol de IAM roles/visionai.editor a la cuenta de servicio. 

      gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" --role=roles/visionai.editor

      Reemplaza lo siguiente:

      • SERVICE_ACCOUNT_NAME: el nombre de la cuenta de servicio
      • PROJECT_ID: el ID del proyecto en el que creaste la cuenta de servicio

    4. Genera el archivo de claves: 

      gcloud iam service-accounts keys create FILE_NAME.json --iam-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

      Reemplaza lo siguiente:

      • FILE_NAME: un nombre para el archivo de claves
      • SERVICE_ACCOUNT_NAME: el nombre de la cuenta de servicio
      • PROJECT_ID: el ID del proyecto en el que creaste la cuenta de servicio

  9. Configura la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta del archivo JSON que contiene tus credenciales. Esta variable solo se aplica a la sesión actual de Cloud Shell. Por lo tanto, si abres una sesión nueva, deberás volver a configurar la variable.

  10. Instala Google Cloud CLI.

  11. Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

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

    gcloud init

  13. Crea o selecciona un Google Cloud proyecto.

    Roles necesarios para seleccionar o crear un proyecto

    • Selecciona un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
    • Crea un proyecto: Para crear un proyecto, necesitas el rol de creador de proyectos (roles/resourcemanager.projectCreator), que contiene el resourcemanager.projects.create permiso. Obtén información para otorgar roles.

    • Crea un Google Cloud proyecto:

      gcloud projects create PROJECT_ID

      Reemplaza PROJECT_ID por un nombre para el Google Cloud proyecto que estás creando.

    • Selecciona el Google Cloud proyecto que creaste:

      gcloud config set project PROJECT_ID

      Reemplaza PROJECT_ID por el nombre de tu Google Cloud proyecto.

  14. Verifica que la facturación esté habilitada para tu Google Cloud proyecto.

  15. Habilita la API de Vertex AI Vision:

    Roles necesarios para habilitar las APIs

    Para habilitar las APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol Propietario (roles/owner). De lo contrario, puedes obtener este permiso a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén información para otorgar roles. 

    gcloud services enable visionai.googleapis.com

  16. Configura la autenticación:

    1. Asegúrate de tener el rol de IAM de creador de cuentas de servicio (roles/iam.serviceAccountCreator) y el rol de administrador de IAM del proyecto (roles/resourcemanager.projectIamAdmin). Obtén información para otorgar roles.

    2. Crea la cuenta de servicio: 

      gcloud iam service-accounts create SERVICE_ACCOUNT_NAME

      Reemplaza SERVICE_ACCOUNT_NAME por un nombre para la cuenta de servicio.

    3. Otorga el rol de IAM roles/visionai.editor a la cuenta de servicio. 

      gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" --role=roles/visionai.editor

      Reemplaza lo siguiente:

      • SERVICE_ACCOUNT_NAME: el nombre de la cuenta de servicio
      • PROJECT_ID: el ID del proyecto en el que creaste la cuenta de servicio

    4. Genera el archivo de claves: 

      gcloud iam service-accounts keys create FILE_NAME.json --iam-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

      Reemplaza lo siguiente:

      • FILE_NAME: un nombre para el archivo de claves
      • SERVICE_ACCOUNT_NAME: el nombre de la cuenta de servicio
      • PROJECT_ID: el ID del proyecto en el que creaste la cuenta de servicio

  17. Configura la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta del archivo JSON que contiene tus credenciales. Esta variable solo se aplica a la sesión actual de Cloud Shell. Por lo tanto, si abres una sesión nueva, deberás volver a configurar la variable.

Algunas tareas requieren que uses productos adicionales Google Cloud además de Agent Platform Vision. Es posible que debas realizar tareas de configuración adicionales para usar otros Google Cloud productos.

SDK de Gemini Enterprise Agent Platform Vision

El kit de desarrollo de software (SDK) de Agent Platform Vision contiene herramientas y bibliotecas para que desarrolles programas y flujos de trabajo personalizados con Agent Platform Vision.

Estas herramientas hacen referencia a un conjunto de archivos fuente binarios que ayudan a tu productividad cuando usas o desarrollas soluciones con Agent Platform Vision. También puedes agregar estos archivos fuente binarios a tus secuencias de comandos para ayudar a administrar implementaciones a mayor escala. La interfaz de línea de comandos (CLI) vaictl es un ejemplo en esta categoría.

Las bibliotecas hacen referencia a un conjunto de APIs de programación que puedes usar para administrar, controlar y realizar operaciones de E/S de diferentes formas de manera programática con Agent Platform Vision. La API de programación de C++ es un ejemplo en esta categoría.

El código de las herramientas y las bibliotecas es de código abierto, y les damos la bienvenida a los desarrolladores para que los compilen directamente. En el caso de las herramientas, también ofrecemos archivos binarios compilados previamente en plataformas específicas que puedes descargar para usarlos directamente. También ofrecemos imágenes de Docker para los casos en los que tu plataforma no es compatible directamente.

Requisitos previos

Ten en cuenta estos requisitos previos antes de usar el SDK de Gemini Enterprise Agent Platform Vision.

Plataformas compatibles

Solo admitimos directamente máquinas x86 que ejecutan una distribución de Linux basada en Debian. También ofrecemos una imagen de Docker con herramientas ya compiladas e instaladas si usas una plataforma diferente.

Requisitos de software adicionales

La mayoría de las dependencias de software de terceros que requiere el SDK de Gemini Enterprise Agent Platform Vision se administran automáticamente cuando instalas los objetos binarios compilados previamente. Sin embargo, para usar ciertos aspectos de las funciones y los flujos de trabajo del SDK, debes instalar dependencias adicionales. En esta sección, se enumeran estas excepciones y cómo descargarlas e instalarlas.

Python SDK

El paquete pip de Python instala todas sus dependencias automáticamente. Sin embargo, la instalación básica subyacente de Python debe cumplir con las siguientes condiciones:

  • Python >= 3.8.

Compila dependencias de origen

La mayoría de los usuarios pueden usar los objetos binarios del SDK compilados previamente para su flujo de trabajo. Si deseas desarrollar y compilar el SDK desde la fuente, también debes asegurarte de que tu sistema cumpla con los siguientes requisitos.

  • Instala Bazel. Para obtener instrucciones de instalación, consulta la documentación de Bazel.

  • En Ubuntu 20.04, también necesitas varias dependencias del sistema. Puedes instalarlas con el siguiente comando:

    apt-get install -y --no-install-recommends \
    autoconf \
    automake \
    build-essential \
    ca-certificates \
    flex \
    bison \
    python3 \
    nasm \
    libjpeg-dev

Obtén objetos binarios compilados previamente

La herramienta vaictl es la herramienta binaria lista para usar que se puede usar para controlar Agent Platform Vision, así como para enviar y recibir datos que procesa.

En esta sección, se muestran formas de descargar e instalar esta herramienta.

Instala el paquete de Debian

Tienes dos opciones para usar la herramienta de línea de comandos vaictl, que necesitas para trabajar con E/S (datos de transmisión):

  • Instala la herramienta de línea de comandos de forma local (SO: Debian GNU/Linux, arquitectura de la CPU: x86_64) o
  • Ejecuta los comandos en una imagen de Docker que tenga instaladas todas las dependencias.

Sigue estos pasos para obtener la herramienta de línea de comandos vaictl:

Descarga el paquete

Para las instalaciones directas, solo admitimos distribuciones de Debian/Ubuntu.

También puedes descargar este paquete de Debian desde la página de versiones de GitHub del SDK de Gemini Enterprise Agent Platform Vision.

  1. (Opcional) Quita las versiones anteriores de vaictl.

    Antes de que puedas instalar la herramienta de línea de comandos vaictl, debes borrar cualquier versión anterior de la herramienta en tu máquina:

    sudo apt-get remove visionai
  2. Descarga el paquete requerido. Puedes descargar el paquete desde la página de versiones de GitHub, o usar el siguiente comando: 
    wget https://github.com/google/visionai/releases/download/v0.0.5/visionai_0.0-5_amd64.deb
  3. Después de descargar el paquete, ejecuta el siguiente comando en el directorio en el que descargaste el archivo: 
    sudo apt install ./visionai_0.0-5_amd64.deb
  4. Verifica la instalación: 
    vaictl --help

Obtén Docker

Puedes obtener una imagen de Docker que tenga el SDK de Gemini Enterprise Agent Platform Vision y todas sus dependencias ya instaladas previamente. Esta imagen de Docker está disponible en gcr.io/visionai-public-images/vaictl.

  1. Descarga la imagen de Container Registry: 
    docker pull gcr.io/visionai-public-images/vaictl
  2. Ejecuta una terminal de contenedor interactiva. 
    docker run -it --rm gcr.io/visionai-public-images/vaictl /bin/bash
  3. Verifica la funcionalidad: 
    vaictl --help

Obtén el código fuente

El SDK de Gemini Enterprise Agent Platform Vision es de código abierto y está disponible públicamente en GitHub.

Si bien el SDK depende de las definiciones de la API de servicio, esta dependencia ya está administrada automáticamente por Bazel y no necesitas adquirirla de forma explícita. Sin embargo, si necesitas acceso directo a las APIs de servicio, puedes obtenerlas en el googleapis repositorio de GitHub.

El SDK de programación de Python

Agent Platform Vision también admite un SDK de Python. Para programar con este SDK, asegúrate de haber cumplido con las dependencias básicas del SDK de Python antes de instalar el SDK de Python.

Para obtener información de referencia del SDK, consulta la referencia del SDK de Python.

Para ver códigos de ejemplo que usan el SDK de Python, consulta el instructivo Desenfoque de rostros con el SDK de Python, o consulta algunos ejemplos en la distribución de origen en el visionai/python/examples/ directorio.

Obtén el paquete del SDK de Python

El SDK de Gemini Enterprise Agent Platform Vision también contiene una biblioteca de Python. Descarga e instala la versión compilada previamente del SDK de Python con las siguientes instrucciones.

  1. Descarga el paquete.

    Puedes descargar el paquete del SDK de Python desde la página de versiones de GitHub del SDK de Gemini Enterprise Agent Platform Vision, o puedes ejecutar el comando:

    wget https://github.com/google/visionai/releases/download/v0.0.5/visionai-0.0.5-py3-none-any.whl

  2. Es opcional. Crea y activa un entorno virtual nuevo:

    python3 -m venv vaivenv
source vaivenv/bin/activate

  3. Instala el paquete:

    pip3 install visionai-0.0.5-py3-none-any.whl

  4. Es opcional. Confirma que la instalación funcionó:

    python3

    import visionai

  5. Es opcional. Desactiva tu entorno virtual:

    deactivate

El SDK de programación de C++

C++ es el primer SDK de programación que admitimos. El SDK público de C++ se encuentra en visionai/public/streams.h. Para obtener información de referencia, consulta la documentación de referencia.

¿Qué sigue?

Anterior
Guía de inicio rápido: Compila una app en la consola