Vertex AI クライアント ライブラリをインストールする

Google Distributed Cloud（GDC）エアギャップの Vertex AI クライアント ライブラリを使用すると、未加工のサーバー リクエストを記述することなく、光学式文字認識（OCR）、Speech-to-Text、Vertex AI Translation、Vertex AI Platform API にプログラムでアクセスできます。tar ファイルからクライアント ライブラリを直接抽出してインストールするか、JupyterLab ノートブックにライブラリをインポートします。ノートブック環境の詳細については、ノートブックを管理するをご覧ください。

このドキュメントは、AI 機能を有効にするためにアプリケーションと開発環境を構成するアプリケーション オペレーター グループのアプリケーション デベロッパーを対象としています。詳細については、GDC エアギャップ ドキュメントの対象読者をご覧ください。

Vertex AI クライアント ライブラリ

Vertex AI には、CentOS と Ubuntu のオペレーティング システム用に異なるバージョンのクライアント ライブラリが用意されています。

tar ファイル内の Vertex AI クライアント ライブラリの命名規則は、オペレーティング システム、サービス名、バージョンに基づいています。ファイル名は次の形式に従います。

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

次のように置き換えます。

  • OS: クライアント ライブラリをインストールするオペレーティング システムの名前。使用できる値は centos と ubuntu です。

  • SERVICE: クライアント ライブラリをダウンロードする Vertex AI サービスの名前。使用できる値は次のとおりです。

    • aiplatform: Vertex AI Platform クライアント ライブラリ。
    • speech: Speech-to-Text クライアント ライブラリ。
    • translate: Vertex AI Translation クライアント ライブラリ。
    • vision: OCR クライアント ライブラリ。

  • VERSION: クライアント ライブラリのバージョン番号（3.8.0 など）。

次の表に、Distributed Cloud がサポートする Vertex AI クライアント ライブラリを示します。

Vertex AI サービス オペレーティング システム ファイル名
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

始める前に

tar ファイルをダウンロードしてクライアント ライブラリを抽出する前に、次の手順を行います。

  1. Vertex AI 用のプロジェクトを設定する。

  2. gdcloud CLI を使用して認証します。

    gdcloud auth login

    構成済みの ID プロバイダで認証する方法については、gdcloud CLI 認証をご覧ください。

  3. Python 3.7 ～ 3.10 がインストールされていることを確認します。クライアント ライブラリの tarball には、cp37 から cp310 までのホイールが含まれています。

クライアント ライブラリをインストールする

前提条件を完了したら、次の手順で tar ファイルをダウンロードし、tar ファイルを使用してクライアント ライブラリをインストールします。

  1. インストールするクライアント ライブラリをダウンロードします。

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

    次のように置き換えます。

  2. ライブラリ ファイルを解凍します。

    tar -zxf CLIENT_LIBRARY

    OS-google-cloud-SERVICE-VERSION.tar.gz（centos-google-cloud-speech-2.15.0.tar.gz など）を抽出すると、LIBRARY_NAME ディレクトリ（google-cloud-speech など、OS- 接頭辞または -VERSION 接尾辞なし）が作成されます。

  3. Distributed Cloud にクライアント ライブラリをインストールします。

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

    LIBRARY_NAME は、抽出されたライブラリ ディレクトリ名（google-cloud-speech など）に置き換えます。

  4. Speech-to-Text クライアント ライブラリをインストールした場合は、インストールとバージョン（2.15.0）を確認します。

    from google.cloud import speech_v1p1beta1 as speech

print(speech.__version__)

    出力には、インストールされているバージョンが表示されます。

    2.15.0

  5. Python スクリプトを使用してクライアント ライブラリをインポートします。次の例は、Vertex AI Translation クライアント ライブラリをインポートする Python スクリプトのコード スニペットです。ライブラリのインポートがどのように行われるかを示しています。

    from google.cloud import translate
from google.api_core.client_options import ClientOptions
import google.auth
from google.auth.transport import requests

creds, _ = google.auth.default()
creds = creds.with_gdch_audience("https://ENDPOINT:443")
creds.refresh(requests.Request())
client = translate.TranslationServiceClient(
    credentials=creds, client_options=ClientOptions(api_endpoint="ENDPOINT:443"))
response = client.translate_text(request={
    "parent": "projects/PROJECT_ID", "target_language_code": "ru",
    "mime_type": "text/plain", "contents": ["Hello"]})
print(response.translations[0].translated_text)

    次のように置き換えます。

    Vertex AI Translation リクエストの作成の詳細については、翻訳機能の詳細またはテキストの翻訳をご覧ください。

  6. Python スクリプトを translation-service.py などの名前で保存します。

  7. Python スクリプトを実行します。

    python SCRIPT_NAME

    SCRIPT_NAME は、Python スクリプトに付けた名前（translation-service.py など）に置き換えます。