Vertex AI-Clientbibliotheken installieren

Mit den Vertex AI-Clientbibliotheken in der GDC-Appliance (Google Distributed Cloud) mit Air Gap können Sie programmatisch auf die APIs für optische Zeichenerkennung (OCR), Speech-to-Text, Vertex AI Translation und Vertex AI Platform in unterstützten Sprachen zugreifen, ohne Rohserveranfragen schreiben zu müssen. Extrahieren und installieren Sie eine Clientbibliothek direkt aus der TAR-Datei für Ihr CentOS- oder Ubuntu-Betriebssystem.

Vertex AI-Clientbibliotheken

Vertex AI bietet verschiedene Versionen von Clientbibliotheken für die Betriebssysteme CentOS und Ubuntu.

Die Namenskonventionen der Vertex AI-Clientbibliotheken in der TAR-Datei basieren auf dem Betriebssystem, dem Dienstnamen und der Version. Die Dateinamen haben das folgende Format:

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

Ersetzen Sie Folgendes:

  • OS: der Name des Betriebssystems, auf dem Sie die Clientbibliothek installieren möchten. Zulässige Werte sind centos und ubuntu.

  • SERVICE: der Name des Vertex AI-Dienstes, von dem Sie die Clientbibliothek herunterladen möchten. Folgende Werte sind zulässig:

    • aiplatform: die Vertex AI Platform-Clientbibliothek.
    • speech: die Speech-to-Text-Clientbibliothek.
    • translate: die Vertex AI Translation-Clientbibliothek.
    • vision: die OCR-Clientbibliothek.

  • VERSION: die Versionsnummer der Clientbibliothek, z. B. 3.8.0.

Die folgende Tabelle enthält die Vertex AI-Clientbibliotheken, die von der GDC-Appliance mit Air Gap unterstützt werden:

Vertex AI-Dienst Betriebssystem Dateiname
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

Hinweis

Führen Sie die folgenden Schritte aus, bevor Sie die TAR-Datei herunterladen und Clientbibliotheken extrahieren:

  1. Projekt für Vertex AI einrichten

  2. Authentifizieren Sie sich über die gdcloud CLI:

    gdcloud auth login

    Weitere Informationen zur Authentifizierung bei Ihrem konfigurierten Identitätsanbieter finden Sie unter Authentifizierung mit der gdcloud CLI.

  3. Weisen Sie einem Dienstkonto die Rolle „Cloud AI-Betrachter“ (cloud-ai-viewer) zu. Das Dienstkonto benötigt diese Rolle, um auf die Vertex AI-Dienste zuzugreifen.

  4. Prüfen Sie, ob Sie Python Version 3.7 installiert haben.

Clientbibliothek installieren

Nachdem Sie die Voraussetzungen erfüllt haben, führen Sie die folgenden Schritte aus, um die TAR-Datei herunterzuladen und damit eine Clientbibliothek zu installieren:

  1. Laden Sie die Clientbibliothek herunter, die Sie installieren möchten:

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

    Ersetzen Sie Folgendes:

    • GDC_URL: die URL Ihrer Organisation in GDC.
    • CLIENT_LIBRARY: der Dateiname der Clientbibliothek, die Sie herunterladen möchten.

  2. Extrahieren Sie die Bibliotheksdatei:

    tar -zxf CLIENT_LIBRARY

  3. Installieren Sie die Clientbibliothek auf der GDC-Appliance mit Air Gap:

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

    Ersetzen Sie FOLDER_NAME durch den Pfad zum lokalen Verzeichnis, in das Sie die Bibliotheksdatei heruntergeladen haben.

  4. Importieren Sie die Clientbibliothek mit einem Python-Skript. Das folgende Beispiel zeigt ein Code-Snippet eines Python-Skripts, das die Vertex AI Translation-Clientbibliothek importiert, um zu veranschaulichen, wie das Importieren von Bibliotheken aussieht:

    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")

[...]

    Dieses Codebeispiel ist nicht vollständig. Wenn Sie eine Vertex AI Translation-Anfrage stellen möchten, informieren Sie sich über die Übersetzungsfunktionen.

  5. Speichern Sie das Python-Skript unter einem Namen, z. B. translation-service.py.

  6. Führen Sie das Python-Skript aus:

    python SCRIPT_NAME

    Ersetzen Sie SCRIPT_NAME durch den Namen, den Sie Ihrem Python-Skript gegeben haben, z. B. translation-service.py.