Zum Inhalt springen

OpenAI Prompt (Veraltet) Aktivität in Jitterbit Studio

Warnung

Die Aktivität Prompt (Veraltet) ist veraltet und wird nicht mehr unterstützt. In einer zukünftigen Version wird diese Aktivität dauerhaft entfernt. Sie wurde in der Version 12.8 durch die neu gestaltete Prompt V2 Aktivität ersetzt, deren Verwendung von OpenAIs Responses API es ermöglicht, den Chat-Kontext beizubehalten und registrierte Tools auf Cloud-Agent-Gruppen aufzurufen, nicht nur auf private Agenten.

Einführung

Eine OpenAI Prompt Aktivität generiert mit ihrer OpenAI-Verbindung eine Chat-Vervollständigung für den bereitgestellten Prompt in OpenAI und ist als Ziel zum Verarbeiten von Daten in einem Vorgang gedacht.

Wichtig

Um Chat-Verlauf zu verwalten, muss man einen privaten Agenten verwenden, um den Konversationskontext zwischen API-Aufrufen beizubehalten.

Um externe Tools und Datenquellen dynamisch zu erkennen und aufzurufen, ohne für jedes System einen dedizierten Connector zu erstellen, nutze die Prompt V2 Aktivität zusammen mit einer Register Tools V2 oder Register MCP Server Tools Aktivität.

Unterstützte OpenAI-Modelle

Diese Aktivität kann für die Verwendung eines dieser OpenAI Modelle konfiguriert werden:

OpenAI-Prompt-Aktivität erstellen

Eine Instanz einer OpenAI-Prompt-Aktivität wird aus einer OpenAI-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 Aktivitäts- oder Tool-Instanz erstellen in Komponentenwiederverwendung.

Eine vorhandene OpenAI-Prompt-Aktivität kann von diesen Orten aus bearbeitet werden:

OpenAI-Prompt-Aktivität konfigurieren

Führen Sie diese Schritte aus, um eine OpenAI-Prompt-Aktivität zu konfigurieren:

Schritt 1: Namen eingeben und Einstellungen festlegen

Geben Sie in diesem Schritt einen Namen für die Aktivität an und legen Sie den Prompt-Text und optionale Einstellungen fest. 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 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 OpenAI-Prompt-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Prompt-Text: Geben Sie den Prompt ein, der für die Vervollständigungen verwendet werden soll.

  • Modell: Verwenden Sie das Menü, um ein unterstütztes OpenAI-Modell auszuwählen. Das Standardmodell ist gpt-4.

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

    • Rolle: Wählen Sie die Rolle des Prompts, entweder Assistent, System, Tool oder Benutzer:

      • Assistent: Ein Assistent (das Modell) antwortet auf den Prompt des Benutzers. Ein Assistent-Prompt speichert vorherige Assistent-Antworten oder kann von Ihnen geschrieben werden, um Beispiele für das gewünschte Verhalten zu geben. Dies ist ein Beispiel für einen Assistent-Prompt:

Sie haben umfangreiche Kenntnisse des Französischen des 16. Jahrhunderts.

  • System: (Standard.) Ein System-Prompt legt das Verhalten des Assistenten fest. Sie können die Persönlichkeit des Assistenten ändern oder spezifische Anweisungen geben, wie er sich verhalten soll. Dies ist ein Beispiel für einen System-Prompt:

    Wenn ich Sie um Hilfe beim Schreiben von etwas bitte, antworten Sie mit einem Dokument, das in jedem Absatz mindestens einen Witz oder einen humorvollen Kommentar enthält.

  • Tool: Ein Tool-Prompt ist das, was ein Assistent verwendet, um OpenAI aufzufordern, ein Tool zu verwenden, das mit der Aktivität „Tools registrieren" registriert wurde. Dies ist ein Beispiel für einen Tool-Prompt:

    Verwenden Sie das Converter-Tool und sagen Sie mir, wie viel 200 Dollar in brasilianischer Währung wert sind.

    Mehrere gleichzeitige Tool-Aufrufe

    Wenn OpenAI eine einzelne Assistentennachricht mit mehreren Tool-Aufrufen zurückgibt, verwenden Sie eine Prompt-Aktivitätsinstanz (konfiguriert mit der Rolle Tool), um alle entsprechenden Tool-Antworten zurückzugeben, anstatt für jeden Tool-Aufruf eine separate Aktivitätsinstanz zu erstellen. Ordnen Sie die Transformation, die die Aktivität speist, so zu, dass sie eine Zeile pro Tool-Aufruf ausgibt, wobei der Inhalt jeder Zeile die Antwort dieses Tool-Aufrufs enthält. Wenn die Aktivität ausgeführt wird, sendet sie die frühere Assistentennachricht einmal, gefolgt von jeder Zeilen-Tool-Antwort in Reihenfolge, abgeglichen nach ihrer tool_call_id, unter Verwendung derselben chatId wie der Rest der Konversation.

  • User: Ein User-Prompt ist eine Anfrage an den Assistenten. Dies ist ein Beispiel für einen User-Prompt:

    Schreiben Sie eine Markdown-Liste von Katzenrassen und ein Persönlichkeitsmerkmal für jede Rasse.

  • Temperature: Geben Sie die Sampling-Temperature ein. Der Wert muss eine Dezimalzahl zwischen 0 und 2 sein. Es wird nicht empfohlen, diese Einstellung mit Top Probability zu verwenden. Diese Einstellung wird nicht mit GPT-5.6-Modellen unterstützt.

  • Max Tokens: Geben Sie die maximale Anzahl der zu verwendenden Tokens ein.

  • Top Probability: Geben Sie die Top Probability ein. Es wird nicht empfohlen, diese Einstellung mit Temperature zu verwenden. Diese Einstellung wird nicht mit GPT-5.6-Modellen unterstützt.

  • Continue on Error: 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 in das Operationsprotokoll geschrieben.

  • Save & Exit: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Next: 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 Finished klicken.

  • Discard changes: Klicken Sie nach Ä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: Überprüfen Sie die Datenschemas

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

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

    Hinweis

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

    Der OpenAI-Connector verwendet die OpenAI Chat Completions API. Weitere Informationen zu den Schemaknoten und Feldern finden Sie in der API-Dokumentation.

  • Refresh: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Refresh, um Schemas vom OpenAI-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: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, 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 OpenAI-Aktivität Prompt schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten oder Tools 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 Designoberfläche zugänglich. Weitere Informationen finden Sie unter Aktivitätsaktionsmenü in Connector-Grundlagen.

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