O serviço Intelligent Advisor, em conjunto com o componente de fluxo de caixas de diálogo do Intelligent Advisor no Oracle Digital Assistant, permite que você integre uma entrevista do Oracle Intelligent Advisor em sua habilidade.

Quando uma habilidade realiza uma entrevista, ela exibe cada campo de forma apropriada para o canal, conforme descrito em Como os Artefatos São Exibidos em uma Conversa. Para navegar pela entrevista, os clientes respondem à pergunta ou dizem um dos seguintes comandos de barra:

A integração de sua habilidade com uma entrevista é um processo de três etapas.

1. Adicionar uma integração de serviço do Intelligent Advisor.
2. (Opcional, mas altamente recomendado) Crie uma variação "conversacional" da entrevista.
3. Adicionar um componente do Intelligent Advisor ao fluxo de diálogo da sua habilidade.

Para poder acessar as entrevistas do Oracle Intelligent Advisor de qualquer habilidade, adicione um serviço do Intelligent Advisor, que configura a conexão entre o Oracle Digital Assistant e um cliente de API do Intelligent Advisor Hub.

Nós orientaremos você nas etapas de obtenção das informações do cliente da API no Intelligent Advisor Hub e na criação do serviço do Intelligent Advisor no Digital Assistant. As etapas no Intelligent Advisor Hub devem ser concluídas por um administrador de Hub.

1. No Intelligent Advisor Hub, clique em para abrir o menu lateral, clique em Permissões e, em seguida, clique na guia Espaços de Trabalho.

2. Clique na coleção desejada e certifique-se de que o Serviço de Chat esteja selecionado para que, quando as implantações na coleção forem ativadas, elas sejam ativadas para o serviço de chat por padrão.

3. Clique na guia Clientes de API tab.

4. Se você não vir um cliente com a atribuição de Serviço de Chat, designe a atribuição a um dos clientes existentes ou crie um com a atribuição de Serviço de Chat ativada.

5. Abra o cliente de API, certifique-se de que o cliente esteja ativado e anote o segredo e o identificador do cliente de API, que você precisará para criar o serviço do Intelligent Advisor.

6. Selecione Administrador do Hub para a página ou selecione Gerente para o espaço de trabalho. Se nenhum deles for selecionado, você não poderá exibir as implantações de chat ativas do Hub na página de serviço do Intelligent Advisor. Você também não poderá criar novas habilidades diretamente na página de serviço.

7. Você pode sair do Hub.

   No Digital Assistant, clique em para abrir o menu lateral, clique em Definições, clique em Serviços Adicionais e clique na guia Intelligent Advisor.

8. Clique em + Serviço.

9. Na caixa de diálogo Novo Serviço do Intelligent Advisor, forneça um nome exclusivo para o serviço.

   Esse é o nome que você usará para a propriedade Nome do Serviço do Intelligent Advisor do componente do Intelligent Advisor no fluxo de caixas de diálogo da sua habilidade.

10. Digite o host do Intelligent Advisor Hub. Saia do prefixo https://. Por exemplo: myhub.example.com.

11. Defina o ID do Cliente e o Segredo do Cliente como identificador e segredo do cliente de API que você anotou anteriormente.

12. Clique em Criar.

13. Clique em Verificar Definições para garantir que uma conexão possa ser feita usando as definições informadas.

À medida que você cria habilidades que usam o serviço, a página de serviço do Intelligent Advisor exibirá os nomes das habilidades e as implantações do Hub que as habilidades usam. Você pode abrir o testador de habilidades para qualquer uma dessas habilidades diretamente na página do serviço. Você também pode criar habilidades diretamente nesta página. Consulte Página Criar e Testar Habilidades do Serviço Intelligent Advisor.

Para mais informações sobre clientes de API, consulte Ativar um projeto e Atualizar os detalhes de uma cliente de API na Documentação do Intelligent Advisor.

A página de serviço do Intelligent Advisor lista todas as habilidades que usam as implantações de chat ativas do Hub e você pode executar o testador de habilidades para qualquer uma das habilidades listadas. Além disso, nessa página, você pode criar uma habilidade que acesse uma implantação ativa.

Para testar uma habilidade que está na lista, clique no ícone Testar esta Habilidade que aparece ao lado do nome da habilidade. Quando o Testador de Conversas for aberto, inicie a conversa. Com habilidades típicas, você pode simplesmente digitar hi e pressionar Enter para começar. No entanto, às vezes a habilidade está procurando frases específicas. Nesse caso, se você inserir uma frase que não entenda, ela deve dar instruções sobre o que digitar.

Para criar uma habilidade na página de serviço do Intelligent Advisor, selecione um serviço para usuários anônimos e clique em + Nova Habilidade. (As habilidades não podem acessar implantações ativadas para usuários do portal ou usuários do agente.) Forneça um nome para exibição para a habilidade, selecione uma implantação na lista drop-down e clique em Criar. A nova habilidade aparece na lista de habilidades que usam o serviço.

Para ver uma lista das implantações do Hub que você pode acessar de habilidades, vá para Serviços Adicionais, clique em Intelligent Advisor, selecione o serviço do Hub e clique em Implantações.

Se uma implantação estiver ativada para Web, você verá o ícone Iniciar entrevista para Web ao lado de seu nome. Você pode clicar no ícone para executar a entrevista em uma nova guia do navegador.

Para acessar a implantação no Hub, clique em Gerenciar implantação .

Descrição da ilustração ia-deployments.png

Se o cliente de API do serviço não tiver o administrador do Hub ou o Gerente selecionado, a página não poderá exibir as implantações e você receberá uma notificação de que não tem permissão para executar a operação. Consulte Adicionar um Serviço do Intelligent Advisor.

Embora não seja um requisito difícil, você pode aumentar drasticamente a eficácia das entrevistas do Oracle Intelligent Advisor baseadas em chat, empregando técnicas de conversa.

A maioria das entrevistas é otimizada para forms em páginas web, nas quais labels de tela, labels de seção e tipos de componente, como listas drop-down e caixas de seleção, fornecem dicas visuais sobre o contexto da pergunta e as opções que você pode fazer. Como as conversas de habilidades são diferentes das interfaces web tradicionais, talvez você não consiga simplesmente usar sua entrevista baseada em form para uma conversa. Para ilustrar o ponto, peça a uma pessoa que se junte a você e sente-se de costas, com uma pessoa agindo como o bot e a outra agindo como o entrevistado. Leia sua entrevista baseada em formulário em voz alta (ler cada rótulo e prompt) e pergunte a si mesmo se essa é uma conversa que você acha que seus clientes gostariam de ter com um bot.

Em vez de reutilizar uma entrevista criada especificamente para uma página web, considere criar uma variação mais conversacional. Como você vai querer usar o mesmo modelo de política da única fonte de verdade, use o recurso Inclusões do Oracle Intelligent Advisor para criar entrevistas adicionais para esse modelo de política. Consulte Inclusões em Documentação do Intelligent Advisor. Como alternativa, considere transmitir dados pré-implantados para a entrevista para indicar que a entrevista está sendo conduzida em uma habilidade e fazer com que a entrevista oculte ou exiba artefatos adequadamente, semelhante às etapas descritas em Personalizar entrevistas multicanais para diferentes tipos de usuário na Documentação do Intelligent Advisor, exceto pelo fato de você usar seu próprio atributo. Consulte Valores de Atributo de Aprovação e Parâmetros de Conexão.

Veja aqui um exemplo. A entrevista a seguir apresenta um conjunto de alternâncias de imagens. Em uma página web, o usuário pode clicar nas imagens que se aplicam.

Quando realizada em uma habilidade, a entrevista apresenta cada imagem e pergunta ao usuário se o sinal está presente. O usuário precisa responder Sim ou Não para cada sinal, conforme mostrado neste exemplo.

Como as regras dessa entrevista só se importam se algum sinal está presente, a entrevista pode ser otimizada para uma habilidade exibindo uma única imagem com todos os sinais e fazendo apenas uma pergunta: "Um desses sinais está presente?" As regras simplesmente precisam ser modificadas para adicionar uma condição para there is any sign present, conforme mostrado aqui.

dangerous goods need to be handled if  
  there is a combustibles sign present or
  there is an explosives sign present or
  there is a flammable gas sign present or
  there is an inhalation sign present or
  there is a nonflammable sign present or
  there is an oxygen sign present or
  there is a flammable solid sign present or
  there is any sign present

Observe também que o texto de lead-in não se aplica ao comportamento da conversa da habilidade; portanto, deve ser modificado ou ocultado.

Antes de acessar uma entrevista anônima de uma habilidade, peça ao administrador do Digital Assistant para adicionar um serviço do Intelligent Advisor à sua instância e solicite que um Gerente de Hub implante sua entrevista no Intelligent Advisor Hub e ative-a para o serviço de chat. Depois que essas tarefas forem concluídas, você poderá acessar a entrevista por meio de sua habilidade adicionando o componente do Intelligent Advisor ao seu fluxo de caixas de diálogo.

Dica:

Você pode criar rapidamente a habilidade na página de serviço do Intelligent Advisor. Clique em para abrir o menu lateral, clique em Definições, clique em Serviços Adicionais, clique na guia Intelligent Advisor e, em seguida, clique em + Nova Habilidade. Dê à habilidade um nome para exibição e selecione a implantação na lista drop-down.

As etapas a seguir orientam você pelo uso do componente em uma habilidade criada para o modo de caixa de diálogo Visual.

1. Em sua habilidade, clique em Entidades para exibir a página Entidades e selecione a entidade DATE.

2. Alterne Considerar Localidade do Usuário Final para Ativado e selecione Mais Próximo no menu suspenso Resolver Data como.

   A entrevista usa essas definições para determinar o formato de data de entrada e interpretar datas ambíguas, conforme descrito em Regras de Resolução de Ambiguidade para Correspondências de Data e Hora e Resolução de Data Baseada em Local.

3. Verifique se a opção Considerar Localidade do Usuário Final está ativada para as entidades MOEDA e NÚMERO.

4. Clique em Fluxos e selecione o fluxo no qual você deseja inserir o componente do Intelligent Advisor.

5. Passe o mouse sobre a linha que conecta os dois componentes onde você deseja inserir o novo componente e clique em
   
   
   
   .
6. No campo Pesquisar da caixa de diálogo Adicionar Estado, digite intell e selecione o componente do Intelligent Advisor que é exibido.
7. Preencha os campos Nome e Descrição e clique em Inserir.

8. No inspetor de propriedades do componente recém-adicionado, defina a propriedade Nome do Serviço do Intelligent Advisor do componente com o nome do serviço que foi adicionado à página Definições > Serviços Adicionais > Intelligent Advisor.

9. Defina Nome do Projeto de Implantação com o nome da entrevista anônima que foi implantada no Intelligent Advisor Hub.

   Dica:

   Se você não tiver certeza sobre a ortografia exata do nome, vá para Serviços Adicionais, clique em Intelligent Advisor, selecione o serviço do Hub e clique em Implantações para ver uma lista dos nomes de implantação.

10. Se quiser que o componente oculte os títulos de tela, defina Ocultar Todos os Títulos de Tela como true. Por padrão, a entrevista exibe títulos de tela.

11. Por padrão, a entrevista não exibe a explicação. Você pode definir a propriedade Mostrar Explicação como always para exibir a explicação toda vez ou como ask se quiser que o usuário escolha se deseja ver a explicação.

12. Se a habilidade já tiver obtido valores para qualquer um dos atributos da entrevista, você poderá usar a propriedade Pré-implantar Dados para transmitir os valores. Caso contrário, remova a propriedade.

    Consulte Informar Valores de Atributo e Parâmetros de Conexão para saber como usar dados pré-implantados e como usar os dados em uma entrevista.

13. Por padrão, a habilidade gera a marcação HTML e CSS da entrevista. Se a entrevista contiver marcação HTML e CSS que faça com que a conversa contenha linhas em branco desnecessárias, considere definir Remover Tags HTML da Saída como true.

14. Se a entrevista esperar uma determinada moeda, defina Moeda Esperada da Entrevista como o código ISO-4217 para a moeda esperada. Quando um código é especificado, o usuário só pode inserir valores de moeda nos formatos permitidos para essa moeda.

