Verbindungen binden und bereitstellen
Verbindungen verknüpfen Tools mit der Authentifizierungsmethode, dem Anmeldemodell und den Umgebungseinstellungen, die für den Zugriff auf externe Anwendungen erforderlich sind. Bevor Tools ausgeführt werden können, muss jedes einzelne einem Verbindungstyp zugeordnet werden, damit es die richtige Identität und Konfiguration verwenden kann. Bei der Bereitstellung des Agenten überprüft „ watsonx Orchestrate “, ob jedes Tool über eine vollständige und gültige Live-Verbindung verfügt. Dieser Prozess trägt dazu bei, ein einheitliches Verhalten über alle Kanäle hinweg zu gewährleisten, und unterstützt eine zuverlässige Ausführung in Produktionsumgebungen.
Verbindungen zu Werkzeugen herstellen
Tools müssen mit einer Verbindung verknüpft sein, bevor sie auf eine Drittanbieteranwendung zugreifen können. Durch die Bindung werden die Vorgänge des Tools mit einer bestimmten Verbindung verknüpft, die den Authentifizierungstyp, das Anmeldemodell (Team oder Mitglied) und die Umgebungseinstellungen (Entwurf und Live) bereitstellt. Eine einzelne Verbindung kann von mehreren Tools wiederverwendet werden, und die Zuordnung der Tools kann je nach sich ändernden Integrationsanforderungen aufgehoben oder neu vorgenommen werden. Vor der Bereitstellung muss für jedes Tool in einem Agenten eine Live-Verbindung konfiguriert sein; die Bereitstellung wird blockiert, wenn für ein Tool keine gültige Live-Bindung vorhanden ist.
Eine bestehende Verbindung herstellen
Um ein Tool mit einer Verbindung zu verknüpfen, die auf der Seite „Verbindungen“ vorhanden ist, führen Sie die folgenden Schritte aus. Dieser Ablauf kommt zum Tragen, wenn Sie ein Werkzeug importieren (beispielsweise aus einer „ OpenAPI “-Spezifikation) und es einer verfügbaren Verbindung zuordnen möchten.
Gehen Sie im Menü auf
„Build “.Gehen Sie zu „Alle Agenten “.
Suchen Sie Ihren Makler und klicken Sie darauf.
Klicken Sie im Abschnitt „Toolset “ unter den Agent-Tools auf „Tool hinzufügen “.
Wählen Sie „Open API“ aus.
Laden Sie die Datei „ OpenAPI “ für die Anwendung hoch, die Sie integrieren möchten. Die hochgeladene Spezifikation legt die Authentifizierungsart und das unterstützte Sicherheitsschema für das Tool fest.
Klicken Sie auf Weiter. Der Werkzeugimport analysiert die Spezifikation und listet alle verfügbaren Bearbeitungsvorgänge auf.
Wählen Sie die Vorgänge aus, die Sie in das Tool aufnehmen möchten, und klicken Sie dann auf „Weiter “.
Sehen Sie sich die angezeigte Liste der relevanten Verbindungen an.
watsonx Orchestrate erkennt automatisch Verbindungen, deren Authentifizierungstyp und Sicherheitsschema mit der Datei „ OpenAPI “ übereinstimmen, und schlägt diese vor.
Verbindungen, die dem erforderlichen Sicherheitsschema entsprechen, werden als zulässig angezeigt.
„Verbindung ausstehend“ oder „Konfiguration ausstehend“ bedeutet, dass die Konfiguration oder die Anmeldedaten unvollständig sind und nicht ausgewählt werden können.
Wenn keine der vorhandenen Verbindungen geeignet ist, können Sie „Neues Element hinzufügen “ auswählen, um direkt in diesem Fenster eine neue Verbindung zu erstellen, ohne den Tool-Einrichtungsablauf zu verlassen.
Wählen Sie eine vorhandene Verbindung aus der Liste aus, um sie mit dem Tool zu verknüpfen.
Es können nur vollständig konfigurierte und gültige Verbindungen ausgewählt werden. Die Verwendung einer unvollständigen Verbindung führt dazu, dass die Ausführung des Tools fehlschlägt.
Klicken Sie auf Done (Fertig).
Das Werkzeug wird zum Werkzeugsatz hinzugefügt, und die verknüpfte Verbindung wird im Abschnitt „Verbindung“ des Werkzeugs angezeigt. Sie können eine Vorschau des Tools anzeigen, um zu überprüfen, ob es im Vorschau-Chat die Entwurfsumgebung der Verbindung verwendet.
Nachdem die Verbindung hergestellt wurde, passt sich das Tool an das Umgebungsverhalten der Verbindung an, und Sie können während des Testens und der Bereitstellung überprüfen, wie dies umgesetzt wird:
Das Tool nutzt die Entwurfsverbindung, wenn es im Vorschau-Chat getestet wird.
Nach der Bereitstellung nutzt das Tool die Konfiguration der Live-Verbindung
In der Ansicht „Details bearbeiten “ des Tools werden auf der Registerkarte „Konnektoren“ die verknüpften Verbindungen sowie deren Status („Entwurf“ und „Live“) angezeigt. Außerdem stehen Optionen zum Bearbeiten und Löschen zur Verfügung, sodass Sie die Verbindung bei Bedarf aktualisieren oder aufheben können.
Die Bereitstellung schlägt fehl, wenn ein Tool im Agenten keine gültige Live-Verbindung hat.
Voraussetzungen für die Bereitstellung von Agenten mit Live-Verbindungen.
Bevor Sie einen Agenten bereitstellen können, muss jedes Tool im Agenten mit einer Verbindung verknüpft sein, die über eine vollständig konfigurierte Live-Umgebung verfügt. Die Live-Umgebung definiert die Verbindungskonfiguration, die der Agent in Produktionskanälen wie dem Portal-Chat, Slack, Microsoft Teams und dem eingebetteten Chat verwendet. Wenn bei einem Tool keine gültige Live-Verbindung besteht, kann die Bereitstellung nicht fortgesetzt werden.
watsonx Orchestrate führt während der Bereitstellung eine Überprüfung der Verbindungsgültigkeit durch. Diese Prüfung bestätigt die folgenden Bedingungen:
Jedes Tool ist an eine Verbindung gebunden
Die gebundene Verbindung verfügt über eine vollständige Live-Konfiguration
Es sind gültige Live-Zugangsdaten (Team oder Mitglied) vorhanden
Die Authentifizierung für die Live-Verbindung war erfolgreich
Keine Umgebung befindet sich im Status „Ausstehend“ oder „Fehler“
Wenn eine Live-Konfiguration unvollständig ist – beispielsweise aufgrund fehlender URLs, falscher Metadaten, fehlender Anmeldedaten oder Authentifizierungsfehler –, wird der Bereitstellungsworkflow angehalten und es wird eine Fehlermeldung angezeigt. Sie müssen die Verbindungseinstellungen korrigieren, bevor Sie es erneut versuchen. Weitere Informationen zur Bereitstellung von Agenten mit Live-Verbindung finden Sie unter „Bereitstellung von Agenten “.