安裝 Vertex AI 用戶端程式庫

本頁面將逐步說明如何安裝 Google Distributed Cloud (GDC) 氣隙環境適用的 Vertex AI 用戶端程式庫，以便從應用程式和開發環境與各種 Vertex AI 服務互動。您可以瞭解適用於 Vertex AI API 的用戶端程式庫類型，以及從 tar 檔案安裝這些程式庫的步驟。

本頁面適用於應用程式運算子群組中的應用程式開發人員，他們負責設定應用程式和開發環境，以啟用 AI 功能。詳情請參閱 GDC Air-Gapped 的目標對象說明文件。

每項 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 平台用戶端程式庫。
    • 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 平台 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

    如要進一步瞭解如何透過設定的 IDP 進行驗證，請參閱 gdcloud CLI 驗證。

  3. 確認您已安裝 Python 3.7 版。

安裝用戶端程式庫

完成必要條件後，請按照下列步驟下載 tar 檔案，並使用該檔案安裝用戶端程式庫：

  1. 下載要安裝的用戶端程式庫：

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

    更改下列內容：

    • GDC_URL：您在 GDC 中的機構網址。
    • 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 指令碼匯入用戶端程式庫。下列範例顯示 Python 指令碼的程式碼片段，其中匯入 Vertex AI Translation 用戶端程式庫，說明匯入程式庫的樣子：

    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。