Gemini Enterprise Agent Platform im Expressmodus – Übersicht

Mit der Gemini Enterprise Agent Platform im Express-Modus können Sie sich registrieren und mit der Entwicklung generativer KI-Anwendungen auf Google Cloudbeginnen. Diese vereinfachte Einrichtung optimiert den Zugriff auf Google Cloud APIs, indem die Organisation, Abrechnung und Projektverwaltung vereinfacht werden.

Häufig gestellte Fragen zum Google Cloud-Expressmodus

Für den Expressmodus registrieren

Die Agent Platform ist im Expressmodus für Entwickler mit einem @gmail.com Google-Konto verfügbar:

  • Neue Nutzer: Neue Nutzer von Google Cloud können sich für ein Konto im Expressmodus in einem kostenlosen Tarif registrieren, um die Agent Platform bis zu 90 Tage lang kostenlos zu testen. Dabei gelten die angegebenen Kontingente. Für die Registrierung für das kostenlose Kontingent müssen Sie keine Abrechnungsinformationen angeben. Sie können ein Upgrade auf ein kostenpflichtiges Abo durchführen, indem Sie ein Rechnungskonto hinzufügen.

    Die Agent Platform im Expressmodus ist unabhängig vom Google Cloud Free Program und nicht darüber verfügbar. Wenn Sie am Google Cloud Free Program teilnehmen, finden Sie weitere Kurzanleitungen im Abschnitt Erste Schritte.

So registrieren Sie sich für die Agent-Plattform im Expressmodus: Öffnen Sie in der Google Cloud Console den Expressmodus:

Zum Expressmodus

Nachdem Sie die Einrichtung abgeschlossen haben, können Sie die Agent Platform im Express-Modus verwenden. Folgen Sie dazu einer der Anleitungen:

Informationen zur Agent Platform im Expressmodus

Wenn Sie sich für den Expressmodus registrieren, Google Cloud werden APIs in Ihrem Namen aktiviert. Dieser Prozess läuft im Hintergrund ab. Sie können die Agent-Plattform also verwenden, ohne Ressourcen manuell konfigurieren zu müssen.

Wenn Sie sich für den Express-Modus registrieren, erhalten Sie Zugriff auf Folgendes:

  • Hauptfunktionen von Agent Studio Sie können Prompts für verschiedene generative KI‑Modelle testen und anpassen. Den entsprechenden Code können Sie für Ihre Anwendung nutzen.
  • Einen API-Schlüssel. Anfragen von Ihrer Anwendung authentifizieren
  • Kostenloses Kontingent für neue Google Cloud Nutzer für 90 Tage. Während des 90-Tage-Limits der kostenlosen Stufe für neue Google Cloud Nutzer können Sie die Agent Platform APIs, die den Expressmodus unterstützen, kostenlos bis zu den jeweiligen Kontingenten verwenden. Sie müssen keine Abrechnungsinformationen angeben. Die Kontingentlimits lassen sich durch Aktivieren der Abrechnung jederzeit erhöhen.

Wenn Sie bereits Google Cloud -Nutzer sind oder die Abrechnung aktivieren, wird die kostenlose Stufe mit 90 Tagen entfernt. Sie wechseln zu einer kostenpflichtigen Stufe, um Zugriff auf erweiterte Kontingentlimits und zusätzliche Google Cloud Funktionen zu erhalten. Da Ihre Kontingente erhöht werden, zahlen Sie nur für die tatsächliche Nutzung. Sie können den Expressmodus jederzeit beenden und alle Google Cloud Dienste und Funktionen nutzen.

In der folgenden Tabelle sind die Unterschiede zwischen dem Express-Modus und der vollständigen Agent Platform aufgeführt:

Element Agent Platform Express-Modus in der kostenlosen Stufe Vollständige Agent Platform
Zeitlimit 90 Tage Unbegrenzt
Verfügbare Dienste Grundlegende Dienste mit generativer KI. Alle Google Cloud Dienste, einschließlich der Agent Platform.
Datenquellen Google Drive Alle in Google Cloudverfügbaren Datenquellen.
Kontingent Limits für die kostenlose Stufe. Verfügbare Modelle und Ratenbegrenzungen im Expressmodus Standardlimits für „Pay as you go“. Weitere Informationen finden Sie unter Ratenlimits.
Standardformat von API-Endpunkten Verwenden Sie den globalen Endpunkt ohne Projekt-ID oder Standort und übergeben Sie Ihren API-Schlüssel im HTTP-Header x-goog-api-key (oder im Abfrageparameter key). Beispiel:
https://aiplatform.googleapis.com/v1/publishers/google/models/MODEL_ID:streamGenerateContent 		Geben Sie eine Projekt-ID und einen Standort an. Beispiel:
https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent

Verfügbare Modelle und Ratenbegrenzungen im Express-Modus

Im Express-Modus können Sie verschiedene Modelle ausprobieren, darunter Gemini Flash-Modelle. In der folgenden Tabelle sind die im Express-Modus verfügbaren Modelle sowie ihre Ratenbeschränkungen aufgeführt:

Modellkategorie Verfügbare Modelle Maximale Anzahl von Anfragen pro Minute
Gemini gemini-3-pro-image Dynamisch
gemini-3.1-flash-image Dynamisch
gemini-3.1-pro-preview Dynamisch
gemini-3-flash-preview Dynamisch
gemini-2.5-pro 10
gemini-2.5-flash-image 10
gemini-2.5-flash 10
gemini-2.5-flash-lite 10

Im Express-Modus werden nur die in der vorherigen Tabelle aufgeführten Modelle unterstützt. Spezielle Gemini Live API-Modelle wie Gemini 3.8 Live (gemini-3.8-live) und Gemini 2.5 Flash Live API Native Audio (gemini-live-2.5-flash-native-audio) werden im Express-Modus nicht unterstützt und die Gemini Live API ist im Express-Modus nicht in derGoogle Cloud -Konsole verfügbar. Wenn Sie unterstützte Gemini Live API-Modelle verwenden möchten, müssen Sie vom Express-Modus auf ein Standardkonto Google Cloudupgraden.

Agent Platform im Expressmodus – Workflow

So können Sie Anfragen von Ihrer Anwendung an die Agent Platform-APIs senden:

  1. Nachdem Sie sich für den Express-Modus registriert haben, können Sie Agent Studio verwenden, um die Funktionen der Agent Platform auszuprobieren:

    Zu Agent Studio

    Wählen Sie beispielsweise Agent Studio > Prompt erstellen aus, um multimodale Prompts mit verschiedenen Gemini-Modellen zu erstellen und zu optimieren.

  2. Code für die Implementierung Ihrer Arbeit abrufen

    Klicken Sie auf der Prompt-Seite auf Mit Code erstellen > Code abrufen. Ein Bereich wird geöffnet, in dem Code angezeigt wird, mit dem programmatisch dieselben Anfragen gesendet werden, die Sie in der Benutzeroberfläche implementiert haben. Sie können den Code für eine Programmiersprache oder curl abrufen. Sie können Google Colab verwenden, um den Python-Code auszuprobieren.

  3. Verwenden Sie Ihren API-Schlüssel, um sich bei der Agent Platform API zu authentifizieren.

    Öffnen Sie in der Google Cloud Console im Expressmodus APIs & Dienste > Anmeldedaten:

    Zu den Anmeldedaten

    Kopieren Sie dann Ihren API-Schlüssel für generative KI in Ihren Code an die Stelle, an der "YOUR_API_KEY" steht. Beispiel:

    Python

    Das Google Gen AI SDK for Python ist auf PyPI und GitHub verfügbar:

    Weitere Informationen finden Sie in der Python SDK-Referenz (wird in neuem Tab geöffnet). 

    from google import genai

# TODO(developer): Update below line
API_KEY = "YOUR_API_KEY"

client = genai.Client(vertexai=True, api_key=API_KEY)

response = client.models.generate_content(
    model="gemini-3.5-flash",
    contents="Explain bubble sort to me.",
)

print(response.text)
# Example response:
# Bubble Sort is a simple sorting algorithm that repeatedly steps through the list

Unterschiede zum Expressmodus

Die Agent Platform im Express-Modus bietet eine Teilmenge der Funktionen für generative KI. Daher ist ein Teil der Dokumentation zur Agent Platform nicht relevant, wenn Sie sich im Express-Modus registriert haben. Details zu den verfügbaren API-Endpunkten im Express-Modus finden Sie in der REST API-Referenz für die Agent Platform im Express-Modus.

Außerdem verwenden Kunden in Google Cloud in der Regel Organisationen und Projekte, um mit Ressourcen zu arbeiten (z. B. zum Aufrufen eines API-Endpunkt). Wenn Sie die Agent Platform im Express-Modus verwenden, müssen Sie sich nicht um Organisationen oder Projekte kümmern. Sie werden jedoch möglicherweise in einigen der Google Cloud Dokumentationen erwähnt, auf die Sie beim Verwenden der Agent Platform im Express-Modus verweisen. Sie können die Dokumentation weiterhin verwenden, sollten aber Konzepte und Anleitungen ignorieren, die sich auf Organisationen und Projekte beziehen. Außerdem wird der Standort, den Sie bei der Registrierung im Expressmodus ausgewählt haben, für alle Funktionen verwendet.

