Clientbibliotheken für die Gemini Enterprise Agent Platform installieren

Clientbibliotheken bieten eine optimierte Entwicklungsumgebung für den Aufruf der Agent Platform API. Die Clientbibliotheken verwenden die natürlichen Konventionen jeder unterstützten Sprache und reduzieren Boilerplate-Code, 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 noch nicht mit Google Cloudvertraut sind, erstellen Sie ein Konto, um die Leistung 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 Agent Platform 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 Agent Platform 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, 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.

Clientbibliotheken

Agent Platform 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 die Paketreferenz Google.Cloud.AIPlatform.V1 Ihrer Projektdatei 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 .NET-Clientbibliothek für Agent Platform.

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 für Agent Platform.

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 Dokumentation zur Node.js Clientbibliothek für Agent Platform.

Python

Die Python-Clientbibliothek für die Gemini Enterprise Agent Platform wird bei der Installation des Agent Platform SDK für Python installiert.

Weitere Informationen finden Sie unter Agent Platform 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 Agent Platform 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 Agent Platform 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 Agent Platform 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 Go-Clientbibliothek für Agent Platform: