安裝 Vertex AI 用戶端程式庫

在 Google Distributed Cloud (GDC) 實體隔離方案設備中，Vertex AI 用戶端程式庫可讓您透過支援的語言，以程式輔助方式存取光學字元辨識 (OCR)、語音轉文字、Vertex AI Translation 和 Vertex AI Platform API，不必編寫原始伺服器要求。直接從 CentOS 或 Ubuntu 作業系統的 tar 檔案中擷取並安裝用戶端程式庫。

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。

下表列出 GDC 實體隔離方案設備支援的 Vertex AI 用戶端程式庫：

事前準備

下載 tar 檔案並擷取用戶端程式庫之前，請先按照下列步驟操作：

1. 設定 Vertex AI 專案。

2. 使用 gdcloud CLI 進行驗證：

   gdcloud auth login
   

   如要進一步瞭解如何使用設定的身分提供者進行驗證，請參閱「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 的網址。
   • CLIENT_LIBRARY：要下載的用戶端程式庫檔案名稱。

2. 解壓縮程式庫檔案：

   tar -zxf CLIENT_LIBRARY
   

3. 在 GDC 實體隔離方案設備中安裝用戶端程式庫：

   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")
   
   [...]
   

   這個程式碼範例並不完整。如要提出 Vertex AI Translation 要求，請瞭解翻譯功能。

5. 將 Python 指令碼儲存為 translation-service.py 等名稱。

6. 執行 Python 指令碼：

   python SCRIPT_NAME
   

   將 SCRIPT_NAME 替換為您為 Python 指令碼指定的名稱，例如 translation-service.py。