Zum Inhalt springen

OpenAI Register Tools-Aktivität in Jitterbit Studio

Einführung

Eine OpenAI Register Tools-Aktivität, die ihre OpenAI-Verbindung verwendet, fügt einem Assistenten in OpenAI Werkzeuge hinzu und ist dazu gedacht, als Ziel verwendet zu werden, um Daten in einem Vorgang zu konsumieren. Werkzeug-Schemas können aus der List Tools-Aktivität des MCP Client-Connectors bezogen oder direkt über die Anforderungsumwandlung als benutzerdefinierte Funktionsdefinitionen bereitgestellt werden.

Wenn der Vorgang ausgeführt wird, speichert Jitterbit die registrierten Werkzeug-Schemas im Speicher des privaten Agents. Jeder Vorgang, der nach diesem ausgeführt wird, hat automatisch Zugriff auf diese Schemata, wenn er das LLM aufruft. Es ist nicht erforderlich, die Register Tools-Antwort zu erfassen oder die Werkzeugdefinitionen explizit an den nachfolgenden Prompt-Vorgang weiterzugeben.

Derzeit werden folgende Werkzeuge unterstützt:

Wichtig

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

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

Unterstützte OpenAI-Modelle

Diese Aktivität kann so konfiguriert werden, dass eines dieser OpenAI Modelle verwendet wird:

Erstellen Sie eine OpenAI Register Tools-Aktivität

Eine Instanz einer OpenAI Register Tools-Aktivität wird aus einer OpenAI-Verbindung unter Verwendung des Aktivitätstyps Register Tools erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfsfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Entwurfsfläche ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.

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

Konfigurieren Sie eine OpenAI Register Tools-Aktivität

Befolgen Sie diese Schritte, um eine OpenAI Register Tools-Aktivität zu konfigurieren:

Schritt 1: Geben Sie einen Namen ein und spezifizieren Sie die Einstellungen

In diesem Schritt geben Sie einen Namen für die Aktivität ein und spezifizieren den Eingabetext und das Modell. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

  • Endpoint-Menü: Wenn Sie mehrere Endpunkte des gleichen Verbindungstyps konfiguriert haben, wird ein Menü oben auf dem Bildschirm angezeigt, das den aktuellen Endpunktnamen anzeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Ändern des zugewiesenen Endpunkts in Konfigurationsbildschirme.

  • Endpunkt bearbeiten: Erscheint, wenn Sie über den aktuellen Endpunktnamen fahren. Klicken Sie, um die Verbindungs-Konfiguration 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 Tools registrieren-Aktivität einzigartig 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 beginnen, können Sie die chatId, die in der Antwort zurückgegeben wird, in eine Variable schreiben, die hier referenziert wird. 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 bestehenden Assistenten.

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

  • Speichern & 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 fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Schritt 2: Überprüfen der Datenschemas

Alle Anfrage- oder Antwortschemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

  • Datenschemas: Diese Datenschemas werden von benachbarten Transformationen übernommen und 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 API. Konsultieren Sie die API-Dokumentation für Informationen zu den Schema-Knoten und -Feldern.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemata vom OpenAI-Endpunkt neu zu generieren. Diese Aktion regeneriert auch ein Schema an anderen Stellen im Projekt, wo dasselbe Schema referenziert wird, wie zum Beispiel 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: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Nächste Schritte

Nachdem Sie eine OpenAI Tools registrieren-Aktivität konfiguriert haben, vervollständigen Sie die Konfiguration der Operation, indem Sie andere Aktivitäten oder Tools als operationale Schritte hinzufügen und konfigurieren. Sie können auch die Betriebseinstellungen konfigurieren, die die Möglichkeit umfassen, Operationen zusammenzuführen, die sich in denselben oder unterschiedlichen Workflows befinden.

Um einen Workflow zum Aufrufen eines Tools abzuschließen, verknüpfen Sie eine Prompt-Operation, die nach dieser ausgeführt wird, und konfigurieren Sie sie mit derselben chatId. Da Jitterbit die Tool-Schemata im Speicher des privaten Agents speichert, erhält die Prompt-Operation sie automatisch, ohne dass eine zusätzliche Zuordnung erforderlich ist.

Um einen Workflow zum Aufrufen eines Tools abzuschließen, verknüpfen Sie eine Prompt-Operation, die nach dieser ausgeführt wird, und konfigurieren Sie sie mit derselben chatId. Da Jitterbit die Tool-Schemata im Speicher des privaten Agents speichert, erhält die Prompt-Operation sie automatisch, ohne dass eine zusätzliche Zuordnung erforderlich ist.

Menüaktionen für eine Aktivität sind über das Projektfenster und die Entwurfskanvas zugänglich. Weitere Informationen finden Sie im Aktivitätsaktionsmenü in Connector-Grundlagen.

OpenAI Tools registrieren-Aktivitäten können als Ziel mit diesen Betriebsmustern verwendet werden:

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Ort und verwenden Sie dann diesen temporären Ort in der Skriptfunktion.

Wenn Sie bereit sind, setzen Sie die Operation ein und führen Sie sie aus und validieren Sie das Verhalten, indem Sie die Betriebsprotokolle überprüfen.