Zum Inhalt springen

Google Gemini Register Tools-Aktivität in Jitterbit Studio

Einführung

Eine Google Gemini Register Tools-Aktivität verwendet ihre Google Gemini-Verbindung und registriert Funktionen (Tools) beim angegebenen Modell in Google Gemini. Sie ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen. Tool-Schemas können aus der List Tools-Aktivität des MCP Client-Connectors stammen oder direkt über die Request-Transformation als benutzerdefinierte Funktionsdefinitionen bereitgestellt werden.

Wenn der Vorgang ausgeführt wird, speichert Jitterbit die registrierten Tool-Schemas im Speicher des privaten Agenten. Jeder Vorgang, der nach diesem ausgeführt wird, hat automatisch Zugriff auf diese Schemas, wenn er das LLM aufruft. Sie müssen die Register Tools-Antwort nicht erfassen oder die Tool-Definitionen explizit an den nachfolgenden Prompt-Vorgang übergeben.

Wichtig

Um die Register Tools-Aktivität zu verwenden, müssen Sie einen privaten Agenten verwenden.

Google Gemini Register Tools-Aktivität erstellen

Eine Instanz einer Google Gemini Register Tools-Aktivität wird aus einer Google Gemini-Verbindung mit ihrem Aktivitätstyp Register Tools erstellt.

Um eine Aktivitätsinstanz zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

Eine vorhandene Google Gemini Register Tools-Aktivität kann von diesen Orten aus bearbeitet werden:

Google Gemini Register Tools-Aktivität konfigurieren

Führen Sie diese Schritte aus, um eine Google Gemini Register Tools-Aktivität zu konfigurieren:

Schritt 1: Namen eingeben und Einstellungen festlegen

Geben Sie in diesem Schritt einen Namen für die Aktivität ein, wählen Sie ein Modell aus und geben Sie einen Prompt an. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

Tipp

Felder mit einem Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen, aus der Sie auswählen können.

  • Endpunkt-Menü: Wenn Sie mehrere Endpunkte desselben Connector-Typs konfiguriert haben, wird oben auf dem Bildschirm ein Menü mit dem aktuellen Endpunktnamen angezeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpunkt ändern in Konfigurationsbildschirme.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den aktuellen Endpunktnamen bewegen. Klicken Sie, um die Verbindungskonfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

  • Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede Google Gemini Register Tools-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Chat ID: Geben Sie eine Chat-ID ein, um den Prompt-Kontext mit einem vorherigen Prompt zu verknüpfen. Falls leer und nicht in der Request-Transformation angegeben, wird eine neue Chat-ID generiert und in der Aktivitätsantwort bereitgestellt.

  • Option wählen: Geben Sie die Modellauswahlmethode an, entweder Alle Modelle auflisten oder Modellkennung eingeben.

  • Alle Modelle auflisten: Wählen Sie diese Option, um aus einer Liste von Modellen auszuwählen, die von Google Gemini abgerufen werden:

    • Modell auswählen: Dieser Bereich zeigt die im Google Gemini-Endpunkt verfügbaren Modelle an.

      • Ausgewähltes Modell: Nach der Auswahl eines Modells wird es hier aufgelistet.

      • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Modellliste zu filtern. Die Suche ist nicht case-sensitiv. Wenn Modelle bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Modelle vom Endpunkt beim Suchen neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann wie unten beschrieben.

      • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Modelle vom Google Gemini-Endpunkt neu zu laden. Dies kann hilfreich sein, wenn Modelle zu Google Gemini hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der angezeigten Modelltabelle verwendet werden.

      • Modell auswählen: Klicken Sie in der Tabelle auf eine beliebige Stelle in einer Zeile, um ein Modell auszuwählen. Es kann nur ein Modell ausgewählt werden. Die für jedes Modell verfügbaren Informationen werden vom Google Gemini-Endpunkt abgerufen:

        • Anzeigename: Der Name des Modells.

        • ID: Die ID des Modells.

        • Beschreibung: Die Beschreibung des Modells.

      Tipp

      Wenn die Tabelle nicht mit verfügbaren Modellen gefüllt wird, ist die Google Gemini-Verbindung möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldedaten erneut testen.

      Alternativ kann das Modell im Feld Modellkennung angegeben oder in der Request-Transformation bereitgestellt werden. Wenn ein Modell an mehreren Stellen angegeben ist, wird diese Prioritätsreihenfolge befolgt:

      1. Ein in der Request-Transformation bereitgestelltes Modell überschreibt alle folgenden Felder.
      2. Ein im Feld Modellkennung angegebenes Modell überschreibt das verbleibende Feld unten, auch wenn Alle Modelle auflisten ausgewählt ist.
      3. Ein in der Liste Modell auswählen ausgewähltes Modell hat die niedrigste Priorität.

  • Modellkennung eingeben: Wählen Sie diese Option, um den Namen eines Modells in Google Gemini manuell einzugeben:

    • Modell-ID: Geben Sie die Modell-ID ein.

  • Prompt: Geben Sie einen anfänglichen Prompt für das Modell ein. Der Prompt sollte den grundlegenden Kontext und die Richtlinien für die Antworten des Modells festlegen.

  • Speichern und beenden: Falls aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie Änderungen verwerfen möchten.

Schritt 2: Datenschemas überprüfen

Alle Request- oder Response-Schemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

  • Datenschema: Diese Datenschemas werden von angrenzenden Transformationen geerbt und werden erneut während der Transformationszuordnung angezeigt.

    Hinweis

    Daten, die in einer Transformation bereitgestellt werden, haben Vorrang vor der Aktivitätskonfiguration.

    Der Google Gemini-Connector verwendet die Gemini API. Weitere Informationen finden Sie in der API-Dokumentation.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Schemas vom Google Gemini-Endpunkt neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im Projekt neu, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden Transformation.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer Google Gemini-Aktivität Register Tools schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten, Transformationen oder Skripte als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit bieten, Vorgänge zu verketten, die sich in denselben oder verschiedenen Workflows befinden.

Um einen Tool-Calling-Workflow abzuschließen, verketten Sie einen Prompt-Vorgang, der nach diesem ausgeführt wird, und konfigurieren Sie ihn mit derselben chatId. Da Jitterbit die Tool-Schemas im Speicher des privaten Agenten speichert, erhält der Prompt-Vorgang sie automatisch ohne zusätzliche Zuordnung.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Designoberfläche zugänglich. Weitere Informationen finden Sie unter Activity actions menu in Connector basics.

Google Gemini-Aktivitäten Register Tools können als Ziel mit diesen Vorgangsmustern verwendet werden:

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Skriptfunktion.

Wenn Sie bereit sind, stellen Sie den Vorgang bereit und führen Sie ihn aus, und überprüfen Sie das Verhalten, indem Sie die Vorgangsprotokolle überprüfen.