Instale as bibliotecas cliente da Vertex AI

Esta página descreve os vários tipos de bibliotecas de cliente que o dispositivo isolado do Google Distributed Cloud (GDC) oferece para as APIs Vertex AI e explica como instalá-las a partir do ficheiro TAR.

O dispositivo isolado do GDC oferece vários serviços da Vertex AI, incluindo reconhecimento ótico de carateres (OCR), Vertex AI Translation e Speech-to-Text. Cada serviço fornece a sua própria API, que pode instalar através de bibliotecas cliente.

As bibliotecas cliente simplificam o acesso às APIs Vertex AI a partir de linguagens suportadas no dispositivo isolado do GDC. Embora possa usar as APIs Vertex AI diretamente fazendo pedidos brutos ao servidor, as bibliotecas de cliente oferecem simplificações que reduzem o código necessário.

As bibliotecas cliente são o método recomendado para aceder às APIs Vertex AI programaticamente. Instale uma biblioteca cliente da Vertex AI extraindo o ficheiro da biblioteca diretamente do ficheiro TAR.

Bibliotecas cliente da Vertex AI

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

As convenções de nomenclatura das bibliotecas de cliente da 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 cliente. Os valores permitidos são centos e ubuntu.

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

    • aiplatform: a biblioteca de cliente da plataforma Vertex AI.
    • speech: a biblioteca de cliente da API Speech-to-Text.
    • translate: a biblioteca de cliente do Vertex AI Translation.
    • vision: a biblioteca cliente de OCR.

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

A tabela seguinte contém as bibliotecas de cliente da Vertex AI que o dispositivo isolado do GDC suporta:

Serviço 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 cliente, 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 configurado, consulte a autenticação da CLI gdcloud.

  3. Atribua a função de visitante da IA na nuvem (cloud-ai-viewer) a uma conta de serviço. A conta de serviço requer esta função para aceder aos serviços do Vertex AI.

  4. Confirme que instalou a versão 3.7 do Python.

Instale uma biblioteca de cliente

Depois de concluir os pré-requisitos, siga estes passos para transferir o ficheiro TAR e usar o ficheiro TAR para instalar uma biblioteca de cliente:

  1. Transfira a biblioteca de cliente que quer instalar:

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

    Substitua o seguinte:

    • GDC_URL: o URL da sua organização no GDC.
    • CLIENT_LIBRARY: o nome do ficheiro da biblioteca cliente que quer transferir.

  2. Extraia o ficheiro da biblioteca:

    tar -zxf CLIENT_LIBRARY

  3. Instale a biblioteca cliente no dispositivo isolado do GDC:

    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 cliente através de um guião Python. O exemplo seguinte mostra um fragmento de código de um script Python que importa a biblioteca cliente 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")

[...]

    Este exemplo de código não está completo. Para fazer um pedido de tradução do Vertex AI, saiba mais sobre as funcionalidades de tradução.

  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 deu ao seu script Python, como translation-service.py.