Zum Inhalt springen

Google Gemini-Verbindung in Jitterbit Studio

Einführung

Eine Google Gemini-Verbindung wird mit dem Google Gemini Connector erstellt und stellt den Zugriff auf Google Gemini her. Nach der Konfiguration einer Verbindung können Instanzen von Google Gemini-Aktivitäten erstellt werden, die dieser Verbindung zugeordnet sind. Diese Aktivitäten können in Operationen entweder als Quellen (zur Bereitstellung von Daten) oder als Ziele (zur Verarbeitung von Daten) verwendet werden.

Google Gemini-Verbindung erstellen oder bearbeiten

Eine neue Google Gemini-Verbindung wird mit dem Google Gemini Connector an folgenden Orten erstellt:

Eine vorhandene Google Gemini-Verbindung kann an diesen Orten bearbeitet werden:

Google Gemini-Verbindung konfigurieren

Die folgenden Elemente der Benutzeroberfläche des Google Gemini-Verbindungskonfigurationsbildschirms werden beschrieben.

Tipp

Felder mit einem Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Geben Sie eine öffnende eckige Klammer [ in das Feld ein oder klicken Sie auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen.

  • Connection name: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Google Gemini-Verbindung eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den Google Gemini-Endpunkt zu identifizieren, der sich auf eine bestimmte Verbindung und ihre Aktivitäten bezieht.

  • Platform: Wählen Sie die Google Gemini-Plattform aus, mit der Verbindungen hergestellt werden sollen: AI Studio oder Vertex AI.

    • AI Studio: Wählen Sie diese Option, um eine Verbindung zu Google AI Studio herzustellen. Bei Auswahl dieser Option ist dieses Feld sichtbar:

    • Vertex AI: Wählen Sie diese Option, um eine Verbindung zur Gemini Enterprise Agent Platform (zuvor als Vertex AI bekannt) herzustellen. Bei Auswahl dieser Option sind diese Felder sichtbar:

      • Project ID: Geben Sie die project_id ein, die in der JSON-Datei der Service Account Credentials enthalten ist.

      • Location: Geben Sie die Google Cloud-Region ein, in der Ihre Gemini Enterprise Agent Platform-Ressourcen gehostet werden (z. B. us-central1).

      • Client email: Geben Sie die client_email ein, die in der JSON-Datei der Service Account Credentials enthalten ist.

      • Private key string: Geben Sie den private_key ein, der in der JSON-Datei der Service Account Credentials enthalten ist. Der private Schlüssel sollte in diesem Format eingegeben werden:

-----BEGIN PRIVATE KEY-----
<private_key>
-----END PRIVATE KEY-----

Hinweis

Alle Zeilenumbruchzeichen (\n) in der private_key-Zeichenkette müssen durch einen Wagenrücklauf im Feld Private key string ersetzt werden. Andernfalls tritt beim Testen der Verbindung ein Fehler auf.

  • Chat-Kontext über Operationen hinweg speichern: Klicken Sie, um das Kurzzeitspeicher-Feature zu aktivieren, das den Chat-Kontext über den Bereich einer einzelnen Operation hinaus speichert.

    Wichtig

    Das Aktivieren dieser Einstellung speichert den Chat-Kontext über Operationsketten hinweg nur für Cloud-Agent-Gruppen. Private Agents speichern den Chat-Kontext immer im Speicher für Operationen innerhalb derselben Operationskette, die dieselbe chatId haben, unabhängig von dieser Einstellung.

    Wenn aktiviert, werden diese zusätzlichen Einstellungen angezeigt:

    • Chat context TTL: Geben Sie die Aufbewahrungsdauer des Chat-Kontexts im Kurzzeitspeicher in Sekunden ein. Der Standardwert ist 86400 Sekunden (1 Tag).

    • Maximum messages saved in context: Geben Sie die maximale Anzahl von Nachrichten ein, die im Chat-Kontext des Kurzzeitspeichers gespeichert werden sollen. Der Standardwert und Mindestwert ist 10 Nachrichten.

    • When chat context is not found: Wählen Sie die Aktion aus, die ausgeführt werden soll, wenn der Chat-Kontext nicht im Kurzzeitspeicher gefunden wird:

      • Create a new context: (Standard.) Ein neuer Chat-Kontext wird erstellt.

      • Fail the request: Die Anfrage schlägt fehl.

  • Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:

    • Timeout: Geben Sie den Timeout-Wert in Sekunden ein.

    • Use Proxy Settings (Private Agent Only): Bei Verwendung eines privaten Agents kann diese Einstellung gewählt werden, um Private-Agent-Proxy-Einstellungen zu nutzen.

  • Test: Klicken Sie, um die Verbindung mit der angegebenen Konfiguration zu überprüfen. Beim Testen der Verbindung wird die neueste Version des Connectors von dem/den Agent(en) in der Agent-Gruppe heruntergeladen, die mit der aktuellen Umgebung verknüpft ist. Dieser Connector unterstützt die Aussetzung des Downloads der neuesten Connector-Version durch die Organisationsrichtlinie Disable Auto Connector Update.

  • Save: Klicken Sie, um die Verbindungskonfiguration zu speichern und zu schließen.

  • Discard changes: Nachdem Sie Änderungen an einer neuen oder vorhandenen Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speicherung zu schließen. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

  • Delete: Nachdem Sie eine vorhandene Verbindungskonfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Component dependencies, deletion, and removal). Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Verbindung löschen möchten.

Nächste Schritte

Nach der Erstellung einer Google Gemini-Verbindung fügen Sie einen Aktivitätstyp auf der Entwurfsfläche ein, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (zum Bereitstellen von Daten in einer Operation) oder als Ziele (zum Verarbeiten von Daten in einer Operation) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie unter Actions menus in Connector Basics.

Diese Aktivitätstypen sind verfügbar:

  • Register Tools: Registriert Funktionen (Tools) für das angegebene Modell in Google Gemini und ist als Ziel in einer Operation vorgesehen.

  • Prompt: Sendet einen Prompt an das angegebene Modell in Google Gemini und ist als Ziel in einer Operation vorgesehen.