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 がインストールされていることを確認します。

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

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

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

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

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

  2. ライブラリ ファイルを抽出します。

    tar -zxf CLIENT_LIBRARY

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

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

    FOLDER_NAME は、ライブラリ ファイルをダウンロードしたローカル ディレクトリのパスに置き換えます。

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

    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. Python スクリプトを translation-service.py などの名前で保存します。

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

    python SCRIPT_NAME

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