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: クライアント ライブラリをインストールするオペレーティング システムの名前。指定できる値は centosubuntu です。
  • 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 など)に置き換えます。