Crea un chatbot Oracle Digital Assistant con Oracle Content Management Headless

Introduzione

Oracle Digital Assistant è una piattaforma che consente di creare e distribuire assistenti digitali, ovvero interfacce basate sull'intelligenza artificiale che consentono agli utenti di eseguire una vasta gamma di attività nelle conversazioni con il linguaggio naturale. Ma cosa accade quando hai bisogno di un sistema di gestione dei contenuti (CMS) per servire tutti i tuoi contenuti? Fortunatamente, Oracle Content Management, con le sue funzionalità CMS headless, offre una soluzione ideale per tutte le esigenze di amministrazione e gestione del controllo dei contenuti.

In questa esercitazione, creeremo un chatbot in Oracle Digital Assistant utilizzando Oracle Content Management come CMS senza problemi e il relativo kit di sviluppo software (SDK) per la distribuzione dei contenuti in JavaScript. Questo esempio di chatbot è disponibile su GitHub.

L'esercitazione si articola in quattro passi:

Prepara Oracle Content Management
Sviluppa le competenze di Oracle Digital Assistant
Impostare un'applicazione Web per il chatbot
Distribuire l'applicazione

Prerequisiti

Prima di procedere con questa esercitazione, si consiglia di leggere le seguenti informazioni:

Per seguire questa esercitazione, sono necessari:

una sottoscrizione a Oracle Content Management
un account Oracle Content Management con il ruolo Amministratore contenuto
una sottoscrizione a Oracle Digital Assistant (ODA)
un'istanza ODA
un computer Windows o Mac con Node.js e Node Package Manager (NPM) installati per l'accesso globale

Cosa stiamo costruendo

Il nostro esempio di chatbot sarà costituito da una singola pagina di destinazione con un bot che gli utenti possono utilizzare per trovare garanzie di vendita. I visitatori possono chiedere al bot di abilitazione delle vendite di visualizzare un elenco di voci di menu, categorie in una voce di menu o recuperare storie e annunci relativi a una query di ricerca.

Per dare un'occhiata a cosa stiamo creando, ecco lo stato finale della nostra esercitazione, un chatbot ODA che utilizza i contenuti di Oracle Content Management:

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

Questo è l'aspetto della pagina di destinazione e del bot di abilitazione delle vendite alla fine di questa esercitazione:

Questa immagine mostra una pagina di destinazione del sito con la finestra Chatbot di Sales Enablement aperta e una conversazione in corso.

Flusso chatbot ODA gestione contenuti

Il flusso del campione di chatbot ODA di Content Management è il seguente:

Il client invia una richiesta al canale ODA tramite l'interfaccia chatbot.
Al canale ODA è associata una competenza che risolve questa richiesta utente.
In base all'entità o all'intento risolti, la competenza ODA può eseguire azioni diverse:
- Se l'entità risolta contiene un valore di categoria, procedere come segue.
  - ODA effettua una chiamata a Content Management utilizzando il servizio componente personalizzato,
  - Il servizio componente personalizzato utilizza il valore della categoria e la configurazione del server per l'istanza di Content Management e invia una richiesta all'istanza
  - Quindi l'istanza invia una risposta al servizio componente personalizzato, che viene quindi inviato al client da ODA.
- In caso contrario, ODA invia un messaggio a seconda del flusso di conversazione definito.
La risposta ricevuta dal client viene visualizzata dall'SDK Web e mostrata all'utente.

Al termine di questa esercitazione, scoprirai come creare un'applicazione chatbot basata su Oracle Content Management.

Task 1: Prepara Oracle Content Management

Se non si dispone già di un'istanza di Oracle Content Management, vedere Avvio rapido per informazioni su come registrarsi per Oracle Cloud, eseguire il provisioning di un'istanza di Oracle Content Management e configurare Oracle Content Management come CMS senza problemi.

Per questa esercitazione sarà necessario creare un modello di contenuto. È disponibile un pacchetto asset scaricabile che riempirà il repository vuoto con i tipi di contenuto e il contenuto associato.

Per preparare Oracle Content Management, effettuare le operazioni riportate di seguito.

Creare un canale e un repository di asset
Importa pacchetto asset campioni di Oracle Content Management

Crea un repository di canale e asset

Prima è necessario creare un canale e un repository di asset in Oracle Content Management in modo da poter pubblicare il contenuto.

