安装 Vertex AI 客户端库

借助 Google Distributed Cloud (GDC) 网闸隔离设备中的 Vertex AI 客户端库,您可以通过支持的语言以编程方式访问光学字符识别 (OCR)、Speech-to-Text、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 客户端库:

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
    

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

  3. 将 Cloud AI Viewer (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 脚本导入客户端库。以下示例展示了导入 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。