Vertex AI SDK for Python 簡介

您可以使用 Python 適用的 Vertex AI SDK，自動擷取資料、訓練模型，以及在 Vertex AI 上取得預測結果。Vertex AI SDK 會使用 Python 程式碼存取 Vertex AI API，因此您可以使用程式輔助方式，完成在 Google Cloud 控制台中可執行的多數作業。

如要瞭解如何安裝或更新 Python 適用的 Vertex AI SDK，請參閱「安裝 Python 適用的 Vertex AI SDK」。詳情請參閱 Vertex AI SDK for Python API 參考說明文件。

為什麼要使用 Vertex AI SDK

如果您是經驗豐富的機器學習 (ML) 和人工智慧 (AI) 工程師或數據資料學家，且想以程式輔助方式自動執行工作流程，建議使用 Python 適用的 Vertex AI SDK。Python 適用的 Vertex AI SDK 與 Vertex AI Python 用戶端程式庫類似，但 Vertex AI SDK 的層級較高，精細程度較低。詳情請參閱「瞭解 SDK 和用戶端程式庫的差異」。

使用 Python 適用的 Vertex AI SDK 編寫程式碼

如要使用 Python 適用的 Vertex AI SDK，請按照下列步驟操作：

  1. 在虛擬環境中執行下列指令，安裝 google-cloud-aiplatform 套件，其中包含 Vertex AI SDK for Python 和 Vertex AI Python 用戶端程式庫：

    pip install --upgrade google-cloud-aiplatform

  2. 請使用下列程式碼匯入 google.cloud.aiplatform 命名空間：

    from google.cloud import aiplatform

  3. If you're using a local shell, then create local authentication credentials for your user account: 

    gcloud auth application-default login

    You don't need to do this if you're using Cloud Shell.

    If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

瞭解 Python 適用的 Vertex AI SDK

請參閱下列說明文件：

  • Vertex AI SDK 類別總覽：介紹 Vertex AI SDK 中的主要類別和功能。

  • Vertex AI 的 Python 參考資料：包含 google-cloud-aiplatform 套件中所有命名空間、類別、方法和屬性的參考說明文件，包括 Vertex AI SDK、Vertex AI SDK 預先發布版和 Vertex AI Client 程式庫。

試用程式碼範例和教學課程

筆記本教學課程會說明如何使用 Vertex AI SDK for Python，做為較大型工作流程的一部分。詳情請參閱 Vertex AI Notebook 教學課程。

Vertex AI SDK for Python GitHub 存放區中的程式碼範例，會說明如何完成個別工作。詳情請參閱 Python 適用的 Vertex AI SDK GitHub 存放區。

瞭解 Vertex AI SDK 和用戶端程式庫的差異

安裝 Vertex AI SDK for Python 時，系統也會安裝 Vertex AI Python 用戶端程式庫。Vertex AI SDK 和 Vertex AI Python 用戶端程式庫提供類似功能，但精細程度不同。Vertex AI SDK 的抽象層級高於用戶端程式庫，適用於大多數常見的資料科學工作流程。如需較低層級的功能，請使用 Vertex AI Python 用戶端程式庫。

Vertex AI SDK 適用於 Python，而 Vertex AI 用戶端程式庫則適用於 Python、Java 和 Node.js。如要瞭解如何安裝 Java 或 Node.js 用戶端程式庫，請參閱「安裝 Vertex AI 用戶端程式庫」。如果沒有您偏好程式設計語言的用戶端程式庫，可以使用 Vertex AI REST API。詳情請參閱 Vertex AI REST 參考資料。

同時使用 Vertex AI Python 用戶端程式庫和 SDK

如果您使用 Vertex AI SDK for Python，但發現需要更大的彈性或控制權，或是需要 Vertex AI SDK 未提供的方法，可以在相同的工作流程中使用 Vertex AI Python 用戶端程式庫。Vertex AI Python 用戶端程式庫使用不同的命名空間存取 Vertex AI API。您可以在同一個 Python 指令碼中使用用戶端程式庫和 Vertex AI SDK for Python 命名空間，只要在 Python 指令碼中為每個命名空間新增 import 行即可。

匯入 Vertex AI Python 用戶端程式庫命名空間

Vertex AI Python 用戶端程式庫的命名空間為 google.cloud.aiplatform.gapic。這個命名空間會對應至 google.cloud.aiplatform_v1 命名空間。這兩個命名空間可以交替使用。如要匯入 Python 用戶端程式庫，請在 Python 指令碼中加入下列其中一項：

from google.cloud import aiplatform_v1
 
from google.cloud.aiplatform import gapic

後續步驟