Per creare un canale e un repository di asset in Oracle Content Management, effettuare le operazioni riportate di seguito.

Eseguire il login all'interfaccia Web di Oracle Content Management come amministratore.
Scegliere Contenuto nel menu di navigazione sinistro, quindi scegliere Pubblicazione canali dall'elenco di selezione nell'intestazione della pagina.
Nell'angolo in alto a destra fare clic su Crea per creare un nuovo canale. Assegnare un nome al canale 'ODAChatbotChannel' ai fini di questa esercitazione e mantenere pubblico l'accesso. Fare clic su Salva per creare il canale.
Scegliere Contenuto nel menu di navigazione sinistro, quindi scegliere Repositori dalla lista di selezione nell'intestazione della pagina.
Nell'angolo in alto a destra fare clic su Crea per creare un nuovo repository di asset. Assegnare un nome al repository di asset 'ODAChatbotRepository' ai fini di questa esercitazione.
Nel campo Pubblicazione canali selezionare il canale ODAChatbotChannel per indicare a Oracle Content Management che il contenuto nel repository ODAChatbotRepository può essere pubblicato nel canale ODAChatbotChannel. Al termine, fare clic su Salva.

Importa pacchetto asset campioni di Oracle Content Management

È possibile scaricare un pacchetto di asset di esempio di Content Management preconfigurato contenente tutti i tipi di contenuto, gli asset e le tassonomie richiesti per questa esercitazione.

È possibile caricare una copia del contenuto utilizzato in questa esercitazione dal package di asset dei campioni di Content Management. In questo modo sarà possibile provare i tipi di contenuto e modificare il contenuto. Se si desidera importare il package di asset dei campioni di Content Management, è possibile scaricare l'archivio del package di asset, OCESamplesAssetPack.zip, quindi estrarlo in una directory selezionata:

Scaricare il package di asset dei campioni di Content Management (OCESamplesAssetPack.zip) dalla pagina download di Oracle Content Management. Estrarre il file ZIP scaricato in una posizione sul computer. Dopo l'estrazione, questa posizione includerà un file denominato OCEODAChatbot_data.zip.
Eseguire il login all'interfaccia Web di Oracle Content Management come amministratore.
Scegliere Contenuto nel menu di navigazione sinistro, quindi scegliere Repositori dalla lista di selezione nell'intestazione della pagina. Selezionare ora ODAChatbotRepository e fare clic su Importa contenuto nella barra delle azioni superiore.
Caricare OCEODAChatbot_data.zip dal computer locale nella cartella Documenti.
Dopo aver caricato, selezionare OCEODAChatbot_data.zip e fare clic su OK per importare il contenuto nel repository di asset.
Dopo aver importato il contenuto, passare alla pagina Asset e aprire il repository ODAChatbotRepository. Si noterà che tutte le immagini, gli elementi di contenuto e le tassonomie correlate sono stati aggiunti al repository degli asset.
Fare clic su Seleziona tutto in alto a sinistra, quindi su Pubblica per aggiungere tutti gli asset importati al canale di pubblicazione creato in precedenza, ODAChatbotChannel.
Prima della pubblicazione, è necessario convalidare tutti gli asset. Aggiungere prima ODAChatbotChannel come canale selezionato, quindi fare clic sul pulsante Convalida.
Dopo la convalida degli asset, è possibile pubblicare tutti gli asset nel canale selezionato facendo clic sul pulsante Pubblica nell'angolo superiore destro.

Al termine, è possibile visualizzare nella pagina Asset la pubblicazione di tutti gli asset. (È possibile visualizzare l'icona sopra il nome dell'asset).
Scegliere Contenuto nel menu di navigazione sinistro, quindi scegliere Tassonomie dall'elenco di selezione nell'intestazione della pagina.
Nella pagina Tassonomie selezionare la tassonomia SE2 Categorie (SEC) e fare clic su Pubblica nella barra delle azioni per renderla disponibile per l'uso. Pubblicare la tassonomia SE2 Products (SEP) allo stesso modo.

Task 2: creare l'abilità di Oracle Digital Assistant

Per utilizzare il contenuto di Oracle Content Management in un'applicazione chatbot ODA, è possibile utilizzare il campione di chatbot ODA di Content Management, disponibile in un repository open-source su GitHub.

Nota: tenere presente che l'uso del campione di chatbot ODA è facoltativo e che viene utilizzato in questa esercitazione per iniziare rapidamente. Puoi anche creare la tua applicazione di chatbot.

Per creare la competenza di chatbot in ODA:

Duplicare il repository di esempio
Importare lo skill ODA nell'istanza
Impostare e configurare il servizio componente personalizzato
Utilizzare l'SDK di Oracle Content Management Content
Utilizzare il kit SDK del contenuto per recuperare il contenuto
Package e distribuzione del servizio componente personalizzato

Duplicare il repository di esempio

Il campione di chatbot ODA di Content Management è disponibile nel repository open source in GitHub. Sarà innanzitutto necessario clonare il repository di esempio da GitHub al computer locale e modificare la directory per utilizzare questo esempio.


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

Ora che si dispone del codice base, è necessario esaminare più da vicino le cartelle che verranno utilizzate in questa esercitazione:

La cartella ODAChatbot è una competenza per i chatbot.
La cartella Business-enablement-custom-component è un componente personalizzato ODA.
La cartella WebApp è un'applicazione Web.

Nota: la cartella site-integration-chatbot-sample fa parte dell'esempio di chatbot di integrazione del sito. Puoi consultare ulteriori informazioni su questo esempio qui.

Importa skill ODA nell'istanza

La cartella ODAChatbot nella base di codice è lo skill ODA utilizzato in questa esercitazione. Attenersi alla procedura riportata di seguito per creare e formare la propria competenza sull'istanza ODA.

Nell'istanza di Oracle Digital Assistant aprire il menu di navigazione a sinistra, quindi fare clic su Sviluppo, quindi su Skill.
Cercare lo skill Chatbot ODA.

Nota: se l'istanza non dispone di questo skill, selezionare il contenuto della cartella ODAChatbot e comprimerli in un singolo file zip. Nella pagina Skill dell'istanza ODA fare clic su Importa competenza e importare il file ZIP appena creato. La compressione diretta della cartella ODAChatbot produrrà un errore al momento dell'importazione.
Nella scheda di competenza Chatbot ODA fare clic sull'icona delle opzioni, quindi su Clona.
Assegnare alla competenza clonata un nome visualizzato univoco, ad esempio aggiungere le iniziali all'inizio, ad esempio 'AB - chatbot ODA'. Lasciare invariati tutti gli altri valori. Selezionare Apri competenze clonate in seguito, quindi fare clic su Duplica.

Nota: il nome deve iniziare con una lettera e può contenere solo lettere, numeri, punti e caratteri di sottolineatura. Non può superare i 100 caratteri.
Fare clic su Train, assicurarsi che sia selezionato Trainer Ht, quindi fare clic su Sottometti per formare la competenza.

Nota: in questa esercitazione viene utilizzato il training Ht, che è rapido ma superficiale. Per il lavoro di produzione, è necessario utilizzare la formazione Tm, che consente una migliore risoluzione delle intenzioni.

Competenza chatbot ODA

Le competenze sono singoli chatbot progettati per interagire con gli utenti ed eseguire tipi specifici di attività, come l'ordine di cibo, la prenotazione e la modifica delle informazioni di contatto. Lo skill ODAChatbot consente a un utente di trovare annunci e storie di abilitazione vendite appropriati mediante una combinazione di messaggi di testo e semplici elementi dell'interfaccia utente, ad esempio elenchi di selezione.

Prima di acquisire familiarità con l'assistente digitale e lo sviluppo di competenze, ecco alcuni concetti con cui si desidera acquisire familiarità:

Intenti: le categorie di azioni o task che gli utenti devono eseguire. Nella nostra competenza, ci sono due intenti:
- Saluti: questo intento mostra un messaggio di benvenuto per l'utente.
- StoryIntent: questo intento mostra i menu e gli elementi di contenuto appropriati di Oracle Content Management.
Entità: variabili che identificano le informazioni chiave dall'input dell'utente che consentono la capacità di eseguire un task. Nella nostra competenza, ci sono sette entità:
- TopMenu: entità dell'elenco di valori contenente le voci di menu.
- HomeMenu: entità dell'elenco di valori contenente le categorie dal menu Home.
- CafeSupremoMenu: entità dell'elenco di valori contenente le categorie dal menu Cafe Supremo.
- LearningMenu: entità dell'elenco di valori contenente le categorie dal menu Apprendimento.
- SellingMenu: entità dell'elenco di valori contenente le categorie dal menu Vendita.
- MenuBag: si tratta di un'entità bag composita di entità voce menu, ovvero le entità HomeMenu, CafeSupremoMenu, LearningMenu e SellingMenu.
- StoryCategory: entità dell'elenco di valori contenente tutte le categorie della storia.
Sia intenti che entità sono concetti comuni di elaborazione del linguaggio naturale (NLP). La NLP è la scienza di estrarre l'intenzione di testo e le informazioni pertinenti dal testo.
Componenti: consentono di acquisire le competenze necessarie per rispondere agli utenti. Possono essere funzioni generiche quali l'output di testo o componenti personalizzati che possono restituire informazioni da un backend ed eseguire una logica personalizzata. Nelle nostre competenze è presente un servizio componente personalizzato, che consente di recuperare gli elementi di contenuto da Oracle Content Management tramite le API REST.
Flusso di dialogo: la definizione dell'interazione skill-utente. Il flusso di dialogo descrive in che modo l'abilità risponde e si comporta in base all'input dell'utente.
Canali: gli utenti possono accedere ad assistenti e competenze digitali tramite piattaforme di messaggistica o tramite applicazioni di messaggistica client. Un singolo assistente digitale o competenza può avere diversi canali configurati per esso in modo che possa essere eseguito su diversi servizi contemporaneamente. In questa esercitazione viene utilizzato il canale Web Oracle per accedere alle nostre competenze in un'applicazione Web.

Per saperne di più su Oracle Digital Assistant e sulle competenze, consulta la documentazione del prodotto.

Impostazione e configurazione del servizio componente personalizzato

La cartella custom-component-enablement-custom-component nella base di codice è il componente personalizzato ODA utilizzato in questa esercitazione. In primo luogo, è necessario scaricare le dipendenze per questo componente personalizzato ODA. Eseguire il comando seguente dalla directory headless-chatbot-sample/sales-enablement-custom-component:

npm install

Successivamente, dobbiamo configurare alcune informazioni in modo che il nostro SDK di Oracle Content Management Content (e qualsiasi altra richiesta) possa indirizzare l'URL dell'istanza e la versione API corretti con il token di canale corretto.

Questi valori vengono utilizzati in component/server-config-utils.js per creare un'istanza di un nuovo client di distribuzione.

Aprire il file server-config-utils.js in un editor di testo. Sono disponibili gli elementi riportati di seguito.


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

Modificare ogni coppia chiave-valore in modo che rifletta l'URL dell'istanza, la versione dell'API a cui si desidera indirizzare e il token canale associato al canale di pubblicazione. Ad esempio, il canale creato in questa esercitazione è ODAChatbotChannel.

Utilizzare l'SDK di Oracle Content Management Content

Oracle Content Management offre un SDK che consente di individuare e utilizzare i contenuti nelle applicazioni. L'SDK viene pubblicato come modulo NPM e il progetto viene gestito in hosting su GitHub.

Per ulteriori informazioni sull'SDK, fare clic qui.

L'SDK è stato registrato come dipendenza runtime di questo progetto nei file package.json.

Utilizzare l'SDK del contenuto per recuperare il contenuto

Ora possiamo sfruttare il kit SDK del contenuto per recuperare il contenuto della competenza relativa ai chatbot tramite il componente personalizzato ODA.

La cartella Components/services.js contiene il codice per il recupero dei dati da Oracle Content Management mediante l'SDK del contenuto.

Il file component/server-config-utils.js importa l'SDK del contenuto e quindi crea un client di consegna utilizzando la configurazione specificata in esso.

Il comando seguente importa l'SDK:

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

Il comando seguente crea il client di consegna:

deliveryClient = createDeliveryClient(serverconfig);

Il file sales-enablement-custom-component/components/services.js contiene tutto il codice per ottenere gli elementi di contenuto per il chatbot. C'è una funzione principale per recuperare tutto il contenuto del chatbot.

Le funzioni riportate di seguito vengono richiamate per recuperare tutti i dati per una particolare categoria di tassonomia dal repository ODAChatbotRepository.

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(),
           }));
       });
    }

