Zum Inhalt springen

OpenAI Register Tools (Veraltet) Aktivität in Jitterbit Studio

Warnung

Die Aktivität Register Tools (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 Register Tools V2 Aktivität ersetzt, deren Verwendung von OpenAIs Responses API es ermöglicht, Tool-Registrierungen über Operationen hinweg auf Cloud-Agent-Gruppen beizubehalten, nicht nur auf privaten Agenten.

Einführung

Eine OpenAI Register Tools Aktivität nutzt ihre OpenAI-Verbindung und fügt Tools zu einem Assistenten in OpenAI hinzu. Sie ist als Ziel zum Verarbeiten von Daten in einer Operation 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 die Operation ausgeführt wird, speichert Jitterbit die registrierten Tool-Schemas im Speicher auf dem privaten Agent. Jede Operation, die danach ausgeführt wird, hat automatisch Zugriff auf diese Schemas, wenn sie das LLM aufruft. Sie müssen die Register Tools Antwort nicht erfassen oder die Tool-Definitionen explizit an die nachfolgende Prompt Operation übergeben.

Derzeit werden diese Tools unterstützt:

Wichtig

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

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

Unterstützte OpenAI-Modelle

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

OpenAI-Aktivität „Register Tools" erstellen

Eine Instanz einer OpenAI-Aktivität Register Tools wird aus einer OpenAI-Verbindung mit dem 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 Aktivitäts- oder Tool-Instanz erstellen in Komponenten wiederverwenden.

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

OpenAI-Aktivität „Register Tools" konfigurieren

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

  • Chat-ID: Geben Sie die chatId ein. Wenn Sie eine Prompt-Aktivität verwenden, um ein Gespräch zu starten, können Sie die in ihrer Antwort zurückgegebene chatId in eine Variable schreiben, um hier darauf zu verweisen. Wenn Sie keine chatId angeben, wird automatisch eine generiert. In diesem Fall gelten die registrierten Tools nur für ein neues Gespräch und nicht für einen vorhandenen Assistenten.

  • Modell: Wählen Sie über das Menü ein unterstütztes OpenAI-Modell aus. Das Standardmodell ist gpt-4.

  • Speichern & 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 die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Klicken Sie nach Änderungen, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt 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.

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

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder 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 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 Änderungen, um die Konfiguration zu schließen, ohne die Ä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 Tools registrieren 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-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.

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 Menü „Aktivitätsaktionen" in Connector-Grundlagen.

OpenAI-Aktivitäten Tools registrieren 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.