Zum Inhalt springen

OpenAI Register Tools V2-Aktivität in Jitterbit Studio

Einführung

Eine OpenAI Register Tools V2-Aktivität nutzt ihre OpenAI-Verbindung und fügt einem Assistenten Tools mithilfe der OpenAI Responses API hinzu. Sie ist als Ziel zum Verarbeiten von Daten in einem Vorgang gedacht. 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, sodass jeder Vorgang, der danach ausgeführt wird, automatisch Zugriff auf diese Schemas hat, wenn er eine Prompt V2-Aktivität mit derselben chatId aufruft. Private Agenten speichern dies im Speicher; Cloud-Agent-Gruppen können es über Vorgänge hinweg mithilfe der Einstellung Store chat context across operations (V2 activities only) in der OpenAI-Verbindung persistieren. Du musst die Register Tools V2-Antwort nicht erfassen oder die Tool-Definitionen explizit an den nachfolgenden Prompt V2-Vorgang übergeben.

Hinweis

Eine Register Tools V2-Aktivität erfordert eine Request-Payload mit den zu registrierenden Tool-Schemas; sie kann nicht allein über den Assistenten konfiguriert werden.

Unterstützte OpenAI-Modelle

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

OpenAI-Aktivität „Register Tools V2" erstellen

Eine Instanz einer OpenAI-Aktivität Register Tools V2 wird aus einer OpenAI-Verbindung mit dem Aktivitätstyp Register Tools 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-Aktivität Register Tools V2 kann an folgenden Orten bearbeitet werden:

OpenAI-Aktivität „Register Tools V2" konfigurieren

Führen Sie diese Schritte aus, um eine OpenAI-Aktivität Register Tools V2 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 Eingabetext und das Modell fest. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Endpunkt-Menü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, zeigt ein Menü oben auf dem Bildschirm den Namen des aktuellen Endpunkts an. 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 Namen des aktuellen Endpunkts 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-Aktivität Register Tools V2 eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Chat-ID: Geben Sie die chatId ein. Wenn Sie eine Prompt V2-Aktivität zum Starten einer Konversation verwenden, können Sie die in ihrer Antwort zurückgegebene chatId in eine Variable schreiben, auf die hier verwiesen wird. Wenn Sie keine chatId angeben, wird automatisch eine generiert. In diesem Fall gelten die registrierten Tools nur für eine neue Konversation und nicht für einen vorhandenen Assistenten.

  • Eingabetext: Geben Sie einen Eingabetext ein, der zusammen mit der Registrierungsanfrage gesendet werden soll, um beispielsweise zu beschreiben, wie die registrierten Tools verwendet werden sollen.

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

  • Speichern und beenden: Wenn 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 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 in einem beliebigen 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.

  • Datenschemas: Diese Datenschemas werden von benachbarten 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 OpenAI-Connector verwendet die OpenAI Responses API. Weitere Informationen zu den Schemaknoten und Feldern finden Sie in der API-Dokumentation.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, 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 benachbarten 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 Änderungen an einem Schritt 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 Register Tools 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.

Um einen Tool-Calling-Workflow abzuschließen, verketten Sie einen Prompt V2-Vorgang, der nach diesem ausgeführt wird, und konfigurieren Sie ihn mit derselben chatId. Da Jitterbit die Tool-Schemas zur Verwendung durch diesen Vorgang speichert (im Speicher auf privaten Agenten oder mithilfe der Einstellung Store chat context across operations (V2 activities only) auf Cloud-Agent-Gruppen), erhält der Prompt V2-Vorgang sie automatisch ohne zusätzliche Zuordnung.

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

OpenAI-Aktivitäten Register Tools 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 dann diesen temporären Speicherort 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.