Zum Inhalt springen

Azure OpenAI Register Tools-Aktivität in Jitterbit Studio

Einführung

Eine Azure OpenAI Register Tools-Aktivität verwendet ihre Azure OpenAI-Verbindung und fügt Tools zu einem Assistenten in Azure OpenAI 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 im Speicher des Agenten. Jeder Vorgang, der nach diesem ausgeführt wird, hat automatisch Zugriff auf diese Schemas, wenn er das LLM aufruft. Sie müssen die Register Tools-Antwort nicht erfassen oder die Tool-Definitionen explizit an den nachfolgenden Prompt-Vorgang übergeben.

Die folgenden Tools werden derzeit unterstützt:

Eine Azure OpenAI Register Tools-Aktivität erstellen

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

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

Eine Azure OpenAI Register Tools-Aktivität konfigurieren

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

  • 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 Den 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 Azure OpenAI Register Tools-Aktivität 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, generiert die Aktivität automatisch eine, aber das Tool wird nicht mit vorhandenen Assistenten oder früheren Gesprächsverlauf verknüpft.

    Tipp

    Wenn Sie Cloud-Agent-Gruppen mit der Option Store chat context across operations verwenden, die in der Verbindungskonfiguration aktiviert ist, nutzen Sie dieselbe chatId über mehrere Operationen hinweg in derselben Umgebung, um den Gesprächsverlauf beizubehalten. Bei privaten Agents wird der Chat-Kontext im lokalen Speicher für Operationen innerhalb derselben Operationskette beibehalten, die dieselbe chatId verwenden.

  • Model ID: Wählen Sie das zu verwendende Modell aus. Die Bereitstellungen Ihrer Azure OpenAI-Instanz füllen die Modellliste auf. Klicken Sie auf Refresh, um die Liste zu aktualisieren, wenn Sie neue Modelle bereitgestellt haben, seit Sie diese Konfiguration geöffnet haben. Modelle müssen zunächst in Azure bereitgestellt werden, um als Optionen angezeigt zu werden. Informationen zur Bereitstellung von Modellen finden Sie in der Microsoft-Dokumentation.

  • 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: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, 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: Ü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 Azure OpenAI-Connector verwendet die Azure OpenAI Service REST API. Weitere Informationen zu den Schemaknoten und Feldern finden Sie in der API-Dokumentation.

  • Refresh: Klicken Sie auf das Aktualisierungssymbol oder das Wort Refresh, um Schemas vom Azure 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.

  • Back: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Finished: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Discard changes: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, 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.

Nächste Schritte

Nach der Konfiguration einer Azure OpenAI-Aktivität Register Tools schließen Sie die Konfiguration der Operation ab, indem Sie weitere Aktivitäten oder Tools als Operationsschritte hinzufügen und konfigurieren. Sie können auch die Operationseinstellungen konfigurieren, die die Möglichkeit beinhalten, Operationen zu verketten, die sich in denselben oder verschiedenen Workflows befinden.

Um einen Tool-Calling-Workflow abzuschließen, verketten Sie eine Prompt-Operation, die nach dieser ausgeführt wird, und konfigurieren Sie sie mit derselben chatId. Da Jitterbit die Tool-Schemas im Speicher des Agents speichert, erhält die Prompt-Operation 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.

Azure OpenAI-Aktivitäten Register Tools können als Ziel mit diesen Operationsmustern 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 alles bereit ist, stellen Sie die Operation bereit und führen Sie sie aus und validieren Sie das Verhalten, indem Sie die Operationsprotokolle überprüfen.