Installare le librerie client di Vertex AI

Questa pagina ti guida nell'installazione delle librerie client di Vertex AI per Google Distributed Cloud (GDC) air-gapped, che ti consentono di interagire con vari servizi Vertex AI dalla tua applicazione e dal tuo ambiente di sviluppo. Puoi scoprire di più sui tipi di librerie client disponibili per le API Vertex AI e sui passaggi per installarle dal file tar.

Questa pagina è rivolta agli sviluppatori di applicazioni all'interno dei gruppi di operatori di applicazioni responsabili della configurazione degli ambienti di sviluppo e delle applicazioni per abilitare le funzionalità di AI. Per saperne di più, consulta la documentazione relativa ai segmenti di pubblico per GDC air-gapped.

Ogni servizio Vertex AI fornisce un'API. Sebbene tu possa interagire direttamente con queste API tramite richieste server non elaborate, le librerie client semplificano l'accesso programmatico dai linguaggi supportati su Distributed Cloud. Riducono il codice necessario, soprattutto quando si lavora in ambienti come un notebook JupyterLab.

Puoi installare una libreria client di Vertex AI utilizzando questi metodi:

  • Estrai il file della libreria direttamente dal file tar.
  • Utilizza un notebook JupyterLab per importare la libreria.
  • Importa una libreria client da un notebook. Per informazioni, consulta Gestire i notebook.

Librerie client di Vertex AI

Vertex AI offre diverse versioni di librerie client per i sistemi operativi CentOS e Ubuntu.

Le convenzioni di denominazione delle librerie client di Vertex AI nel file tar si basano sul sistema operativo, sul nome del servizio e sulla versione. I nomi file rispettano il seguente formato:

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

Sostituisci quanto segue:

  • OS: il nome del sistema operativo in cui vuoi installare la libreria client. I valori consentiti sono centos e ubuntu.

  • SERVICE: il nome del servizio Vertex AI da cui vuoi scaricare la libreria client. Di seguito sono riportati i valori consentiti:

    • aiplatform: la libreria client di Vertex AI Platform.
    • speech: la libreria client di Speech-to-Text.
    • translate: la libreria client di Traduzione Vertex AI.
    • vision: la libreria client OCR.

  • VERSION: il numero di versione della libreria client, ad esempio 3.8.0.

La tabella seguente contiene le librerie client di Vertex AI supportate da Distributed Cloud:

Servizio Vertex AI Sistema operativo Nome file
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
Traduzione Vertex AI 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

Prima di iniziare

Prima di scaricare il file tar ed estrarre le librerie client, segui questi passaggi:

  1. Configura un progetto per Vertex AI.

  2. Esegui l'autenticazione con CLI gdcloud:

    gdcloud auth login

    Per saperne di più su come eseguire l'autenticazione con il provider di identità configurato, consulta Autenticazione CLI gdcloud.

  3. Verifica di aver installato Python versione 3.7.

Installare una libreria client

Dopo aver completato i prerequisiti, segui questi passaggi per scaricare il file tar e utilizzarlo per installare una libreria client:

  1. Scarica la libreria client che vuoi installare:

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

    Sostituisci quanto segue:

    • GDC_URL: l'URL della console GDC per la tua organizzazione.
    • CLIENT_LIBRARY: il nome file della libreria client che vuoi scaricare.

  2. Estrai il file della libreria:

    tar -zxf CLIENT_LIBRARY

  3. Installa la libreria client in Distributed Cloud:

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

    Sostituisci FOLDER_NAME con il percorso della directory locale in cui hai scaricato il file della libreria.

  4. Importa la libreria client utilizzando uno script Python. L'esempio seguente mostra uno snippet di codice di uno script Python che importa la libreria client di Traduzione Vertex AI per illustrare l'aspetto dell'importazione delle librerie:

    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. Salva lo script Python con un nome, ad esempio translation-service.py.

  6. Esegui lo script Python:

    python SCRIPT_NAME

    Sostituisci SCRIPT_NAME con il nome che hai assegnato allo script Python, ad esempio translation-service.py.