Wenn Sie REST API-Endpunkte im Express-Modus aufrufen, verwenden Sie das globale Endpunktformat für den Express-Modus und authentifizieren Sie sich mit Ihrem API-Schlüssel:

Standard-Endpunkt-URL https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent
Endpunkt-URL im Express-Modus https://aiplatform.googleapis.com/v1/publishers/google/models/MODEL_ID:streamGenerateContent

Beachten Sie beim Senden von REST-Anfragen im Express-Modus die folgenden Endpunkt- und Authentifizierungsdetails:

  • Pfad des Publisher-Modells ({model}): In der REST API-Referenz für die Agent Platform im Express-Modus verwenden Endpunktvorlagen wie https://aiplatform.googleapis.com/v1/{model}:streamGenerateContent und https://aiplatform.googleapis.com/v1beta1/{model}:streamGenerateContent {model}, um den vollständigen Ressourcenpfad des Publisher-Modells (publishers/google/models/MODEL_ID) darzustellen. Beide werden in dieselbe Endpunkt-URL aufgelöst.
  • Authentifizierungsheader für API-Schlüssel: Es ist nicht erforderlich, Ihren API-Schlüssel als Abfrageparameter zu übergeben. Übergeben Sie Ihren API-Schlüssel im x-goog-api-key-HTTP-Header (z. B. -H "x-goog-api-key: API_KEY"). Wenn in Ihrer Clientumgebung keine HTTP-Header festgelegt werden können, können Sie stattdessen den Systemabfrageparameter key übergeben (?key=API_KEY). Weitere Informationen finden Sie unter API-Schlüssel verwenden.

API-Schlüssel aufrufen und verwalten

Zur Authentifizierung bei Agent Platform API-Endpunkten, die den Express-Modus unterstützen, verwenden Sie den API-Schlüssel, der bei der Registrierung für Sie erstellt wurde, oder einen beliebigen Schlüssel, den Sie im Express-Modus erstellt haben. Ein API-Schlüssel ist ein verschlüsselter String, der automatisch für Sie generiert wird, wenn Sie sich im Expressmodus registrieren. Diese API-Schlüssel können auf der Seite APIs & Dienste aufgerufen und verwaltet werden.

Weitere Informationen zu Best Practices für die Verwaltung von API-Schlüsseln finden Sie unter Best Practices für die Verwaltung von API-Schlüsseln.

So rufen Sie Ihre API-Schlüssel auf und verwalten sie:

  1. Rufen Sie in der Google Cloud Console die Seite API-Schlüssel auf:

    Zu den API-Schlüsseln

Abrechnung aktivieren und verwalten

Sie können Ihre Kontingente erhöhen und das 90‑Tage-Limit aufheben, indem Sie die Abrechnung aktivieren.

Nach der Aktivierung der Abrechnung zahlen Sie nur für die tatsächliche Nutzung. Sie können auch Ihre Prompts speichern und zusätzliche Einstellungen in der Google Cloud Console verwenden, die ausgegraut sind, wenn die Abrechnung nicht aktiviert ist.

So verwalten Sie die Abrechnung:

  1. Rufen Sie die Übersichtsseite von Agent Studio im Expressmodus auf.

    Zu Agent Studio

  2. Öffnen Sie in der Google Cloud Console im Express-Modus die Abrechnung:

    Zur Abrechnung

  3. Rechnungskonten verwalten

Alle Google Cloud Funktionen und ‑Dienste nutzen

Der Express-Modus soll Ihnen den Einstieg erleichtern. Wenn Sie bereit sind, andereGoogle Cloud Dienste zu verwenden oder mehr Kontrolle über Ihre Umgebung benötigen, können Sie Ihr Expressmodus-Konto in ein Standardkonto Google Cloud umwandeln. Dieser Vorgang wird manchmal auch als Upgrade bezeichnet.

Sie können alle Funktionen und Dienste vonGoogle Cloud in Ihrem Projekt nutzen, indem Sie Ihr Konto im Expressmodus upgraden.

So führen Sie ein Upgrade vom Express-Modus durch:

  1. Rufen Sie die Übersichtsseite von Agent Studio im Expressmodus auf.

    Zu Agent Studio

  2. Klicken Sie auf Jetzt aktivieren und folgen Sie der Anleitung.

Nach dem Upgrade vom Express-Modus geben Sie beim Aufrufen der REST API-Endpunkte Ihre Projekt-ID und Ihren Standort anstelle Ihres API-Schlüssels an. Beispiel:

https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent