安裝 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
   

   如要進一步瞭解如何使用已設定的身分提供者進行驗證，請參閱 gcloud 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。