Vertex AI-Clientbibliotheken installieren

Auf dieser Seite werden die verschiedenen Arten von Clientbibliotheken beschrieben, die die Air-Gap-Appliance von Google Distributed Cloud (GDC) für Vertex AI-APIs bietet. Außerdem wird erläutert, wie Sie sie aus der TAR-Datei installieren.

Die GDC-Appliance mit Air-Gap bietet verschiedene Vertex AI-Dienste, darunter die optische Zeichenerkennung (Optical Character Recognition, OCR), Vertex AI Translation und Speech-to-Text. Jeder Dienst bietet eine eigene API, die Sie mit Clientbibliotheken installieren können.

Clientbibliotheken vereinfachen den Zugriff auf Vertex AI-APIs aus unterstützten Sprachen auf der GDC-Appliance mit Air-Gap. Sie können Vertex AI APIs zwar direkt verwenden, indem Sie Rohserveranfragen senden, aber Clientbibliotheken bieten Vereinfachungen, die den erforderlichen Code reduzieren.

Clientbibliotheken sind die empfohlene Methode für den programmatischen Zugriff auf Vertex AI APIs. Installieren Sie eine Vertex AI-Clientbibliothek, indem Sie die Bibliotheksdatei direkt aus der TAR-Datei extrahieren.

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, aus 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-Air-Gap-Appliance 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

Hinweise

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

  1. Projekt für Vertex AI einrichten

  2. Authentifizieren Sie sich mit der gdcloud CLI:

    gdcloud auth login

    Weitere Informationen zur Authentifizierung mit Ihrem konfigurierten Identitätsanbieter finden Sie unter gcloud CLI-Authentifizierung.

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

  4. Prüfen Sie, ob Sie Python 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 ohne Internetverbindung:

    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-Script. Das folgende Beispiel zeigt einen Code-Snippet eines Python-Skripts, das die Vertex AI Translation-Clientbibliothek importiert, um zu veranschaulichen, wie Bibliotheken importiert werden:

    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. Informationen zu Ü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.