Instale as bibliotecas cliente da Vertex AI

Esta página orienta-o na instalação das bibliotecas de clientes do Vertex AI para o Google Distributed Cloud (GDC) air-gapped, que lhe permitem interagir com vários serviços do Vertex AI a partir da sua aplicação e ambiente de desenvolvimento. Pode saber mais sobre os tipos de bibliotecas de clientes disponíveis para as APIs do Vertex AI e os passos para as instalar a partir do ficheiro tar.

Esta página destina-se a programadores de aplicações em grupos de operadores de aplicações responsáveis por configurar os respetivos ambientes de aplicações e desenvolvimento para ativar as funcionalidades de IA. Para mais informações, consulte o artigo Públicos-alvo para a documentação do GDC air-gapped.

Cada serviço do Vertex AI fornece uma API. Embora possa interagir diretamente com estas APIs através de pedidos de servidores não processados, as bibliotecas de clientes simplificam o acesso programático a partir de linguagens compatíveis no Distributed Cloud. Reduzem o código necessário, especialmente quando trabalha em ambientes como um bloco de notas do JupyterLab.

Pode instalar uma biblioteca de clientes do Vertex AI através destes métodos:

  • Extraia o ficheiro da biblioteca diretamente do ficheiro tar.
  • Use um bloco de notas do JupyterLab para importar a biblioteca.
  • Importe uma biblioteca de clientes a partir de um bloco de notas. Para mais informações, consulte o artigo Faça a gestão de blocos de notas.

Bibliotecas de clientes do Vertex AI

O Vertex AI oferece diferentes versões de bibliotecas de clientes para os sistemas operativos CentOS e Ubuntu.

As convenções de nomenclatura das bibliotecas de clientes do Vertex AI no ficheiro tar baseiam-se no sistema operativo, no nome do serviço e na versão. Os nomes dos ficheiros seguem o seguinte formato:

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

Substitua o seguinte:

  • OS: o nome do sistema operativo onde quer instalar a biblioteca de clientes. Os valores permitidos são centos e ubuntu.

  • SERVICE: o nome do serviço do Vertex AI a partir do qual quer transferir a biblioteca de clientes. Seguem-se os valores permitidos:

    • aiplatform: a biblioteca de clientes do Vertex AI Platform.
    • speech: a biblioteca de clientes do Speech-to-Text.
    • translate: a biblioteca de clientes do Vertex AI Translation.
    • vision: a biblioteca de clientes de OCR.

  • VERSION: o número da versão da biblioteca de clientes, como 3.8.0.

A tabela seguinte contém as bibliotecas de clientes do Vertex AI que o Distributed Cloud suporta:

Serviço do Vertex AI Sistema operativo Nome do ficheiro
OCR Centos centos-google-cloud-vision-3.0.0.tar.gz
Ubuntu ubuntu-google-cloud-vision-3.0.0.tar.gz
Conversão de voz em texto 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 começar

Antes de transferir o ficheiro tar e extrair as bibliotecas de clientes, siga estes passos:

  1. Configure um projeto para o Vertex AI.

  2. Autentique com a CLI gdcloud:

    gdcloud auth login

    Para mais informações sobre como autenticar com o seu fornecedor de identidade, consulte o artigo Autenticação da CLI gdcloud.

  3. Valide se instalou a versão 3.7 do Python.

Instale uma biblioteca de clientes

Depois de concluir os pré-requisitos, siga estes passos para transferir o ficheiro tar e usá-lo para instalar uma biblioteca de clientes:

  1. Transfira a biblioteca de clientes que quer instalar:

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

    Substitua o seguinte:

    • GDC_URL: o URL da consola do GDC para a sua organização.
    • CLIENT_LIBRARY: o nome do ficheiro da biblioteca de clientes que quer transferir.

  2. Extraia o ficheiro da biblioteca:

    tar -zxf CLIENT_LIBRARY

  3. Instale a biblioteca de clientes no Distributed Cloud:

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

    Substitua FOLDER_NAME pelo caminho para o diretório local onde transferiu o ficheiro da biblioteca.

  4. Importe a biblioteca de clientes através de um script Python. O exemplo seguinte mostra um fragmento de código de um script Python que importa a biblioteca de clientes do Vertex AI Translation para ilustrar o aspeto da importação de 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")

[...]

  5. Guarde o script Python com um nome, como translation-service.py.

  6. Execute o script Python:

    python SCRIPT_NAME

    Substitua SCRIPT_NAME pelo nome que atribuiu ao seu script Python, como translation-service.py.