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

このページは、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 クライアント ライブラリを示します。

始める前に

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

1. Vertex AI 用にプロジェクトを設定します。

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

   gdcloud auth login
   

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

3. サービス アカウントに Cloud AI 閲覧者（cloud-ai-viewer）ロールを割り当てます。サービス アカウントが Vertex AI サービスにアクセスするには、このロールが必要です。

4. Python バージョン 3.7 がインストールされていることを確認します。

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

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

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

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

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

   • GDC_URL: GDC 内の組織の URL。
   • 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 など）に置き換えます。