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

このページでは、Google Distributed Cloud（GDC）エアギャップ用の Vertex AI クライアント ライブラリをインストールする方法について説明します。これにより、アプリケーションや開発環境からさまざまな Vertex AI サービスを操作できます。Vertex AI API で使用できるクライアント ライブラリの種類と、tar ファイルからインストールする手順について説明します。

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

各 Vertex AI サービスは API を提供します。これらの API は、未加工のサーバー リクエストを介して直接操作できますが、クライアント ライブラリを使用すると、Distributed Cloud でサポートされている言語からのプログラムによるアクセスが簡素化されます。特に JupyterLab ノートブックなどの環境で作業する場合に、必要なコードを削減できます。

Vertex AI クライアント ライブラリは、次の方法でインストールできます。

  • tar ファイルからライブラリ ファイルを直接抽出します。
  • JupyterLab ノートブックを使用してライブラリをインポートする。
  • ノートブックからクライアント ライブラリをインポートします。詳細については、ノートブックを管理するをご覧ください。

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 など）に置き換えます。