Crie um Chatbot do Oracle Digital Assistant com o Oracle Content Management sem supervisão

Introdução

O Oracle Digital Assistant é uma plataforma que permite criar e implantar assistentes digitais, que são interfaces baseadas em IA que ajudam os usuários a realizar diversas tarefas em conversas de linguagem natural. Mas o que acontece quando você precisa de um sistema de gerenciamento de conteúdo (CMS) para atender todo o seu conteúdo? Felizmente, o Oracle Content Management, com seus valiosos recursos de CMS, tem uma solução graciosa para todas as suas necessidades de administração e governança de conteúdo.

Neste tutorial, construiremos um chatbot no Oracle Digital Assistant aproveitando o Oracle Content Management como um CMS sem supervisão, bem como seu kit de desenvolvimento de software (SDK) para entrega de conteúdo em JavaScript. Esta amostra de chatbot está disponível no GitHub.

O tutorial consiste em quatro etapas:

1. Preparar o Oracle Content Management
2. Desenvolva a habilidade do Oracle Digital Assistant
3. Configurar um aplicativo Web para seu chatbot
4. Implantar seu aplicativo

Pré-requisitos

Antes de prosseguir com este tutorial, recomendamos que você leia as seguintes informações primeiro:

• Conceitos-Chave
• Repositórios de Ativos
• Taxonomias

Para seguir este tutorial, você precisará:

• uma assinatura do Oracle Content Management
• uma conta do Oracle Content Management com a atribuição de Administrador de Conteúdo
• uma assinatura do Oracle Digital Assistant (ODA)
• uma instância do ODA
• um computador Windows ou Mac com Node.js e Gerenciador de Pacotes de Nós (NPM) instalados para acesso global

O que estamos construindo

Nossa amostra de chatbot consistirá em uma única página inicial com um bot que os usuários podem usar para encontrar material de apoio de vendas. Os visitantes podem pedir ao bot Sales Enablement para mostrar uma lista de itens de menu, categorias em um item de menu ou extrair histórias e anúncios relevantes para uma consulta de pesquisa.

Para dar uma olhada no que estamos criando, aqui está o estado final de nosso tutorial, um chatbot do ODA que consome conteúdo do Oracle Content Management:

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

Essa é a aparência da página de destino e do bot Sales Enablement no final deste tutorial:

Fluxo de Chatbot do ODA de Gerenciamento de Conteúdo

O fluxo da amostra de chatbot do Content Management ODA é o seguinte:

1. O cliente faz uma solicitação ao canal do ODA por meio da interface do chatbot.

2. O canal ODA tem uma habilidade associada a ele, que resolve esta solicitação do usuário.

3. Com base na entidade ou intenção resolvida, a habilidade do ODA pode executar ações diferentes:

   • Se a entidade resolvida contiver um valor de categoria,:
     • O ODA faz uma chamada ao Gerenciamento de Conteúdo usando o serviço de componente personalizado,
     • O serviço de componente personalizado usa o valor da categoria e a configuração do servidor para a instância de Gerenciamento de Conteúdo e envia uma solicitação à instância
     • Em seguida, a instância envia uma resposta de volta para o serviço do componente personalizado, que é enviado ao cliente pelo ODA.
   • Caso contrário, o ODA enviará uma mensagem dependendo do fluxo de conversa definido.

4. A resposta recebida pelo cliente é renderizada pelo SDK da Web e mostrada ao usuário.

Ao final deste tutorial, você aprenderá a criar um aplicativo de chatbot com a tecnologia do Oracle Content Management.

Tarefa 1: Preparar o Oracle Content Management

Se você ainda não tiver uma instância do Oracle Content Management, consulte o Início Rápido para saber como se registrar no Oracle Cloud, provisionar uma instância do Oracle Content Management e configurar o Oracle Content Management como um CMS sem interface do usuário.

Para este tutorial, você precisará criar um modelo de conteúdo. Há um pacote de ativos descarregáveis disponível que preencherá seu repositório vazio com tipos de conteúdo e conteúdo associado.

Para preparar o Oracle Content Management:

1. Criar um repositório de canais e ativos
2. Importar o Pacote de Ativos de Amostras do Oracle Content Management

Criar um Repositório de Ativos e Canal

Primeiro você precisa criar um canal e um repositório de ativos no Oracle Content Management para que possa publicar conteúdo.

Para criar um canal e um repositório de ativos no Oracle Content Management:

1. Efetue log-in na interface Web do Oracle Content Management como administrador.

2. Escolha Conteúdo no menu de navegação à esquerda e escolha Publicando Canais na lista de seleção no cabeçalho da página.

   

3. No canto superior direito, clique em Criar para criar um novo canal. Nomeie o canal 'ODAChatbotChannel' para a finalidade deste tutorial e mantenha o acesso público. Clique em Salvar para criar o canal.

   

4. Escolha Conteúdo no menu de navegação à esquerda e escolha Repositórios na lista de seleção no cabeçalho da página.

   

5. No canto superior direito, clique em Criar para criar um novo repositório de ativos. Nomeie o repositório de ativos 'ODAChatbotRepository' para a finalidade deste tutorial.

   

6. No campo Canais de Publicação, selecione o canal ODAChatbotChannel para indicar ao Oracle Content Management que o conteúdo no repositório ODAChatbotRepository pode ser publicado no canal ODAChatbotChannel. Clique em Salvar quando terminar.

   

Importar o Pacote de Ativos de Amostras do Oracle Content Management

Você pode fazer download de um pacote de ativos de amostra do Gerenciamento de Conteúdo pré-configurado que contenha todos os tipos de conteúdo, ativos e taxonomias necessários para este tutorial.

Você pode fazer upload de uma cópia do conteúdo que estamos usando neste tutorial a partir do Pacote de Ativos de Amostras de Gerenciamento de Conteúdo. Isso permitirá que você experimente os tipos de conteúdo e modifique o conteúdo. Se quiser importar o Pacote de Ativos de Amostras do Gerenciamento de Conteúdo, você poderá fazer download do arquivo compactado do pacote de ativos, OCESamplesAssetPack.zip e extraí-lo para um diretório de sua escolha:

1. Faça download do Pacote de Ativos de Amostras do Gerenciamento de Conteúdo (OCESamplesAssetPack.zip) na página downloads do Oracle Content Management. Extraia o arquivo zip baixado para um local no computador. Após a extração, esse local incluirá um arquivo chamado OCEODAChatbot_data.zip.

2. Efetue log-in na interface Web do Oracle Content Management como administrador.

3. Escolha Conteúdo no menu de navegação à esquerda e escolha Repositórios na lista de seleção no cabeçalho da página. Agora selecione ODAChatbotRepository e clique em Importar Conteúdo na barra de ação superior.

   

4. Faça upload do OCEODAChatbot_data.zip do computador local para a pasta Documentos.

   

5. Após fazer upload, selecione OCEODAChatbot_data.zip e clique em OK para importar o conteúdo para o repositório de ativos.

   

6. Depois que o conteúdo tiver sido importado com sucesso, navegue até a página Ativos e abra o repositório ODAChatbotRepository. Você verá que todas as imagens, itens de conteúdo e taxonomias relacionadas foram adicionados ao repositório de ativos.

   

7. Clique em Selecionar Tudo no canto superior esquerdo e em Publicar para adicionar todos os ativos importados ao canal de publicação criado anteriormente, ODAChatbotChannel.

   

8. Antes da publicação, é necessário validar todos os ativos. Primeiro, adicione ODAChatbotChannel como um canal selecionado e, em seguida, clique no botão Validar.

   

9. Depois que os ativos tiverem sido validados, você poderá publicar todos os ativos no canal selecionado clicando no botão Publicar no canto superior direito.

   

   Quando isso for feito, você poderá ver na página Ativos que todos os ativos foram publicados. (Você pode informar pelo ícone acima do nome do ativo.)

   

10. Escolha Conteúdo no menu de navegação à esquerda e escolha Taxonomias na lista de seleção no cabeçalho da página.

    

11. Na página Taxonomias, selecione a taxonomia SE2 Categorias (SEC) e clique em Publicar na barra de ações para disponibilizá-la para uso. Publique a taxonomia de Produtos (SEP) SE2 da mesma maneira.

Tarefa 2: Criar a Habilidade do Oracle Digital Assistant

Para consumir nosso conteúdo do Oracle Content Management em um aplicativo de chatbot do ODA, podemos usar a amostra de chatbot do ODA do Content Management, que está disponível em um repositório de código-fonte aberto no GitHub.

Observação: Lembre-se de que o uso da amostra de chatbot do ODA é opcional e nós a usamos neste tutorial para começar rapidamente. Você também pode criar seu próprio aplicativo de chatbot.

Para criar a habilidade do chatbot no ODA:

1. Clonar o repositório de amostra
2. Importe a habilidade do ODA para sua instância
3. Configurar e configurar o serviço de componente personalizado
4. Trabalhar com o SDK do Oracle Content Management Content
5. Usar o SDK de Conteúdo para extrair conteúdo
6. Empacotar e implantar o serviço de componente personalizado

Clonar o Repositório de Amostra

A amostra de chatbot do ODA do Content Management está disponível no repositório de código-fonte aberto no GitHub. Primeiro você precisará clonar o repositório de amostra do GitHub para seu computador local e alterar seu diretório para trabalhar com essa amostra.

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

Agora que você tem sua base de código, vamos dar uma olhada mais de perto nas pastas que você usará neste tutorial:

• A pasta ODAChatbot é uma habilidade de chatbot.

  

• A pasta sales-enablement-custom-component é um componente personalizado do ODA.

  

• A pasta WebApp é um aplicativo Web.

  

Observação: A pasta site-integration-chatbot-sample faz parte da amostra do chatbot de integração do site. Você pode aprender mais sobre este exemplo aqui.

Importar a Habilidade ODA para sua Instância

A pasta ODAChatbot na base de código é a habilidade ODA usada neste tutorial. Siga estas etapas para criar e treinar sua habilidade na instância do ODA:

1. Na sua instância do Oracle Digital Assistant, abra o menu de navegação à esquerda, clique em Desenvolvimento e, em seguida, em Habilidades.

   

2. Procure a habilidade Chatbot do ODA.

   Observação: Se sua instância não tiver essa habilidade, selecione o conteúdo da pasta ODAChatbot e compacte-os em um único arquivo zip. Na página Habilidades da instância do ODA, clique em Importar Habilidade e importe o arquivo zip que você acabou de criar. A compactação direta da pasta ODAChatbot resultará em um erro na importação.

3. No cartão de habilidade Chatbot do ODA, clique no ícone de opções e em Clonar.

   

4. Dê à habilidade clonada um nome de exibição exclusivo; por exemplo, adicione suas iniciais no início, como 'AB - Chatbot do ODA'. Deixe todos os outros valores inalterados. Selecione Abrir habilidade clonada posteriormente e clique em Clonar.

   Observação: O nome deve começar com uma letra e só pode conter letras, números, pontos e sublinhados. Não pode exceder 100 caracteres.

   

5. Clique em Treinar, verifique se o Trainer Ht está selecionado e clique em Submeter para treinar a habilidade.

   Observação: Você usa o treinamento Ht neste tutorial, rápido mas superficial. Para trabalho de produção, você deve usar o treinamento Tm, o que resulta em melhor resolução de intenção.

   

Habilidade de Chatbot de ODA

Habilidades são chatbots individuais projetados para interagir com usuários e cumprir tipos específicos de tarefas, como pedir comida, fazer reservas e alterar informações de contato. A habilidade ODAChatbot ajuda um usuário a encontrar anúncios e histórias de capacitação de vendas apropriadas por meio de uma combinação de mensagens de texto e elementos simples da interface do usuário, como listas de seleção.

Antes de se aprofundar no desenvolvimento de assistentes digitais e habilidades, estes são alguns dos conceitos com os quais você vai querer se familiarizar:

• Intenções - Categorias de ações ou tarefas que os usuários esperam que sua habilidade execute por eles. Em nossa habilidade, há duas intenções:

  • Saudações: esta intenção mostra uma mensagem de boas-vindas ao usuário.
  • StoryIntent: Esta intenção mostra menus e itens de conteúdo apropriados do Oracle Content Management.