La funzione getStoryData effettua due set di chiamate diversi a seconda che la richiesta venga effettuata per la categoria annunci o storia.

Dati annunci

Richiede una chiamata dati per ottenere tutti gli elementi di contenuto per gli annunci.

La funzione getStoryData chiama fetchItemsForAnnouncements, che recupera tutti gli elementi di contenuto di tipo 'SE2-Announcements'. Successivamente, viene chiamata la funzione retrieveAnnouncementsObject e i campi del titolo e del sintetico dell'oggetto risultato vengono popolati con i dati di fetchItemsForAnnouncements.

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

Dati storia

Richiede diverse chiamate di dati per ottenere tutti gli elementi di contenuto per le Storie.

In primo luogo, vengono recuperati tutti gli elementi di contenuto per la categoria richiesta dall'utente.
Per ogni elemento di contenuto ottenuto, viene effettuata una chiamata per recuperare l'URL del supporto.

La funzione getStoryData chiama fetchItemsForCategoryName, che recupera tutti gli elementi di contenuto di tipo 'SE2-Story' e il nome della categoria di tassonomia come specificato dall'utente.

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,
     });
    }

L'elemento di contenuto recuperato da fetchItemsForCategoryName dispone di un campo ID supporto. La funzione retrieveMediaURL utilizza questo ID supporto per recuperare l'URL del supporto.

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];
     });
    }

Package e distribuzione del servizio componente personalizzato

È possibile distribuire componenti personalizzati in un contenitore incorporato per una competenza, un server nodo remoto o Oracle Mobile Hub. In questa esercitazione verrà distribuito il servizio componente personalizzato in un contenitore incorporato. Per eseguire questa operazione, è innanzitutto necessario creare un package del servizio componente personalizzato in un file distribuibile:

Salvare i dati nel proprio IDE JavaScript.
Aprire una finestra di terminale e accedere alla cartella sales-enablement-custom-component.
Nella cartella sales-enablement-custom-component immettere il seguente comando npm
```
bots-node-sdk pack
```
A causa dello script prepack nel file package.json, il comando esegue in primo luogo il comando prepack per verificare il pacchetto. Il comando quindi imballa il progetto Node e le relative dipendenze in un tarball distribuibile denominato sales-enablement-custom-component-1.0.0.tgz.

Il tarball deve includere tutte le dipendenze ad eccezione di devDependencies.
Nella competenza Chatbot ODA, fare clic sull'icona Componenti nella barra a sinistra per aprire la pagina Servizio componenti. Fare clic su + Service per creare un nuovo servizio.
Nella finestra di dialogo Crea servizio, effettuare le operazioni riportate di seguito.
1. Nel campo Nome immettere SalesEnablementCustomComponent.
2. Nel campo Descrizione è possibile aggiungere una descrizione facoltativa.
3. Assicurarsi che l'opzione Contenitore incorporato sia selezionata.
4. Trascinare o caricare il file custom-component-1.0.0.tgz dell'abilitazione vendite nel campo File package.
5. Fare clic su Crea.
Attendere che il campo Stato mostri Pronto, che potrebbe richiedere alcuni secondi.
Con il servizio componente personalizzato distribuito nel contenitore incorporato della competenza, è possibile eseguire il test del componente.

Per ulteriori informazioni su Oracle Digital Assistant e sui componenti personalizzati, consulta la documentazione relativa alla formazione.

Task 3: Configurazione di un'applicazione Web per il chatbot

Lo skill ODA creato in precedenza può essere distribuito e utilizzato su più piattaforme. Per ulteriori informazioni sui diversi canali supportati da ODA, consulta la documentazione.

In questa esercitazione verrà creato un canale Web Oracle per consentire a un widget di chat Web Oracle di connettersi alla propria competenza.

Nota: un problema con l'aggiunta di chat ai client Web è che gli hacker possono accedere alle competenze e alle conversazioni attive a meno che non si garantisca l'accesso al canale Web, al client Web e alla sessione di chat Oracle. Con una semplice console del browser, possono ispezionare gli URI REST e ottenere l'ID utente e l'ID canale della conversazione. Per informazioni su come proteggere il canale Web Oracle, vedere questa esercitazione.

L'implementazione della competenza dei chatbot ODA in Web si articola in due passaggi:

