Oracle Digital Assistant Chatbot mit Headless Oracle Content Management erstellen

Einführung

Oracle Digital Assistant ist eine Plattform, mit der Sie digitale Assistenten erstellen und bereitstellen können. Hierbei handelt es sich um KI-gesteuerte Schnittstellen, die Benutzer bei verschiedenen Aufgaben über natürliche Sprachunterhaltungen unterstützen. Aber was passiert, wenn Sie ein Content-Management-System (CMS) benötigen, um all Ihre Inhalte zu bedienen? Glücklicherweise bietet Oracle Content Management mit den umfassenden, Headless-CMS-Funktionen eine elegante Lösung für all Ihre Anforderungen in Bezug auf Inhaltsverwaltung und -Governance.

In diesem Tutorial erstellen wir einen Chatbot in Oracle Digital Assistant, indem wir Oracle Content Management als Headless-CMS und sein Software-Entwicklungskit (SDK) für die Inhaltsbereitstellung in JavaScript verwenden. Dieses Chatbot-Beispiel ist auf GitHub verfügbar.

Das Tutorial umfasst vier Schritte:

  1. Oracle Content Management vorbereiten
  2. Fähigkeiten von Oracle Digital Assistant erstellen
  3. Webanwendung für Ihren Chatbot einrichten
  4. Anwendung bereitstellen

Voraussetzungen

Bevor Sie mit diesem Tutorial fortfahren, sollten Sie zuerst die folgenden Informationen lesen:

Um diesem Tutorial zu folgen, benötigen Sie Folgendes:

Unser Aufbau

Unser Chatbot-Beispiel besteht aus einer einzelnen Landingpage mit einem Bot, mit dem Benutzer Vertriebssicherheiten suchen können. Besucher können den Sales Enablement-Bot auffordern, eine Liste mit Menüelementen, Kategorien in einer Menüoption anzuzeigen oder Geschichten und Ankündigungen abzurufen, die für eine Suchabfrage relevant sind.

Im Folgenden finden Sie den Endstatus unseres Tutorials, einem ODA-Chatbot, der Inhalte von Oracle Content Management konsumiert:

https://headless.mycontentdemo.com/samples/oce-oda-sample/

So sieht die Landingpage und der Sales Enablement-Bot am Ende dieses Tutorials aus:

Diese Abbildung zeigt eine Landingpage mit geöffnetem Chatbot-Fenster "Sales Enablement" und einer fortlaufenden Unterhaltung.

Content Management - ODA-Chatbot-Ablauf

Der Fluss des Content Management ODA-Chatbot-Beispiels lautet wie folgt:

  1. Der Client sendet eine Anforderung an den ODA-Kanal über die Chatbot-Schnittstelle.

  2. Dem ODA-Kanal ist eine Qualifikation zugeordnet, die diese Benutzeranforderung auflöst.

  3. Basierend auf der aufgelösten Entity oder dem aufgelösten Intent kann der ODA-Skill verschiedene Aktionen ausführen:

    • Wenn die aufgelöste Entity einen Kategoriewert enthält, gilt Folgendes:
      • ODA ruft Content Management mit dem benutzerdefinierten Komponentenservice auf.
      • Der benutzerdefinierte Komponentenservice verwendet den Kategoriewert und die Serverkonfiguration für die Content Management-Instanz und sendet eine Anforderung an die Instanz
      • Dann sendet die Instanz eine Antwort an den benutzerdefinierten Komponentenservice zurück, der dann von ODA an den Client gesendet wird.
    • Andernfalls sendet ODA abhängig vom definierten Unterhaltungsablauf eine Nachricht.

  4. Die vom Client empfangene Antwort wird vom Web-SDK wiedergegeben und dem Benutzer angezeigt.

Nach Abschluss dieses Tutorials erfahren Sie, wie Sie eine Chatbot-Anwendung mit Oracle Content Management erstellen können.

Aufgabe 1: Oracle Content Management vorbereiten

Wenn noch keine Oracle Content Management-Instanz vorhanden ist, finden Sie unter Schnellstart Informationen zur Registrierung für Oracle Cloud, zur Bereitstellung einer Oracle Content Management-Instanz und zur Konfiguration von Oracle Content Management als Headless CMS.

