Vertex AI-Clientbibliotheken installieren

Clientbibliotheken bieten eine optimierte Entwicklung für den Aufruf der Vertex AI API. Die Clientbibliotheken verwenden die natürlichen Konventionen jeder unterstützten Sprache und reduzieren Standardcode, den Sie schreiben müssen. In der folgenden Anleitung wird erläutert, wie Sie die Bibliotheken installieren und die Authentifizierung für ihre Verwendung in einer lokalen Entwicklungsumgebung einrichten.

Hinweis

  1. Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Enable the Vertex AI API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Enable the Vertex AI API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    6.

  6. 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, müssen Sie das nicht tun.

    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.

Clientbibliotheken

Vertex AI stellt Clientbibliotheken für die folgenden Sprachen bereit. Wählen Sie die gewünschte Sprache aus.

C#

Führen Sie den folgenden Befehl aus, um der Projektdatei den Google.Cloud.AIPlatform.V1-Paketverweis hinzuzufügen:

dotnet add package Google.Cloud.AIPlatform.V1

Codebeispiele ausprobieren

Rufen Sie das GitHub-Repository dotnet-aiplatform auf, um einzelne Codebeispiele anzusehen oder abzurufen.

Dokumentation der Clientbibliothek

Weitere Informationen finden Sie in der Dokumentation zur Vertex AI .NET-Clientbibliothek.

Java

Wenn Sie Maven verwenden, fügen Sie Ihrer Abhängigkeiten Folgendes hinzu.

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>google-cloud-aiplatform</artifactId>
  <version>3.35.0</version>
</dependency>

Wenn Sie Gradle verwenden, fügen Sie den Abhängigkeiten Folgendes hinzu:

compile 'com.google.cloud:google-cloud-aiplatform:3.35.0'

Wenn Sie SBT verwenden, fügen Sie den Abhängigkeiten Folgendes hinzu:

libraryDependencies += "com.google.cloud" % "google-cloud-aiplatform" % "3.35.0"

Codebeispiele ausprobieren

Rufen Sie das GitHub-Repository java-aiplatform auf, um einzelne Codebeispiele anzusehen oder abzurufen.

Dokumentation der Clientbibliothek

Weitere Informationen finden Sie in der Dokumentation zur Java-Clientbibliothek von Vertex.

Node.js

Bereiten Sie Ihre Umgebung für die Node.js-Entwicklung vor, bevor Sie die Bibliothek installieren.

Führen Sie den folgenden Befehl in Ihrer Umgebung aus, um die Clientbibliothek zu installieren:

npm install @google-cloud/aiplatform

Dokumentation der Clientbibliothek

Weitere Informationen finden Sie in der Vertex AI-Clientbibliothek für Node.js.

Python

Die Vertex AI-Python-Clientbibliothek wird bei der Installation des Vertex AI SDK für Python installiert.

Weitere Informationen finden Sie unter Vertex AI SDK für Python installieren.

Go

Bereiten Sie Ihre Umgebung für die Go-Entwicklung vor, bevor Sie die Bibliothek installieren.

Verfügbare Pakete ansehen

Prüfen Sie die verfügbaren Go-Pakete für die Vertex AI API, um festzustellen, welches Paket die Anforderungen Ihres Projekts am besten erfüllt:

  • Paket cloud.google.com/go/vertexai (empfohlen)

    vertexai ist ein von Menschen erstelltes Paket, das Zugriff auf gängige Funktionen und Features bietet.

    Dieses Paket wird als Ausgangspunkt für die meisten Entwickler empfohlen, die mit der Vertex AI API erstellen. Verwenden Sie stattdessen das automatisch generierte aiplatform, um auf Funktionen und zuzugreifen, die noch nicht von diesem Paket abgedeckt sind.

  • Paket cloud.google.com/go/aiplatform

    aiplatform ist ein automatisch generiertes Paket.

    Dieses Paket ist für Projekte gedacht, die Zugriff auf die Funktionen und Features der Vertex AI API benötigen, die noch nicht vom menschlichen vertexai-Paket bereitgestellt werden.

Installation

  • Paket cloud.google.com/go/vertexai (empfohlen)

    Führen Sie den folgenden Befehl aus, um dieses Paket in Ihrer Umgebung zu installieren:

    go get cloud.google.com/go/vertexai

  • Paket cloud.google.com/go/aiplatform

    Führen Sie den folgenden Befehl aus, um dieses Paket in Ihrer Umgebung zu installieren:

    go get cloud.google.com/go/aiplatform

Beispiele

Dokumentation der Clientbibliothek

Weitere Informationen zur Bibliothek finden Sie in der Dokumentation zur Vertex AI-Clientbibliothek für Go: