Instala las bibliotecas cliente de Vertex AI

Las bibliotecas cliente de Vertex AI en el dispositivo de Google Distributed Cloud (GDC) aislado te permiten acceder de forma programática a las APIs de reconocimiento óptico de caracteres (OCR), Speech-to-Text, Vertex AI Translation y Vertex AI Platform desde los lenguajes compatibles sin escribir solicitudes sin procesar al servidor. Extrae e instala una biblioteca cliente directamente desde su archivo tar para tu sistema operativo CentOS o Ubuntu.

Bibliotecas cliente de Vertex AI

Vertex AI ofrece diferentes versiones de bibliotecas cliente para los sistemas operativos CentOS y Ubuntu.

Las convenciones de nombres de las bibliotecas cliente de Vertex AI en el archivo tar se basan en el sistema operativo, el nombre del servicio y la versión. Los nombres de los archivos se ajustan al siguiente formato:

OS-google-cloud-SERVICE-VERSION.tar.gz

Reemplaza lo siguiente:

  • OS: Es el nombre del sistema operativo en el que deseas instalar la biblioteca cliente. Los valores permitidos son centos y ubuntu.

  • SERVICE: Es el nombre del servicio de Vertex AI desde el que deseas descargar la biblioteca cliente. Los siguientes son los valores permitidos:

    • aiplatform: la biblioteca cliente de Vertex AI Platform.
    • speech: la biblioteca cliente de Speech-to-Text.
    • translate: la biblioteca cliente de Vertex AI Translation.
    • vision: la biblioteca cliente de OCR.

  • VERSION: Es el número de versión de la biblioteca cliente, como 3.8.0.

En la siguiente tabla, se incluyen las bibliotecas cliente de Vertex AI que admite el dispositivo aislado de GDC:

Servicio de Vertex AI Sistema operativo Nombre del archivo
OCR Centos centos-google-cloud-vision-3.0.0.tar.gz
Ubuntu ubuntu-google-cloud-vision-3.0.0.tar.gz
Speech-to-Text Centos centos-google-cloud-speech-2.15.0.tar.gz
Ubuntu ubuntu-google-cloud-speech-2.15.0.tar.gz
Vertex AI Translation Centos centos-google-cloud-translate-3.8.0.tar.gz
Ubuntu ubuntu-google-cloud-translate-3.8.0.tar.gz
Vertex AI Platform Centos centos-google-cloud-aiplatform-1.34.0.tar.gz
Ubuntu ubuntu-google-cloud-aiplatform-1.34.0.tar.gz

Antes de comenzar

Antes de descargar el archivo tar y extraer las bibliotecas cliente, sigue estos pasos:

  1. Configura un proyecto para Vertex AI.

  2. Autentícate con la CLI de gdcloud:

    gdcloud auth login

    Para obtener más información sobre cómo autenticar con tu proveedor de identidad configurado, consulta la autenticación de la CLI de gdcloud.

  3. Asigna el rol de visualizador de IA de Cloud (cloud-ai-viewer) a una cuenta de servicio. La cuenta de servicio requiere este rol para acceder a los servicios de Vertex AI.

  4. Verifica que hayas instalado la versión 3.7 de Python.

Instala una biblioteca cliente

Después de completar los requisitos previos, sigue estos pasos para descargar el archivo tar y usarlo para instalar una biblioteca cliente:

  1. Descarga la biblioteca cliente que quieras instalar:

    wget https://GDC_URL/.well-known/static/client-libraries/CLIENT_LIBRARY

    Reemplaza lo siguiente:

    • GDC_URL: Es la URL de tu organización en GDC.
    • CLIENT_LIBRARY: Es el nombre de archivo de la biblioteca cliente que quieres descargar.

  2. Extrae el archivo de la biblioteca:

    tar -zxf CLIENT_LIBRARY

  3. Instala la biblioteca cliente en el dispositivo de GDC aislado:

    pip install -r FOLDER_NAME/requirements.txt --no-index --find-links FOLDER_NAME

    Reemplaza FOLDER_NAME por la ruta de acceso al directorio local en el que descargaste el archivo de la biblioteca.

  4. Importar la biblioteca cliente con una secuencia de comandos de Python En el siguiente ejemplo, se muestra un fragmento de código de una secuencia de comandos de Python que importa la biblioteca cliente de Vertex AI Translation para ilustrar cómo se importan las bibliotecas:

    from google.cloud import translate
translate_client = translate.Client(
 client_options={"API_ENDPOINT": "https://foo-translation.googleapis.com"})
result
= translate_client.translate(text, target_language="ru")

[...]

    Esta muestra de código no está completa. Para realizar una solicitud de Vertex AI Translation, obtén información sobre las funciones de traducción.

  5. Guarda la secuencia de comandos de Python con un nombre, como translation-service.py.

  6. Ejecuta la secuencia de comandos de Python:

    python SCRIPT_NAME

    Reemplaza SCRIPT_NAME por el nombre que le diste a tu secuencia de comandos de Python, como translation-service.py.