Für dieses Tutorial müssen Sie ein Contentmodell erstellen. Es ist ein herunterladbares Asset Pack verfügbar, das Ihr leeres Repository mit Inhaltstypen und zugehörigen Inhalten ausfüllt.

So bereiten Sie Oracle Content Management vor:

  1. Kanal- und Asset-Repository erstellen
  2. Oracle Content Management-Beispielassetpaket importieren

Kanal- und Asset-Repository erstellen

Sie müssen zunächst einen Kanal und ein Asset-Repository in Oracle Content Management erstellen, damit Sie Inhalte veröffentlichen können.

So erstellen Sie einen Kanal und ein Asset-Repository in Oracle Content Management:

  1. Melden Sie sich als Administrator bei der Oracle Content Management-Webbenutzeroberfläche an.

  2. Wählen Sie im linken Navigationsmenü die Option Inhalt und dann in der Auswahlliste im Seitenheader die Option Kanäle veröffentlichen aus.

    Diese Abbildung zeigt die Option "Veröffentlichungskanäle", die im Dropdown-Menü im Header der Inhaltsseite ausgewählt wurde.

  3. Klicken Sie in der oberen rechten Ecke auf Create, um einen neuen Kanal zu erstellen. Benennen Sie den Kanal "ODAChatbotChannel" für dieses Tutorial, und behalten Sie den Zugriff öffentlich. Klicken Sie auf Save, um den Channel zu erstellen.

    Diese Abbildung zeigt den Bereich für die Veröffentlichungskanaldefinition mit dem Wert "ODAChatbotChannel" im Feld für den Kanalnamen.

  4. Wählen Sie im linken Navigationsmenü die Option Inhalt, und wählen Sie in der Auswahlliste im Seitenheader die Option Repositorys aus.

    Diese Abbildung zeigt die Option "Repositorys", die im Dropdown-Menü im Header der Inhaltsseite ausgewählt wurde.

  5. Klicken Sie in der oberen rechten Ecke auf Erstellen, um ein neues Asset-Repository zu erstellen. Benennen Sie das Asset-Repository "ODAChatbotRepository" für den Zweck dieses Tutorials.

    Diese Abbildung zeigt den Bereich für die Repository-Definition mit "ODAChatbotRepository" im Feld für den Repository-Namen.

  6. Wählen Sie im Feld Veröffentlichungskanäle den Kanal ODAChatbotChannel aus, um Oracle Content Management anzugeben, dass Inhalte im Repository ODAChatbotRepository im Kanal ODAChatbotChannel veröffentlicht werden können. Klicken Sie anschließend auf Speichern.

    Diese Abbildung zeigt den Bereich für die Repository-Definition mit "ODAChatbotChannel" im Feld "Veröffentlichungskanäle".

Oracle Content Management-Beispielassetpaket importieren

Sie können ein vorkonfiguriertes Content Management-Beispielassetspaket herunterladen, das alle erforderlichen Inhaltstypen, Assets und Taxonomien für dieses Tutorial enthält.

Sie können eine Kopie des Inhalts, den wir in diesem Tutorial verwenden, aus dem Content Management Samples Asset Pack hochladen. Auf diese Weise können Sie mit den Inhaltstypen experimentieren und den Inhalt ändern. Wenn Sie das Content Management Samples Asset Pack importieren möchten, können Sie das Asset Pack-Archiv, OCESamplesAssetPack.zip herunterladen und in ein Verzeichnis Ihrer Wahl extrahieren:

  1. Laden Sie das Content Management Samples Asset Pack (OCESamplesAssetPack.zip) von der Oracle Content Management-Seite Downloads herunter. Extrahieren Sie die heruntergeladene ZIP-Datei in ein Verzeichnis auf Ihrem Computer. Nach der Extraktion enthält dieser Speicherort eine Datei namens OCEODAChatbot_data.zip.

  2. Melden Sie sich als Administrator bei der Oracle Content Management-Webbenutzeroberfläche an.

  3. Wählen Sie im linken Navigationsmenü die Option Inhalt, und wählen Sie in der Auswahlliste im Seitenheader die Option Repositorys aus. Wählen Sie jetzt ODAChatbotRepository aus, und klicken Sie in der oberen Aktionsleiste auf Inhalt importieren.

    Diese Abbildung zeigt die Seite "Repositorys", wobei das Element ODAChatbotRepository ausgewählt ist.

  4. Laden Sie OCEODAChatbot_data.zip vom lokalen Rechner in den Ordner Dokumente hoch.

    Diese Abbildung zeigt den Bildschirm für die Uploadbestätigung für die Datei OCEODAChatbot_data.zip.

  5. Wählen Sie nach dem Hochladen OCEODAChatbot_data.zip aus, und klicken Sie auf OK, um den Inhalt in das Asset-Repository zu importieren.

    Diese Abbildung zeigt die ausgewählte Datei OCEODAChatbot_data.zip mit aktivierter Schaltfläche "OK".

  6. Nachdem der Inhalt erfolgreich importiert wurde, navigieren Sie zur Seite Assets, und öffnen Sie das Repository ODAChatbotRepository. Alle zugehörigen Bilder, Inhaltselemente und Taxonomien wurden nun dem Asset-Repository hinzugefügt.

    Diese Abbildung zeigt das Repository ODAChatbotRepository mit allen gerade importierten Assets.

  7. Klicken Sie oben links auf Alle auswählen und dann auf Veröffentlichen, um alle importierten Assets zum Veröffentlichungskanal hinzuzufügen, den Sie zuvor erstellt haben, ODAChatbotChannel.

    Diese Abbildung zeigt das Repository ODAChatbotRepository, wobei alle Assets ausgewählt sind und die Option "Veröffentlichen" in der Aktionsleiste sichtbar ist.

  8. Vor der Veröffentlichung müssen Sie alle Assets validieren. Fügen Sie zuerst ODAChatbotChannel als ausgewählten Kanal hinzu, und klicken Sie dann auf die Schaltfläche Validieren.

    Diese Abbildung zeigt die Seite "Validierungsergebnisse", wobei der Kanal ODAChatbotChannel im Feld "Kanäle" hinzugefügt, alle zu validierenden Assets und die Schaltfläche "Validieren" aktiviert sind.

  9. Nachdem die Assets validiert wurden, können Sie alle Assets im ausgewählten Kanal veröffentlichen, indem Sie oben rechts auf die Schaltfläche Veröffentlichen klicken.

    Diese Abbildung zeigt die Seite "Validierungsergebnisse", wobei der Kanal ODAChatbotChannel im Feld "Kanäle" hinzugefügt, alle Assets validiert und die Schaltfläche "Veröffentlichen" aktiviert ist.

    Danach können Sie auf der Seite Anlagen sehen, dass alle Assets veröffentlicht wurden. (Sie können dies mit dem Symbol über dem Assetnamen erklären.)

    Diese Abbildung zeigt die Seite "Assets" mit allen Assets.

  10. Wählen Sie im linken Navigationsmenü die Option Inhalt, und wählen Sie in der Auswahlliste im Seitenheader die Option Taxonomien aus.

    Diese Abbildung zeigt die im Dropdown-Menü im Header der Inhaltsseite ausgewählte Option "Taxonomien".

  11. Wählen Sie auf der Seite "Taxonomien" die Taxonomie SE2-Kategorien (SEC), und klicken Sie in der Aktionsleiste auf Veröffentlichen, um sie zur Verwendung verfügbar zu machen. Veröffentlichen Sie die SEP-(SE2 Products-)Taxonomie auf dieselbe Weise.

Aufgabe 2: Oracle Digital Assistant-Skill erstellen

Um unseren Oracle Content Management-Inhalt in einer ODA-Chatbot-Anwendung zu nutzen, können wir das Content Management-ODA-Chatbot-Beispiel verwenden, das in einem Open-Source-Repository auf GitHub verfügbar ist.

Hinweis: Beachten Sie, dass die Verwendung des ODA-Chatbot-Beispiels optional ist. Wir verwenden es in diesem Tutorial für einen schnellen Einstieg. Sie können auch Ihre eigene Chatbot-Anwendung erstellen.

So erstellen Sie den Chatbot-Skill in ODA:

  1. Beispiel-Repository kopieren
  2. ODA-Skill in Ihre Instanz importieren
  3. Benutzerdefinierten Komponentenservice einrichten und konfigurieren
  4. Mit dem Oracle Content Management Content-SDK arbeiten
  5. Inhalt mit dem Content-SDK abrufen
  6. Benutzerdefinierten Komponentenservice verpacken und bereitstellen

Beispiel-Repository kopieren

Das Content Management-ODA-Chatbot-Beispiel ist im Open-Source-Repository auf GitHub verfügbar. Sie müssen zuerst das Beispiel-Repository von GitHub auf Ihren lokalen Rechner klonen und Ihr Verzeichnis so ändern, dass es mit diesem Beispiel funktioniert.


    git clone https://github.com/oracle/oce-integration-samples.git
    cd oce-integration-samples/oce-oda-chatbot-sample/headless-chatbot-sample

Nachdem Sie Ihre Codebasis erstellt haben, sehen Sie sich die Ordner genauer an, die Sie in diesem Tutorial verwenden:

Hinweis: Der Ordner site-integration-chatbot-sample ist Teil des Chatbot-Beispiels zur Siteintegration. Weitere Informationen zu diesem Beispiel finden Sie hier.

ODA-Skill in Ihre Instanz importieren

Der Ordner ODAChatbot in der Codebasis ist der in diesem Tutorial verwendete ODA-Skill. Führen Sie die folgenden Schritte aus, um Ihren Skill auf Ihrer ODA-Instanz zu erstellen und zu trainieren:

  1. Öffnen Sie in Ihrer Oracle Digital Assistant-Instanz das Navigationsmenü auf der linken Seite, klicken Sie auf Entwicklung, Skills.

    Diese Abbildung zeigt die Oracle Digital Assistance-Instanz, wobei das linke Navigationsmenü geöffnet und die Option "Skills" markiert ist.

  2. Suchen Sie nach dem ODA Chatbot-Skill.

    Hinweis: Wenn Ihre Instanz diesen Skill nicht aufweist, wählen Sie den Inhalt des Ordners ODAChatbot aus, und komprimieren Sie diese in einer einzelnen ZIP-Datei. Klicken Sie auf der Seite "Skills" Ihrer ODA-Instanz auf Skill importieren, und importieren Sie die gerade erstellte ZIP-Datei. Wenn Sie den Ordner ODAChatbot direkt komprimieren, tritt beim Import ein Fehler auf.

  3. Klicken Sie auf der ODA-Chatbot-Skillcard auf das Symbol "Optionen" und dann auf Klonen.

    Diese Abbildung zeigt die Oracle Digital Assistance-Instanz mit geöffnetem linken Navigationsmenü.

  4. Geben Sie dem geklonten Skill einen eindeutigen Anzeigenamen. Beispiel: Fügen Sie Ihre Initialen am Anfang hinzu, wie "AB - ODA Chatbot". Lassen Sie alle anderen Werte unverändert. Wählen Sie Klonierten Skill anschließend öffnen aus, und klicken Sie auf Klonen.

    Hinweis: Der Name muss mit einem Buchstaben beginnen und darf nur Buchstaben, Zahlen, Punkte und Unterstriche enthalten. Er darf maximal 100 Zeichen umfassen.

    Diese Abbildung zeigt die Oracle Digital Assistance-Instanz mit geöffnetem linken Navigationsmenü.

  5. Klicken Sie auf Trainieren, stellen Sie sicher, dass Trainer Ht ausgewählt ist, und klicken Sie dann auf Weiterleiten, um den Skill zu trainieren.

    Hinweis: Sie verwenden Ht-Schulungen in diesem Tutorial, das schnell, aber oberflächlich ist. Für Produktionsaufgaben sollten Sie Tm-Schulungen verwenden, die zu einer besseren Intent-Auflösung führen.

    Diese Abbildung zeigt die Oracle Digital Assistance-Instanz mit geöffnetem linken Navigationsmenü.

ODA-Chatbot-Qualifikation

Bei Qualifikationen handelt es sich um einzelne Chatbots, die für die Interaktion mit Benutzern entwickelt wurden und bestimmte Typen von Aufgaben erfüllen, wie Bestellung von Lebensmitteln, Reservierungen und Änderungen von Kontaktinformationen. Der Skill ODAChatbot unterstützt Benutzer bei der Suche nach geeigneten Ankündigungen und Storys für die Vertriebsunterstützung durch eine Kombination aus Textnachrichten und einfachen UI-Elementen, wie Auswahllisten.

Bevor Sie sich in die Entwicklung von digitalen Assistenten und Skills einarbeiten, sollten Sie sich wie folgt vertraut machen:

Weitere Informationen zu Oracle Digital Assistant und zu den zugehörigen Fähigkeiten finden Sie in der Produktdokumentation.

Service für benutzerdefinierte Komponenten einrichten und konfigurieren

Der Ordner "Sales-enablement-custom-component" in der Codebasis ist die benutzerdefinierte ODA-Komponente, die in diesem Tutorial verwendet wird. Zuerst müssen Abhängigkeiten für diese benutzerdefinierte ODA-Komponente heruntergeladen werden. Führen Sie den folgenden Befehl aus dem Verzeichnis "headless-chatbot-sample/sales-enablement-custom-component" aus:

npm install

Als Nächstes müssen einige Informationen konfiguriert werden, damit das Oracle Content Management Content-SDK (und alle anderen Anforderungen) die richtige Instanz-URL und API-Version mit dem richtigen Kanaltoken als Ziel festlegen kann.

Diese Werte werden in Components/server-config-utils.js verwendet, um einen neuen Zustellungsclient zu instanziieren.

Öffnen Sie die Datei server-config-utils.js in einem Texteditor. Folgendes wird angezeigt:


    contentServer: "https://instance-name.cec.ocp.oraclecloud.com",
    contentVersion: "v1.1",
    channelToken: "4b7b22ad5f5245f28579641d5489a98f",

Ändern Sie jedes Schlüssel/Wert-Paar entsprechend Ihrer Instanz-URL, der gewünschten API-Version und dem mit Ihrem Veröffentlichungskanal verknüpften Kanaltoken. Beispiel: Der Kanal, den wir in diesem Tutorial erstellt haben, ist ODAChatbotChannel.

Mit dem Oracle Content Management Content-SDK arbeiten

Oracle Content Management bietet ein SDK für die Erkennung und Verwendung von Inhalten in Ihren Anwendungen. Das SDK wird als NPM-Modul veröffentlicht, und das Projekt wird auf GitHub gehostet.

Weitere Informationen zum SDK finden Sie hier.

Das SDK wurde als Laufzeitabhängigkeit für dieses Projekt in den package.json-Dateien registriert.

Inhalt mit dem Content-SDK abrufen

Jetzt können wir das Inhalts-SDK verwenden, um Inhalte für den Chatbot-Skill über die benutzerdefinierte ODA-Komponente abzurufen.

Der Ordner " Components/services.js" enthält den Code für das Abrufen von Daten aus Oracle Content Management mit dem Content-SDK.

Die Datei Components/server-config-utils.js importiert das Content-SDK und erstellt dann einen Zustellungsclient mit der darin angegebenen Konfiguration.

Mit dem folgenden Befehl wird das SDK importiert:

createDeliveryClient = require('@oracle/content-management-sdk');

Der folgende Befehl erstellt den Zustellungsclient:

deliveryClient = createDeliveryClient(serverconfig);

Die Datei sales-enablement-custom-component/components/services.js enthält den gesamten Code zum Abrufen der Inhaltselemente für den Chatbot. Es gibt eine Hauptfunktion zum Abrufen des gesamten Inhalts für den Chatbot.

Die folgenden Funktionen werden aufgerufen, um alle Daten für eine bestimmte Taxonomiekategorie aus dem Repository ODAChatbotRepository abzurufen:

function getStoryData(client, categoryName) {
     if (categoryName === 'Announcements') {
       return fetchItemsForAnnouncements(client, false)
         .then((topLevelItem) => {
           const { totalResults } = topLevelItem;
           const promises = [];
           // for each item, retrieve the result object and add it to the promise
           topLevelItem.items.forEach((item) => {
             promises.push(
               retrieveAnnouncementsObject(client, item.id)
                 .then((resultobject) => ({ ...resultobject })),
             );
           });
           // execute all the promises before returning the data
           return Promise.all(promises)
             .then((arrayOfItems) => ({
               totalResults,
               items: arrayOfItems.flat(),
             }));
         });
     }
     return fetchItemsForCategoryName(client, categoryName, false)
       .then((topLevelItem) => {
         const { totalResults } = topLevelItem;
         const promises = [];
         // for each item, retrieve the result object and add it to the promise
         topLevelItem.items.forEach((item) => {
           promises.push(
             retrieveResultObject(client, item.id)
               .then((resultobject) => ({ ...resultobject })),
           );
         });
         // execute all the promises before returning the data
         return Promise.all(promises)
           .then((arrayOfItems) => ({
             totalResults,
             items: arrayOfItems.flat(),
           }));
       });
    }

Die Funktion getStoryData führt zwei verschiedene Aufrufe durch, je nachdem, ob die Anforderung für die Ankündigungen oder eine Story-Kategorie gestellt wird.

Ankündigungsdaten

Sie erfordert einen Datenaufruf, um alle Inhaltselemente für die Ankündigungen abzurufen.

Die Funktion getStoryData ruft fetchItemsForAnnouncements auf, die alle Inhaltselemente des Typs "SE2-Announcements" abruft. Als Nächstes wird die Funktion retrieveAnnouncementsObject aufgerufen, und die Titel- und Summenfelder des Ergebnisobjekts werden mit den Daten aus fetchItemsForAnnouncements aufgefüllt.

function fetchItemsForAnnouncements(client, limit) {
     return client.getItems({
       q: '(type eq "SE2-Announcement")',
       fields: 'all',
       expand: 'all',
       limit: limit ? 4 : 100,
       totalResults: true,
     });
    }

Storydaten

Es sind mehrere Datenaufrufe erforderlich, um alle Inhaltselemente für die Geschichten abzurufen.

  1. Zuerst werden alle Inhaltselemente für die vom Benutzer angeforderte Kategorie abgerufen.

  2. Für jedes Inhaltselement, das wir erhalten, rufen wir die Medien-URL ab.

Die Funktion getStoryData ruft fetchItemsForCategoryName auf, die alle Inhaltselemente des Typs "SE2-Story" und den vom Benutzer angegebenen Taxonomiekategorienamen abruft.

function fetchItemsForCategoryName(client, categoryName, limit) {
     return client.getItems({
       q: `(taxonomies.categories.name eq "${categoryName}" and type eq "SE2-Story")`,
       fields: 'all',
       expand: 'all',
       limit: limit ? 4 : 100,
       totalResults: true,
     });
    }

Das von fetchItemsForCategoryName abgerufene Inhaltselement enthält ein Feld mit der Medien-ID. Die Funktion retrieveMediaURL verwendet diese Medien-ID, um die Medien-URL abzurufen.

function retrieveMediaURL(client, identifier) {
     return client.getItem({
       id: identifier,
       fields: 'all',
       expand: 'all',
     }).then((asset) => {
       let url = null;
       if (asset.fields && asset.fields.renditions && asset.fields.fileType !== 'mp4') {
         const object = asset.fields.renditions.filter((item) => item.name === 'Small')[0];
         const format = object.formats.filter((item) => item.format === 'jpg')[0];
         const self = format.links.filter((item) => item.rel === 'self')[0];
         url = self.href;
       } else {
         url = asset.fields.native.links[0].href;
       }
       return [url, asset.fields.fileType];
     });
    }

Service für benutzerdefinierte Komponenten verpacken und bereitstellen

Sie können benutzerdefinierte Komponenten in einem eingebetteten Container für einen Skill, einen Remoteknotenserver oder Oracle Mobile Hub bereitstellen. In diesem Tutorial stellen Sie Ihren benutzerdefinierten Komponentenservice in einem eingebetteten Container bereit. Dazu müssen Sie zunächst den benutzerdefinierten Komponentenservice in einer bereitstellbaren Datei verpacken:

  1. Speichern Sie Ihre Arbeit in Ihrer JavaScript-IDE.

  2. Öffnen Sie ein Terminalfenster, und navigieren Sie zum Ordner "Sales-enablement-custom-component".

  3. Geben Sie im Ordner "Sales-enablement-custom-component" den folgenden npm-Befehl ein

    bots-node-sdk pack

    Aufgrund des Prepack-Skripts in der Datei package.json führt der Befehl zum ersten Mal den Befehl prepack aus, um das Package zu verifizieren. Der Befehl verpackt dann das Knotenprojekt und seine Abhängigkeiten in einem bereitstellbaren Tarball namens sales-enablement-custom-component-1.0.0.tgz.

    Ihr Tarball muss alle Abhängigkeiten mit Ausnahme von devDependencies enthalten.

  4. Klicken Sie im ODA-Chatbot-Skill in der linken Leiste auf das Symbol "Komponenten", um die Komponentenservice-Seite zu öffnen. Klicken Sie auf + Service, um einen neuen Service zu erstellen.

    Diese Abbildung zeigt eine leere Serviceseite für einen Skill.

  5. Gehen Sie im Dialogfeld "Service erstellen" wie folgt vor:

    1. Geben Sie im Feld "Name" SalesEnablementCustomComponent ein.

    2. Im Feld "Beschreibung" können Sie eine optionale Beschreibung hinzufügen.

    3. Stellen Sie sicher, dass die Option Eingebetteter Container ausgewählt ist.

    4. Verschieben Sie die Datei sales-enablement-custom-component-1.0.0.tgz per Drag-and-Drop, oder laden Sie sie in das Feld "Packagedatei" hoch.

    5. Klicken Sie auf Erstellen.

    Diese Abbildung zeigt das Dialogfeld "Service erstellen".

  6. Warten Sie, bis im Feld "Status" Bereit angezeigt wird, was einige Sekunden dauern kann.

  7. Wenn der benutzerdefinierte Komponentenservice im eingebetteten Container des Skills bereitgestellt ist, können Sie die Komponente testen.

Weitere Informationen zu Oracle Digital Assistant und benutzerdefinierten Komponenten finden Sie in der Schulungsdokumentation.

Aufgabe 3: Webanwendung für Ihren Chatbot einrichten

Der zuvor erstellte ODA-Skill kann auf mehreren Plattformen bereitgestellt und verwendet werden. Weitere Informationen zu den verschiedenen Kanälen, die von ODA unterstützt werden, finden Sie in der Dokumentation.

In diesem Tutorial erstellen wir einen Oracle-Webkanal, damit ein Oracle-Webchatwidget eine Verbindung zu Ihrem Skill herstellen kann.

Hinweis: Ein Problem beim Hinzufügen von Chats zu Webclients besteht darin, dass Hacker auf den Skill und aktive Unterhaltungen zugreifen können, es sei denn, Sie sichern den Zugriff auf den Oracle-Webkanal, den Webclient und die Chatsession. Mit einer einfachen Browserkonsole können sie die REST-URIs prüfen und die Benutzer-ID und Kanal-ID der Unterhaltung abrufen. Weitere Informationen zur Sicherung Ihres Oracle-Webkanals finden Sie in diesem Tutorial.

Das Bereitstellen des ODA-Chatbot-Skills im Web besteht aus zwei Schritten:

  1. Webkanal von Oracle Digital Assistant erstellen

  2. Webanwendung konfigurieren

Webkanal von Oracle Digital Assistant erstellen

Sie erstellen einen Benutzerkanal von Oracle Digital Assistant, über den ein Oracle Web-Client auf Ihren Skill zugreifen kann. Um sicherzustellen, dass nur Ihre Webclients diesen Kanal verwenden können, konfigurieren Sie ihn so, dass eine Clientauthentifizierung erforderlich ist.

  1. Öffnen Sie in Ihrer Oracle Digital Assistant-Instanz das Navigationsmenü auf der linken Seite, klicken Sie auf Entwicklung, Kanäle.

    Diese Abbildung zeigt die Oracle Digital Assistance-Instanz, wobei das linke Navigationsmenü geöffnet und die Option "Kanäle" markiert ist.

  2. Klicken Sie auf der Seite "Kanäle" auf + Channel, um einen Channel hinzuzufügen.

  3. Geben Sie auf der Seite "Kanäle erstellen" die folgenden Informationen ein, wie im folgenden Screenshot gezeigt:

    • Name: Ein eindeutiger Name, der mit einem Buchstaben beginnt und nur Buchstaben, Zahlen, Punkte und Unterstriche (_) enthält. Beispiel: AB_ODAChatbot.
    • Beschreibung: (Optional) Was der Kanal verwendet wird.
    • Kanaltyp: Oracle Web.
    • Zulässige Domains: * (Ein einzelnes Sternchen lässt jede Domain zu.)
    • Clientauthentifizierung aktiviert: Übernehmen Sie die Einstellung "off".

    Diese Abbildung zeigt die Oracle Digital Assistance-Instanz, wobei das linke Navigationsmenü geöffnet und die Option "Kanäle" markiert ist.

  4. Klicken Sie auf Erstellen.

  5. Wählen Sie in der Dropdown-Liste "Weiterleiten an" den Skill aus, den Sie für dieses Tutorial verwenden möchten.

    Diese Abbildung zeigt die Seite "Kanäle" mit der Dropdown-Liste "Weiterleiten an".

  6. Aktivieren Sie die Option Kanal aktiviert.

  7. Notieren Sie sich die für diesen Kanal angezeigte Kanal-ID. Später in diesem Tutorial verwenden Sie diesen Wert in Ihrer Webanwendung.

    Diese Abbildung zeigt die Seite "Kanäle" mit den Routinginformationen für den Chatbot.

  8. Beachten Sie auch den Oracle Digital Assistant-Host und die -Domain (die als vollqualifizierter Domainname referenziert wird) aus der Instanz-URL, die im Adressfeld Ihres Webbrowsers angezeigt wird, z.B. oda-xxxx.data.digitalassistant.oci.oraclecloud.com. Sie verwenden diesen Wert später im Tutorial.

