Einführung in das Agent Platform SDK für Python

Mit dem Agent Platform SDK für Python können Sie die Datenaufnahme automatisieren, Modelle trainieren und Vorhersagen für die Agent Platform erhalten. Das Agent Platform SDK verwendet Python-Code, um auf die Agent Platform API zuzugreifen, damit Sie die meisten Dinge programmatisch erledigen können, die in der Google Cloud Console möglich sind.

Informationen zum Installieren oder Aktualisieren des Agent Platform SDK für Python finden Sie unter Installieren des Agent Platform SDK für Python. Weitere Informationen finden Sie unter der API-Referenzdokumentation zum Agent Platform SDK für Python.

Vorteile des Agent Platform SDK

Das Agent Platform SDK für Python wird empfohlen, wenn Sie ein erfahrener Entwickler für maschinelles Lernen (ML) und künstliche Intelligenz (KI) oder ein Data Scientist sind und einen Workflow programmatisch automatisieren möchten. Das Agent Platform SDK für Python ähnelt der Agent Platform-Python-Clientbibliothek, mit der Ausnahme, dass es auf höherer Ebene arbeitet und weniger detailliert ist. Weitere Informationen finden Sie unter Unterschiede zwischen SDK und Clientbibliotheken verstehen.

Code mit dem Agent Platform SDK für Python schreiben

So verwenden Sie das Agent Platform SDK für Python:

  1. Installieren Sie das Paket google-cloud-aiplatform, das sowohl das Agent Platform SDK für Python als auch die Agent Platform-Python-Clientbibliothek enthält. Führen Sie dazu den folgenden Befehl in Ihrer virtuellen Umgebung aus:

    pip install --upgrade google-cloud-aiplatform

  2. Importieren Sie den Namespace google.cloud.aiplatform mit dem folgenden Code:

    from google.cloud import aiplatform

  3. Wenn Sie eine lokale Shell verwenden, erstellen Sie lokale Anmeldedaten zur Authentifizierung für Ihr Nutzerkonto: 

    gcloud auth application-default login

    Wenn Sie Cloud Shell verwenden, ist dies nicht erforderlich.

    Wenn ein Authentifizierungsfehler zurückgegeben wird und Sie einen externen Identitätsanbieter (IdP) verwenden, prüfen Sie, ob Sie sich mit Ihrer föderierten Identität in der gcloud CLI angemeldet haben.

Informationen zum Agent Platform SDK für Python

Weitere Informationen finden Sie in der folgenden Dokumentation:

  • Agent Platform SDK-Klassenübersicht: Einführung in die wichtigsten Klassen und Funktionen des Agent Platform SDK.

  • Python-Referenz für die Agent Platform: Enthält eine Referenzdokumentation für alle Namespaces, Klassen, Methoden und Attribute im Paket google-cloud-aiplatform, einschließlich des Agent Platform SDK, der Agent Platform SDK-Vorschau und der Agent Platform-Clientbibliotheken.

Codebeispiele und Anleitungen ausprobieren

Notebook-Anleitungen zeigen, wie Sie das Agent Platform SDK für Python als Teil eines größeren Workflows verwenden. Weitere Informationen finden Sie in den Notebook-Anleitungen zur Agent Platform.

Die Codebeispiele im GitHub-Repository zum Agent Platform SDK für Python zeigen, wie Sie einzelne Aufgaben ausführen. Weitere Informationen finden Sie im GitHub-Repository zum Agent Platform SDK für Python.

Unterschiede zwischen dem Agent Platform SDK und der Clientbibliothek

Wenn Sie das Agent Platform SDK für Python installieren, wird auch die Agent Platform-Python-Clientbibliothek installiert. Das Agent Platform SDK und die Agent Platform-Python-Clientbibliothek bieten ähnliche Funktionen mit unterschiedlichem Detaillierungsgrad. Das Agent Platform SDK arbeitet mit einer höheren Abstraktionsebene als die Clientbibliothek und ist für die meisten gängigen Data-Science-Workflows geeignet. Wenn Sie Funktionen niedrigerer Ebene benötigen, verwenden Sie die Agent Platform-Python-Clientbibliothek.

Das Agent Platform SDK ist für Python, eine Agent Platform-Clientbibliothek ist für Python, Java und Node.js verfügbar. Informationen zum Installieren der Java- oder Node.js-Clientbibliothek finden Sie unter Agent Platform-Clientbibliotheken installieren. Wenn keine Clientbibliothek in Ihrer bevorzugten Programmiersprache verfügbar ist, können Sie die Agent Platform REST API verwenden. Weitere Informationen finden Sie in der Referenz zur Agent Platform REST API.

Agent Platform-Python-Clientbibliothek und SDK gemeinsam verwenden

Wenn Sie das Agent Platform SDK für Python verwenden und mehr Flexibilität oder Kontrolle benötigen oder wenn Sie eine Methode benötigen, die nicht im Agent Platform SDK enthalten ist, können Sie die Agent Platform-Python-Clientbibliothek im selben Workflow verwenden. Die Agent Platform-Python-Clientbibliothek verwendet einen anderen Namespace für den Zugriff auf die Agent Platform API. Die Namespaces der Clientbibliothek und des Agent Platform SDK für Python können im selben Python-Script verwendet werden. Fügen Sie dazu in Ihrem Python-Script für jeden Namespace eine import-Zeile hinzu.

Namespace der Agent Platform-Python-Clientbibliothek importieren

Der Namespace der Agent Platform-Python-Clientbibliothek lautet google.cloud.aiplatform.gapic. Dieser Namespace ist dem Namespace google.cloud.aiplatform_v1 zugeordnet. Es ist egal, welchen dieser Namespaces Sie verwenden. Fügen Sie eine der folgenden Optionen in Ihr Python-Script ein, um die Python-Clientbibliothek zu importieren:

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

Nächste Schritte