15. Adicione um estado para tratar o erro que será gerado se houver um problema com a integração do Intelligent Advisor.
    • No insector de propriedade, selecione a guia Transições.
    • Crie uma nova Ação e nomeie-a como error.
    • No campo Transição para, selecione Adicionar Estado.
    • Selecione o modelo Enviar Mensagem ou um dos modelos de Envio de Mensagens do Usuário, preencha um Nome e uma Descrição e clique em Inserir.

      Um novo componente deve ser inserido no fluxograma com uma transição de erro conectando-o ao componente do Intelligent Advisor

    • Selecione o componente recém-inserido e insira e insira o texto que deseja que os usuários vejam no caso de um erro, por exemplo.

      We are having a problem with a connection. Can you please send email to contact@example.com to let them know that the loan advisor isn't working? Thank you.
16. (Opcional), ajuste as strings que são usadas pelo componente para rótulos e mensagens padrão. Consulte Entradas de Pacote de Recursos para o Intelligent Advisor.

17. Se a habilidade puder ser acessada por canais somente texto, certifique-se de que a definição de configuração Ativar Numeração Automática em Ações de Postback em Fluxos de Tarefas da habilidade esteja definida como true ou para uma expressão que seja resolvida como true para canais somente texto, como a seguinte expressão:

    ${(system.channelType=='twilio'||system.channelType=='osvc' )?then('true','false')}

    Isso permite que o usuário simplesmente selecione uma opção digitando um número em vez do texto completo da opção.

    Você pode acessar essa definição selecionando
    
    na navegação esquerda da habilidade e selecionando a guia Configuração.

18. (Opcional), Clique em Visualizar e teste a entrevista para todos os canais que poderão acessar a habilidade.

Para obter detalhes sobre cada uma das propriedades do componente, consulte Propriedades do Intelligent Advisor.

Para obter detalhes sobre cada uma das propriedades da versão YAML do componente e um exemplo simples de seu uso, consulte System.IntelligentAdvisor.

Se sua habilidade já tiver obtido valores para os atributos de uma entrevista, você poderá usar a propriedade Implantar Dados no componente do Intelligent Advisor para transmitir os valores para a entrevista. Se sua entrevista exigir parâmetros para conectores de serviço Web, você poderá usar a propriedade Parâmetros de Conexão para transmitir os valores.

Use a propriedade Pré-implantar Dados para definir pares de chave/valor a fim de transmitir valores para qualquer atributo de entrevista que tenha a opção Pré-implantar do parâmetro de URL ativada. Encontre essa opção na caixa de diálogo Editar Atributo no Oracle Policy Modeling.

A entrevista usa os valores Dados Pré-implantados para definir valores padrão, que são exibidos como valores sugeridos.

Se quiser que a entrevista ignore a tela ou a etapa se dados pré-implantados forem fornecidos para ela, siga estas etapas no Policy Modeling:

1. Adicione uma regra para determinar se os dados pré-implantados foram fornecidos:

   • Para um atributo Booliano, use esta regra:

     The <screen name> screen should be shown if
           <attribute name> is uncertain or
           <attribute name> is currently unknown

   • Para um atributo não booliano, use esta regra:

     The <screen name> screen should be shown if
           <attribute name> is currently unknown

2. Na guia Entrevista, selecione a tela, clique em Mostrar Tela se e selecione a regra na lista drop-down Mostrar se.

   
   
   Descrição da ilustração ia-show-screen-if.png
   

   Se você tiver mais de uma pergunta na tela e quiser ocultar apenas a pergunta, em vez de usar o botão Mostrar Tela se, selecione a pergunta, clique em Obrigatório e selecione a regra na lista drop-down Mostrar se.

Para saber mais sobre dados pré-implantados e como usá-los em uma entrevista, consulte estes artigos na Documentação do Intelligent Advisor:

Se sua entrevista usar um conector de serviço Web que contenha mapeamentos de dados para dados do aplicativo, você usará a propriedade Parâmetros de Conexão para definir pares de chave/valor para transmitir dados ao conector.

Para saber mais sobre parâmetros, consulte Integração de dados em Documentação do Intelligent Advisor.

Se precisar acessar os valores de atributos nomeados que foram definidos durante a entrevista, você poderá usar a propriedade Variável para Resultados da Entrevista para informar o nome de uma variável de lista. Os valores de atributo nomeado serão armazenados nessa variável como uma matriz de pares de chave/valor.

Se o usuário sair da entrevista antes da conclusão, a variável nomeada por Variável para Resultados da Entrevista não será criada.