安裝 Vertex AI 用戶端程式庫

本頁面說明 Google Distributed Cloud (GDC) 無網路連線裝置為 Vertex AI API 提供的各種用戶端程式庫，並說明如何從 tar 檔案安裝這些程式庫。

GDC 實體隔離裝置提供各種 Vertex AI 服務，包括光學字元辨識 (OCR)、Vertex AI Translation 和語音轉文字。每項服務都會提供自己的 API，您可以透過用戶端程式庫安裝。

用戶端程式庫可簡化從 GDC 氣隙式裝置上支援的語言存取 Vertex AI API 的程序。雖然您可以直接發出原始伺服器要求來使用 Vertex AI API，但用戶端程式庫提供簡化功能，可減少所需程式碼。

建議您使用用戶端程式庫，以程式輔助的方式存取 Vertex AI API。直接從 tar 檔案解壓縮程式庫檔案，即可安裝 Vertex AI 用戶端程式庫。

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。

下表列出 GDC 氣隙裝置支援的 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. 將 Cloud AI 檢視者 (cloud-ai-viewer) 角色指派給服務帳戶。 服務帳戶需要這個角色才能存取 Vertex AI 服務。

4. 確認您已安裝 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. 在 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。