Zum Inhalt springen

OpenAI Prompt V2-Aktivität in Jitterbit Studio

Einführung

Eine OpenAI Prompt V2-Aktivität verwendet ihre OpenAI-Verbindung und erstellt eine Antwort für die bereitgestellte Eingabeaufforderung mithilfe der OpenAI Responses API. Sie ist als Ziel zum Verarbeiten von Daten in einem Vorgang gedacht. Prompt V2 funktioniert wie die OpenAI Prompt-Aktivität, bietet aber zusätzlich ein Assistent-Feld Chat ID, umfangreichere Antwortdaten und die Möglichkeit, Tools aufzurufen, die von einer vorherigen Register Tools V2- oder Register MCP Server Tools-Aktivität mit derselben chatId registriert wurden.

Hinweis

Eine Prompt V2-Aktivität hat nur Zugriff auf Tools, die von einer Register Tools V2- oder Register MCP Server Tools-Aktivität registriert wurden. Sie kann keine Tools verwenden, die von der ursprünglichen Register Tools-Aktivität registriert wurden.

Tipp

Um den Chat-Verlauf über Vorgänge hinweg zu verwalten, speichern private Agenten den Chat-Kontext automatisch im Speicher. Aktivieren Sie für Cloud-Agent-Gruppen die Einstellung Store chat context across operations (V2 activities only) in der OpenAI-Verbindung-Konfiguration.

Unterstützte OpenAI-Modelle

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

OpenAI Prompt V2-Aktivität erstellen

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

OpenAI Prompt V2-Aktivität konfigurieren

Führen Sie diese Schritte aus, um eine OpenAI Prompt V2-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 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 OpenAI Prompt V2-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Chat-ID: Geben Sie die chatId ein. Wenn Sie diese Aktivität nach einer Register Tools V2- oder Register MCP Server Tools-Aktivität verketten, verwenden Sie dieselbe chatId, damit diese Aktivität Zugriff auf die von dieser Aktivität registrierten Tools hat. Wenn Sie keine chatId angeben, wird automatisch eine generiert.

  • Prompt-Text: Geben Sie den Prompt ein, der für die Antwort 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 aus: Assistant, System, Tool oder User:

    -   **Assistant:** Ein Assistant (das [Modell](https://platform.openai.com/docs/models/models)) antwortet auf den Prompt des Benutzers. Ein Assistant-Prompt speichert vorherige Assistant-Antworten oder kann von Ihnen geschrieben werden, um Beispiele für das gewünschte Verhalten zu geben. Dies ist ein Beispiel für einen Assistant-Prompt:

    `You have an extensive knowledge of 16th century French.`

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

    `When I ask for help to write something, you will reply with a document that contains at least one joke or playful comment in every paragraph.`

-   **Tool:** Ein Tool-Prompt ist das, was ein Assistant verwendet, um OpenAI aufzufordern, ein [Tool](https://platform.openai.com/docs/guides/agents#tools) zu verwenden, das mit einer [Register Tools V2](/de/integration-studio/design/connectors/openai/register-tools-v2-activity/)- oder [Register MCP Server Tools](/de/integration-studio/design/connectors/openai/register-mcp-server-tools-activity/)-Aktivität registriert wurde. Dies ist ein Beispiel für einen Tool-Prompt:

    `Use the Converter tool and tell me how much are 200 dollars worth in Brazilian currency`.

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

    `Write a Markdown list of cat breeds and a personality trait for each breed.`

    • Temperature: Geben Sie die Sampling-Temperatur ein. Der Wert muss eine Dezimalzahl zwischen 0 und 2 sein. Es wird nicht empfohlen, diese Einstellung zusammen mit Top Probability zu verwenden. Diese Einstellung wird bei GPT-5.6-Modellen nicht 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 zusammen mit Temperature zu verwenden. Diese Einstellung wird bei GPT-5.6-Modellen nicht unterstützt.

  • Continue on Error: Wählen Sie diese Option, um die Ausführung der Aktivität fortzusetzen, wenn bei einer Anfrage 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 die Schaltfläche Finished im letzten Schritt 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: Datenschemas überprüfen

Alle Request- oder Response-Schemas 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 Responses 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: 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 OpenAI-Aktivität Prompt V2 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 Menü „Aktivitätsaktionen" in Connector-Grundlagen.

OpenAI-Aktivitäten Prompt V2 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.