安装 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 平台客户端库。
  • 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. 向服务账号分配 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. 在 Distributed Cloud 中安装客户端库：

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

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

6. 运行 Python 脚本：

   python SCRIPT_NAME
   

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