• Entidades - Variáveis que identificam as principais informações da entrada do usuário que permitem à habilidade cumprir uma tarefa. Em nossa habilidade, há sete entidades:

  • TopMenu: Esta é uma entidade da lista de valores que contém os itens de menu.
  • HomeMenu: Essa é uma entidade da lista de valores que contém as categorias do menu Home.
  • CafeSupremoMenu: Esta é uma entidade da lista de valores que contém as categorias do menu Cafe Supremo.
  • LearningMenu: Essa é uma entidade da lista de valores que contém as categorias do menu Aprendizado.
  • SellingMenu: Essa é uma entidade da lista de valores que contém as categorias do menu Venda.
  • MenuBag: É uma entidade composta de entidades de item de menu; ou seja, as entidades HomeMenu, CafeSupremoMenu, LearningMenu e SellingMenu.
  • StoryCategory: Essa é uma entidade da lista de valores que contém todas as categorias de história.

  Intenções e entidades são conceitos comuns de NLP (Natural Language Processing). NLP é a ciência de extração da intenção do texto e das informações relevantes do texto.

• Componentes - Eles fornecem à sua habilidade várias funções para que ela possa responder aos usuários. Podem ser funções genéricas, como gerar texto, ou componentes personalizados, que podem retornar informações de um backend e executar lógica personalizada. Em nossa habilidade, há um serviço de componente personalizado, sales-enablement-custom-component, que extrai os itens de conteúdo do Oracle Content Management por meio de APIs REST.

• Fluxo de caixas de diálogo - A definição para a interação entre usuário e habilidade. O fluxo de caixas de diálogo descreve como sua habilidade responde e comportamento de acordo com a entrada do usuário.

• Canais - Os usuários podem acessar assistentes digitais e habilidades por meio de plataformas de mensagens ou aplicativos de mensagens do cliente. Um único assistente digital ou habilidade pode ter vários canais configurados, de forma que pode ser executado em diferentes serviços simultaneamente. Neste tutorial, usamos o canal Oracle Web para acessar nossa habilidade em um aplicativo Web.

Para saber mais sobre o Oracle Digital Assistant e habilidades, confira a documentação do produto.

Configurar e Configurar o Serviço de Componente Personalizado

A pasta sales-enablement-custom-component na base de código é o componente personalizado do ODA usado neste tutorial. Primeiro, precisamos fazer download das dependências desse componente personalizado do ODA. Execute o seguinte comando no diretório headless-chatbot-sample/sales-enablement-custom-component:

npm install

Em seguida, precisamos configurar algumas informações para que nosso SDK do Oracle Content Management Content (e qualquer outra solicitação) possa direcionar o URL da instância e a versão da API corretos com o token de canal correto.

Esses valores são usados em componentes/server-config-utils.js para instanciar um novo cliente de entrega.

Abra o arquivo server-config-utils.js em um editor de texto. Você verá o seguinte:

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

Altere cada par de chave/valor para refletir o URL da sua instância, a versão da API que você deseja direcionar e o token do canal associado ao seu canal de publicação. Por exemplo, o canal que criamos neste tutorial é ODAChatbotChannel.

Trabalhar com o SDK do Oracle Content Management Content

O Oracle Content Management oferece um SDK para ajudar a descobrir e usar conteúdo em seus aplicativos. O SDK é publicado como um módulo NPM e o projeto é hospedado no GitHub.

Saiba mais sobre o SDK aqui.

O SDK foi registrado como uma dependência de runtime deste projeto nos arquivos package.json.

Usar o Content SDK para Obter Conteúdo

Agora podemos aproveitar o SDK de Conteúdo para extrair conteúdo da habilidade de chatbot por meio do componente personalizado do ODA.

A pasta Components/services.js contém o código para obter dados do Oracle Content Management usando o SDK de Conteúdo.

O arquivo Components/server-config-utils.js importa o SDK de Conteúdo e, em seguida, cria um cliente de entrega usando a configuração especificada nele.

O seguinte comando importa o SDK:

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

O seguinte comando cria o cliente de entrega:

deliveryClient = createDeliveryClient(serverconfig);

O arquivo sales-enablement-custom-component/components/services.js contém todo o código para obter os itens de conteúdo do chatbot. Há uma função principal para extrair todo o conteúdo do chatbot.

As seguintes funções são chamadas para recuperar todos os dados de uma categoria de taxonomia específica do repositório 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(),
           }));
       });
    }

A função getStoryData faz dois conjuntos diferentes de chamadas, dependendo de a solicitação ser feita para a categoria anúncios ou story.

Dados de Anúncios

Ela exige uma chamada de dados para obter todos os itens de conteúdo dos anúncios.

A função getStoryData chama fetchItemsForAnnouncements, que obtém todos os itens de conteúdo do tipo 'SE2-Announcements'. Em seguida, a função retrieveAnnouncementsObject é chamada e os campos de título e resumo do objeto de resultado são preenchidos com os dados de fetchItemsForAnnouncements.

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

Dados da História

Ele requer várias chamadas de dados para obter todos os itens de conteúdo para as Histórias.

1. Primeiro, obtemos todos os itens de conteúdo da categoria solicitada pelo usuário.

2. Para cada item de conteúdo que obtemos, fazemos uma chamada para recuperar o URL da mídia.

A função getStoryData chama fetchItemsForCategoryName, que obtém todos os itens de conteúdo do tipo 'SE2-Story' e o nome da categoria de taxonomia, conforme especificado pelo usuário.

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

O item de conteúdo extraído por fetchItemsForCategoryName tem um campo de ID de mídia. A função retrieveMediaURL usa esse id de mídia para extrair o URL da mídia.

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

Empacotar e Implantar o Serviço de Componente Personalizado

Você pode implantar componentes personalizados em um contêiner incorporado para uma habilidade, um servidor de Nós remoto ou o Oracle Mobile Hub. Neste tutorial, você implantará seu serviço de componente personalizado em um contêiner incorporado. Para fazer isso, primeiro é necessário empacotar o serviço de componente personalizado em um arquivo implantável:

1. Salve o trabalho no JavaScript IDE.

2. Abra uma janela de terminal e navegue até a pasta sales-enablement-custom-component.

3. Na pasta sales-enablement-custom-component, digite o seguinte comando npm

   bots-node-sdk pack

   Devido ao script prepack no arquivo package.json, o comando primeiro executa o comando prepack para verificar o pacote. Em seguida, o comando empacota o projeto Nó e suas dependências em um tarball implantável denominado sales-enablement-custom-component-1.0.0.tgz.

   Seu tarball deve incluir todas as dependências, exceto devDependencies.

4. Na habilidade Chatbot do ODA, clique no ícone Componentes na barra esquerda para abrir a página de serviço do componente. Clique em + Serviço para criar um novo serviço.

   

5. Na caixa de diálogo Criar Serviço, faça o seguinte:

   1. No campo Name, digite SalesEnablementCustomComponent.

   2. No campo Descrição, é possível adicionar uma descrição opcional.

   3. Certifique-se de que a opção Contêiner Incorporado esteja selecionada.

   4. Arraste e solte ou faça upload do arquivo sales-enablement-custom-component-1.0.0.tgz no campo Arquivo de Pacote.

   5. Clique em Criar.

   

6. Aguarde o campo Status para mostrar Pronto, que pode demorar alguns segundos.

7. Com o serviço de componente personalizado implantado no contêiner incorporado da habilidade, você está pronto para testar o componente.

Para saber mais sobre o Oracle Digital Assistant e os componentes personalizados, confira a documentação de treinamento.

Tarefa 3: Configurar um Aplicativo Web para seu Chatbot

A habilidade do ODA criada anteriormente pode ser implantada e usada em várias plataformas. Para saber mais sobre os diferentes canais suportados pelo ODA, confira a documentação.

Neste tutorial, criaremos um canal Oracle Web para permitir que um widget de chat do Oracle Web se conecte à sua habilidade.

Observação: Um problema com a adição de chats a clientes Web é que hackers podem acessar a habilidade e as conversas ativas, a menos que você proteja o acesso ao canal Oracle Web, ao cliente Web e à sessão de chat. Com uma console simples do navegador, eles podem inspecionar os URIs REST e obter o ID de usuário e o ID de canal da conversa. Para saber como proteger seu canal Oracle Web, consulte este tutorial.