Ihre Instanz ist jetzt für Sie eingerichtet, um einen Chatbot auf einer Webseite mit dem Skill zu verbinden.

Webanwendung konfigurieren

Im nächsten Schritt konfigurieren Sie Ihre Webanwendung:

  1. Laden Sie die neueste Version des Oracle Web-SDK herunter, und dekomprimieren Sie sie in einen Ordner Ihrer Wahl. Sie können auch von der Digital Assistant-Instanz zur Downloadseite für dieses SDK navigieren, indem Sie das Seitenmenü öffnen und dann auf "Downloads" klicken.

  2. Kopieren Sie die Datei native-client-sdk-js/web-sdk.js aus Ihrem Oracle Web-SDK-Ordner, und legen Sie sie im Ordner WebApp/Skripte ab.

    Diese Abbildung zeigt die Web-sdk-Datei im Ordner WebApp/Skripts.

    Das SDK stellt eine Verbindung zum Oracle-Chatserver her, der zwischen Oracle Digital Assistant und dem Skill (oder dem digitalen Assistenten) steht. Der Chatserver übergibt Nachrichten dann zur Verarbeitung an den Skill und übermittelt die Antwort des Skills an den Client.

  3. Öffnen Sie die Datei WebApp/scripts/settings.js in einem Editor. Legen Sie die folgenden chatWidgetSettings-Eigenschaften fest:

    • URI: Der Host- und Domainname, den Sie beim Erstellen des Oracle-Webkanals notiert haben, z.B. xxxx.xxx.digitalassistant.xxx.xxx.com. Nehmen Sie keine https:// auf.

    • channelId: Die Kanal-ID für den zuvor erstellten Kanal.

    Beispiel:

    let chatWidgetSettings = {
      URI: 'xxxx.xxx.digitalassistant.xxx.xxx.com',
      clientAuthEnabled: isClientAuthEnabled, 
      channelId: '12a45b92-2c85-88aa-810d-1dc0d1cfe472'
      ...

  4. Speichern und schließen Sie die Datei.

Ihr Oracle-Webkanal zusammen mit Ihrer Webanwendung ist bereit. Sie können jetzt Ihre Chatbot-Anwendung ausführen und in Aktion sehen.

Aufgabe 4: Anwendung bereitstellen

Nachdem wir unser ODA-Chatbot-Beispiel für Content Management erstellt haben, müssen wir es in einem lokalen Browser sehen, damit wir Probleme debuggen und eine Vorschau der Anwendung vor dem Go-Live anzeigen können.

  1. Öffnen Sie die Datei WebApp/index.html in einem Webbrowser.

  2. Ihre Webanwendung sollte mit geöffnetem Chatfenster angezeigt werden. Wenn das Chatwidget nicht geöffnet ist, klicken Sie auf das Chatsymbol, um es zu öffnen.

  3. Prüfen Sie mit dem Skill, ob die Webanwendung richtig konfiguriert ist.