Zum Inhalt springen

Google Gemini Prompt-Aktivität in Jitterbit Studio

Einführung

Eine Google Gemini Prompt-Aktivität verwendet ihre Google Gemini-Verbindung und sendet einen Prompt an das angegebene Modell in Google Gemini. Sie ist dazu bestimmt, als Ziel zum Verarbeiten von Daten in einem Vorgang verwendet zu werden.

Google Gemini Prompt-Aktivität erstellen

Eine Instanz einer Google Gemini Prompt-Aktivität wird aus einer Google Gemini-Verbindung mit ihrem Aktivitätstyp Prompt 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 Prompt-Aktivität kann an diesen Orten bearbeitet werden:

Google Gemini Prompt-Aktivität konfigurieren

Führen Sie diese Schritte aus, um eine Google Gemini Prompt-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 sowie optionale Einstellungen 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 ein Menü mit vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Endpunkt-Menü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, 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 Prompt-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. Wenn leer und nicht in der Request-Transformation angegeben, wird eine neue Chat-ID generiert und in der Aktivitätsantwort bereitgestellt.

  • Option auswä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 einen beliebigen Wert aus einer Spalte in das Suchfeld ein, um die Liste der Modelle zu filtern. Die Suche unterscheidet nicht zwischen Groß- und Kleinschreibung. Wenn Modelle bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Modelle vom Endpunkt neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann wie unten beschrieben.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf 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 in der Konfiguration 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 Anforderungstransformation bereitgestellt werden. Wenn ein Modell an mehreren Stellen angegeben wird, gilt diese Rangfolge:

  1. Ein in der Anforderungstransformation 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.

  4. 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.

  5. Eingabeaufforderung: Geben Sie den Text ein, mit dem Sie das Modell auffordern möchten.

  • RAG-Corpus verwenden (Vertex AI): Wählen Sie diese Option, um Retrieval-Augmented Generation (RAG) Grounding für Eingabeaufforderungen zu aktivieren. Wenn diese Option ausgewählt ist, werden die folgenden Einstellungen verwendet, um einen RAG-Corpus auszuwählen und seine Einstellungen anzugeben.

    Hinweis

    Diese Option erfordert, dass die Google Gemini-Verbindung mit der Plattformoption Vertex AI konfiguriert ist.

    • RAG-Corpus auswählen: Sie können einen RAG-Corpus mit einer dieser beiden Optionen angeben: Alle RAG-Corpora auflisten oder RAG-Corpus-ID eingeben.

      • Alle RAG-Corpora auflisten: Wählen Sie diese Option, um aus einer Liste der im Google Gemini-Endpunkt verfügbaren RAG-Corpora auszuwählen. Wenn diese Option ausgewählt ist, ist diese Tabelle sichtbar:

        • RAG-Corpus auswählen: Dieser Abschnitt zeigt die im Google Gemini-Endpunkt verfügbaren RAG-Corpora an.

          • Ausgewählter RAG-Corpus: Nach der Auswahl eines RAG-Corpus wird er hier aufgelistet.

          • Suche: Geben Sie einen beliebigen Wert aus einer Spalte in das Suchfeld ein, um die Liste der RAG-Corpora zu filtern. Die Suche unterscheidet nicht zwischen Groß- und Kleinschreibung. Wenn RAG-Corpora bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um RAG-Corpora vom Endpunkt neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann wie unten beschrieben.

          • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um RAG-Corpora vom Google Gemini-Endpunkt neu zu laden. Dies kann hilfreich sein, wenn RAG-Corpora zur Gemini Enterprise Agent Platform hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten RAG-Corpus-Tabelle verwendet werden.

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

  • Anzeigename: Der Name des RAG-Corpus.

                -   **Kennung:** Die RAG-Corpus-ID.

        !!! tip "Tipp"
            Wenn die Tabelle nicht mit verfügbaren RAG-Corpora gefüllt wird, ist die [Google Gemini-Verbindung](/de/integration-studio/design/connectors/google-gemini/connection/) möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldedaten erneut testen.

-   **RAG-Corpus-ID eingeben:** Wählen Sie diese Option, um die ID des RAG-Corpus im Google Gemini-Endpunkt anzugeben. Wenn diese Option ausgewählt ist, ist dieses Feld sichtbar:

    -   **RAG-Corpus-Kennung:** Geben Sie die ID des RAG-Corpus ein.

    • Ähnlichkeit Top K: Geben Sie einen Top K-Wert ein, um die Anzahl der kontextuell relevanten RAG-Corpus-Ergebnisse zu bestimmen, die zurückgegeben werden sollen. Der Wert muss größer als 0 sein und beträgt standardmäßig 5.

    • Vektordistanz-Schwellenwert: Geben Sie einen Vektordistanzwert ein, um die kontextuelle Relevanz der RAG-Corpus-Ergebnisse zu bestimmen. Der Wert kann zwischen 0 und 1 liegen, z. B.: 0.7.

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

    • Zufälligkeit und Vielfalt:

      • Temperatur: Geben Sie einen Temperaturparameter ein. Der Wert dieses Parameters kann zwischen 0 und 1 liegen, z. B.: 0.5.
      • Top K: Geben Sie einen Top K-Parameter ein. Der Wert dieses Parameters muss größer als 0 sein und beträgt standardmäßig 40.
      • Top P: Geben Sie einen Top P-Parameter ein. Der Wert dieses Parameters kann zwischen 0 und 1 liegen und beträgt standardmäßig 0.95.

    • Länge:

    • Bei Fehler fortfahren: Wählen Sie diese Option, um die Aktivitätsausführung fortzusetzen, wenn bei einem Datensatz in einer Batch-Anfrage ein Fehler auftritt. Falls Fehler auftreten, werden diese im Operationsprotokoll protokolliert.

  • Speichern und beenden: 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 der letzten Seite auf die Schaltfläche Fertig klicken.

  • Ä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.

Schritt 2: Datenschemas überprüfen

Alle Anfrage- oder Antwortschemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Datenschema: Diese Datenschemas werden von angrenzenden Transformationen geerbt und werden während der Datenzuordnung erneut 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 das gleiche 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 Prompt-Aktivität 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.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Design-Canvas zugänglich. Weitere Informationen finden Sie unter Aktivitätsaktionsmenü in Connector-Grundlagen.

Google Gemini Prompt-Aktivitäten 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 ihn aus und validieren Sie das Verhalten, indem Sie die Vorgangsprotokolle überprüfen.