A implantação da habilidade Chatbot do ODA na Web consiste em duas etapas:

1. Criar um canal Web do Oracle Digital Assistant

2. Configurar seu aplicativo Web

Criar um Canal Web do Oracle Digital Assistant

Você criará um canal de usuário do Oracle Digital Assistant que permite que um cliente Oracle Web acesse sua habilidade. Para garantir que somente seus clientes Web possam usar esse canal, você o configurará para exigir autenticação do cliente.

1. Em sua instância do Oracle Digital Assistant, abra o menu de navegação à esquerda, clique em Desenvolvimento e, em seguida, em Canais.

   

2. Na página Canais, clique em + Canal para adicionar um canal.

3. Na página Criar Canais, digite estas informações conforme mostrado na captura de tela abaixo:

   • Nome: Um nome exclusivo que começa com uma letra e contém apenas letras, números, pontos e sublinhados (_), por exemplo, AB_ODAChatbot.
   • Descrição: (Opcional) Para que canal é usado.
   • Tipo de Canal: Oracle Web.
   • Domínios Permitidos: * (Um asterisco único permite qualquer domínio.)
   • Autenticação do Cliente Ativada: Deixe-a na posição desativada.

   

4. Clique em Criar.

5. Na lista drop-down Rotear para, selecione a habilidade que você deseja usar para este tutorial.

   

6. Alterne a opção Canal Ativado para Ativado.

7. Observe o ID do canal que é mostrado para este canal. Mais tarde neste tutorial, você usará esse valor em seu aplicativo Web.

   

8. Observe também o host e o domínio do Oracle Digital Assistant (que é referenciado como o nome de domínio totalmente qualificado) do URL da instância que aparece no campo de endereço do browser da Web, por exemplo, oda-xxxx.data.digitalassistant.oci.oraclecloud.com. Você usará esse valor posteriormente no tutorial.

Sua instância agora está configurada para você conectar um chatbot em uma página Web à habilidade.

Configurar Seu Aplicativo Web

A próxima etapa é configurar seu aplicativo Web:

1. Faça download da versão mais recente do Oracle Web SDK e descompacte-a em uma pasta à sua escolha. Você também pode ir até a página de download desse SDK na sua instância do Digital Assistant, abrindo o menu lateral e clicando em Downloads.

2. Copie o arquivo nativo-client-sdk-js/web-sdk.js da pasta do Oracle Web SDK e coloque-o na pasta WebApp/scripts.

   

   O SDK se conecta ao Oracle Chat Server, que fica entre o Oracle Digital Assistant e a habilidade (ou o assistente digital). O servidor de chat transmite mensagens à habilidade para processamento e entrega a resposta da habilidade ao cliente.

3. Abra o arquivo WebApp/scripts/settings.js em um editor. Defina estas propriedades chatWidgetSettings:

   • URI: O nome do host e do domínio que você anotou ao criar o canal Oracle Web, por exemplo xxxx.xxx.digitalassistant.xxx.xxx.com. Não inclua https://.

   • channelId: O ID do canal que você criou anteriormente.

   Veja um exemplo:

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

4. Salve e feche o arquivo.

Seu canal Web da Oracle junto com seu aplicativo Web está pronto. Agora você está pronto para executar seu aplicativo de chatbot e vê-lo em ação.

Tarefa 4: Implantar Seu Aplicativo

Agora que criamos nossa amostra de Chatbot do Content Management ODA, precisamos vê-la em um navegador local para que possamos depurar qualquer problema e visualizar o aplicativo antes que ele entre em operação.

1. Abra o arquivo WebApp/index.html em um navegador da Web.

2. Seu aplicativo Web deve ser exibido com a janela de chat aberta. Se o widget de chat não estiver aberto, clique no ícone de chat para abri-lo.

3. Converse com a habilidade para verificar se seu aplicativo Web está configurado corretamente.

---

Título e Informações de Copyright

Crie um Chatbot do Oracle Digital Assistant com o Oracle Content Management sem supervisão

F52685-01

Janeiro de 2022

Copyright © 2021, 2022, Oracle and/or its affiliates.

Autor Principal: Oracle Corporation