Creare un canale Web Oracle Digital Assistant
Configura l'applicazione Web

Creare un canale Web Oracle Digital Assistant

Verrà creato un canale utente di Oracle Digital Assistant che consente a un client Web Oracle di accedere alle proprie competenze. Per assicurarsi che solo i client Web possano utilizzare questo canale, configurarlo in modo da richiedere l'autenticazione del client.

Nell'istanza di Oracle Digital Assistant aprire il menu di navigazione a sinistra, quindi fare clic su Sviluppo, quindi su Canali.
Nella pagina Canali fare clic su + Canale per aggiungere un canale.
Nella pagina Crea canali, immettere queste informazioni come mostrato nello screenshot seguente:
- Nome: un nome univoco che inizia con una lettera e contiene solo lettere, numeri, punti e caratteri di sottolineatura (_), ad esempio AB_ODAChatbot.
- Descrizione: (facoltativo) il canale utilizzato.
- Tipo di canale: Oracle Web.
- Domini consentiti: * (un solo asterisco consente qualsiasi dominio).
- Autenticazione client abilitata: lasciarla in posizione non attiva.
Fare clic su Crea.
Nell'elenco a discesa Instrada a selezionare la competenza che si desidera utilizzare per questa esercitazione.
Impostare l'opzione Canale abilitato su Attivo.
Prendere nota dell'ID canale visualizzato per questo canale. Più avanti in questa esercitazione, questo valore verrà utilizzato nell'applicazione Web.
Prendere inoltre nota dell'host e del dominio Oracle Digital Assistant (con riferimento come nome di dominio completamente qualificato) dall'URL dell'istanza visualizzato nel campo dell'indirizzo del browser Web, ad esempio oda-xxxx.data.digitalassistant.oci.oraclecloud.com. Questo valore verrà utilizzato in seguito nell'esercitazione.

La tua istanza è ora impostata per la connessione di un chatbot su una pagina Web alle competenze.

Configura l'applicazione Web

Il passo successivo consiste nella configurazione dell'applicazione Web:

Scaricare la versione più recente di Oracle Web SDK e decomprimerla in una cartella di tua scelta. È inoltre possibile accedere alla pagina di download di questo SDK dall'istanza di Digital Assistant aprendo il menu laterale e facendo clic su Download.
Copiare il file native-client-sdk-js/web-sdk.js dalla cartella Oracle Web SDK e inserirlo nella cartella App/script Web.

L'SDK si connette a Oracle Chat Server, che si trova tra Oracle Digital Assistant e l'abilità (o assistente digitale). Il server di chat passa quindi i messaggi alla capacità di elaborazione e fornisce la risposta della competenza al client.
Aprire il file WebApp/scripts/settings.js in un editor. Impostare le seguenti proprietà chatWidgetSettings:
- URI: l'host e il nome dominio indicati durante la creazione del canale Web Oracle, ad esempio xxxx.xxx.digitalassistant.xxx.xxx.com. Non includere https://.
- channelId: l'ID canale per il canale creato in precedenza.
Di seguito viene fornito un esempio.
```
let chatWidgetSettings = {
      URI: 'xxxx.xxx.digitalassistant.xxx.xxx.com',
      clientAuthEnabled: isClientAuthEnabled, 
      channelId: '12a45b92-2c85-88aa-810d-1dc0d1cfe472'
      ...
```
Salvare e chiudere il file.

Il canale Web Oracle insieme all'applicazione Web è pronto. Ora si è pronti per eseguire l'applicazione chatbot e visualizzarla in azione.

Task 4: Distribuzione dell'applicazione

Dopo aver creato il nostro esempio di chatbot ODA di Content Management, è necessario visualizzarlo in un browser locale in modo da poter eseguire il debug di qualsiasi problema e visualizzare in anteprima l'applicazione prima che diventi attiva.

Aprire il file WebApp/index.html in un browser Web.
L'applicazione Web deve essere visualizzata con la finestra di chat aperta. Se il widget chat non è aperto, fare clic sull'icona della chat per aprirlo.
Concedere con la competenza per verificare che l'applicazione Web sia configurata correttamente.

Titolo e informazioni sul copyright

Crea un chatbot Oracle Digital Assistant con Oracle Content Management Headless

F52683-01

Gennaio 2022

Autore principale: Oracle Corporation