watsonx Assistant-API im Überblick

Mit den watsonx Assistant-REST-APIs und den entsprechenden SDKs können Sie Anwendungen entwickeln, die mit dem Service interagieren.

Clientanwendungen

Um einen virtuellen Assistenten oder eine andere Client-Anwendung zu erstellen, die zur Laufzeit mit einem Assistenten kommuniziert, verwenden Sie die v2. Sie können einen kundenorientierten Client entwickeln, der für den Produktionseinsatz implementiert werden kann, eine Anwendung, die die Kommunikation zwischen einem Assistenten und einem anderen Service vermittelt, oder eine Testanwendung.

Bei Verwendung der Laufzeit-API der Version 2 für die Kommunikation mit Ihrem Assistenten kann Ihre Anwendung die folgenden Funktionen und Vorteile nutzen:

  • Automatisches Statusmanagement. Die v2 verwaltet jede Sitzung mit einem Benutzer und speichert und verwaltet alle Kontextdaten, die Ihr Assistent für eine vollständige Konversation benötigt.

  • Einfache Bereitstellung von Assistenten. Neben der Unterstützung von angepassten Clients kann ein Assistent problemlos in gängigen Nachrichtenkanälen wie Slack und Facebook Messenger bereitgestellt werden.

  • Versionierung. Sie können einen Schnappschuss Ihrer Inhalte speichern und Ihren Assistenten mit dieser speziellen Version verknüpfen. Sie können anschließend mit der Aktualisierung Ihrer Entwicklungsversion ohne Auswirkungen auf den Assistenten in der Produktionsumgebung fortfahren.

  • Suchfunktionen. Die v2-Laufzeit-API kann verwendet werden, um Antworten von der Suchintegration zu empfangen. Wenn eine Abfrage übergeben wird, die Ihr Assistent nicht beantworten kann, kann die Suchintegration die beste Antwort aus den konfigurierten Datenquellen finden.

Weitere Informationen finden Sie in der API-Referenz zuwatsonx Assistant v2.

Die watsonx Assistant v1 API unterstützt die Methode /message, die Benutzereingaben direkt an den Arbeitsbereich eines Dialogs sendet. Die v1 wird hauptsächlich aus Kompatibilitätsgründen unterstützt. Wenn Sie die Methode /message der Version 1 verwenden, müssen Sie ein eigenes Statusmanagement implementieren und Sie können weder die Versionierung noch eine der anderen Funktionen eines Assistenten verwenden.

Authoring-Anwendungen

Die v1 bietet Methoden, die es einer Anwendung ermöglichen, Dialogfertigkeiten zu erstellen oder zu ändern, als Alternative zur grafischen Erstellung einer Fertigkeit über die klassische Benutzeroberfläche Watson Assistant. Eine Authoring-Anwendung nutzt die API zum Erstellen und Ändern von Skills, Absichten, Entitäten, Dialogmodulknoten und anderen Artefakten, aus denen ein Dialogskill besteht. Weitere Informationen finden Sie in der v1.

Die v1 erstellen und ändern Arbeitsbereiche anstelle von Fähigkeiten. Ein Arbeitsbereich ist ein Container für die Dialog- und Trainingsdaten (z. B. Absichten und Entitäten) innerhalb eines Dialogskills. Wenn Sie einen neuen Arbeitsbereich mit Hilfe der API erstellen, erscheint er als neue Dialogfähigkeit in der klassischen Watson Assistant Benutzeroberfläche.

Eine Liste der verfügbaren API-Methoden finden Sie unter Zusammenfassung der API-Methoden.