安装 Vertex AI 客户端库

本页面介绍了 Google Distributed Cloud (GDC) 气隙设备为 Vertex AI API 提供的各种类型的客户端库，并说明了如何从 tar 文件安装这些库。

GDC air-gapped 设备提供各种 Vertex AI 服务，包括光学字符识别 (OCR)、Vertex AI Translation 和 Speech-to-Text。每项服务都提供自己的 API，您可以使用客户端库安装这些 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 Platform	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
   

   如需详细了解如何使用已配置的身份提供方进行身份验证，请参阅 gcloud CLI 身份验证。

3. 向服务账号分配 Cloud AI Viewer (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 脚本导入客户端库。以下示例展示了导入 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")
   
   [...]
   

   此代码示例并不完整。如需发出 Vertex AI Translation 请求，请了解翻译功能。

5. 保存 Python 脚本，并为其命名，例如 translation-service.py。

6. 运行 Python 脚本：

   python SCRIPT_NAME
   

   将 SCRIPT_NAME 替换为您为 Python 脚本指定的名称，例如 translation-service.py。