El servicio Intelligent Advisor, junto con el componente de flujo de diálogo Intelligent Advisor en Oracle Digital Assistant, permite integrar una entrevista de Oracle Intelligent Advisor en la aptitud.

Cuando una aptitud realiza una entrevista, muestra cada campo de la manera adecuada para el canal, como se describe en Cómo se muestran los artefactos en una conversación. Para navegar por la entrevista, los clientes responden a la pregunta o dicen uno de los siguientes comandos slash:

La integración de su aptitud con una entrevista es un proceso de tres pasos.

1. Agregar una integración de servicio de Intelligent Advisor.
2. (Opcional, pero altamente recomendado) Crear una variación "conversacional" de la entrevista.
3. Agregar un componente de Intelligent Advisor a el flujo de diálogo de la aptitud.

Para poder acceder a las entrevistas de Oracle Intelligent Advisor desde cualquier aptitud, debe agregar un servicio de Intelligent Advisor, que configura la conexión entre Oracle Digital Assistant y un cliente de API del hub de Intelligent Advisor.

Le guiaremos por los pasos para obtener la información de cliente de API del hub de Intelligent Advisor y para crear el servicio de Intelligent Advisor en Digital Assistant. Los pasos del hub de Intelligent Advisor los debe realizar un administrador de hub.

1. En el hub de Intelligent Advisor, haga clic en para abrir el menú lateral, haga clic en Permisos y, a continuación, haga clic en el separador Espacios de trabajo.

2. Haga clic en la recopilación que desee y asegúrese de que Servicio de chat esté seleccionado para que cuando se activen los despliegues de la recopilación, se activen para el servicio de chat por defecto.

3. Haga clic en el separador Clientes de API.

4. Si no ve un cliente que tenga el rol Servicio de chat, asigne el rol a uno de los clientes existentes o cree uno con el rol Servicio de chat activado.

5. Abra el cliente de API, asegúrese de que el cliente está activado y anote el secreto y el identificador del cliente de API, que necesitará para crear el servicio de Intelligent Advisor.

6. Seleccione Administrador de hub para la página o seleccione Mánager para el espacio de trabajo. Si no se selecciona ninguna de estas opciones, no podrá mostrar los despliegues de chat activos del hub desde la página de servicio de Intelligent Advisor. Tampoco podrá crear nuevas aptitudes directamente desde la página de servicio.

7. Puede desconectarse del hub.

   En Asistente digital, haga clic en para abrir el menú lateral, haga clic en Configuración, haga clic en Servicios adicionales y haga clic en el separador Intelligent Advisor.

8. Haga clic en Agregar servicio.

9. En el cuadro de diálogo Nuevo servicio de Intelligent Advisor, proporcione un nombre único para el servicio.

   Este es el nombre que utilizará para la propiedad Nombre de servicio de Intelligent Advisor del componente de Intelligent Advisor en el flujo de diálogo de la aptitud.

10. Introduzca el host del hub de Intelligent Advisor. No incluya el prefijo https://. Por ejemplo: myhub.example.com.

11. Defina el valor ID de cliente y Secreto de cliente en el identificador y secreto de cliente de API que haya anotado anteriormente.

12. Haga clic en Crear.

13. Haga clic en Verificar configuración para asegurarse de que se puede realizar una conexión mediante la configuración introducida.

A medida que crea aptitudes que utilizan el servicio, la página de servicio de Intelligent Advisor mostrará los nombres de las aptitudes y los despliegues de hub que utilizan las aptitudes. Puede abrir el comprobador de aptitudes para cualquiera de estas aptitudes directamente en la página del servicio. También puede crear aptitudes directamente desde esta página. Consulte Creación y prueba de aptitudes desde la página de servicio de Intelligent Advisor.

Para obtener más información sobre los clientes de API, consulte la sección sobre activación de un proyecto y actualización de los detalles de cliente del API en la biblioteca de documentación del Intelligent Advisor.

La página de servicio de Intelligent Advisor muestra todas las aptitudes que utilizan los despliegues de chat activos del hub y puede ejecutar el comprobador de aptitudes para cualquiera de las aptitudes mostradas. Además, desde esta página, puede crear una aptitud que acceda a un despliegue activo.

Para probar una aptitud de la lista, haga clic en el icono Probar esta aptitud que aparece junto al nombre de la aptitud. Cuando se abra el probador de conversaciones, inicie la conversación. Con las aptitudes habituales, puede simplemente escribir hi y pulsar Intro para empezar. Sin embargo, a veces la habilidad está buscando frases específicas. En ese caso, si introduce una frase que no entiende, debe darle instrucciones sobre qué escribir.

Para crear una aptitud desde la página de servicio de Intelligent Advisor, seleccione un servicio para usuarios anónimos y, a continuación, haga clic en + Nueva aptitud. (Las aptitudes no pueden acceder a despliegues activados para usuarios de portal o usuarios de agente). Proporcione un nombre mostrado para la aptitud, seleccione un despliegue en la lista desplegable y haga clic en Crear. La nueva aptitud aparece en la lista de aptitudes que utilizan el servicio.

Para ver una lista de los despliegues del hub a los que puede acceder desde las aptitudes, vaya a Servicios adicionales, haga clic en Intelligent Advisor, seleccione el servicio del hub y haga clic en Despliegues.

Si un despliegue está activado por web, verá el icono Iniciar entrevista web junto a su nombre. Puede hacer clic en el icono para ejecutar la entrevista en un nuevo separador del explorador.

Para acceder al despliegue en el hub, haga clic en Gestionar despliegue .

Descripción de la ilustración ia-deployments.png

Si el cliente de API del servicio no tiene administrador de hub o mánager seleccionados, la página no puede mostrar los despliegues y recibirá una notificación de que no tiene permiso para realizar la operación. Consulte Adición de un servicio de Intelligent Advisor.

Aunque no es un requisito imprescindible, puede aumentar drásticamente la eficacia de las entrevistas de Oracle Intelligent Advisor basadas en chat mediante el uso de técnicas conversacionales.

La mayoría de las entrevistas están optimizadas para formularios en páginas web, donde las etiquetas de pantalla, las etiquetas de sección y los tipos de componentes, como las listas desplegables y las casillas de control, proporcionan indicaciones visuales sobre el contexto de la pregunta y las opciones que puede realizar. Debido a que las conversaciones de aptitudes son diferentes de las interfaces web tradicionales, es posible que no pueda simplemente utilizar la entrevista basada en formulario para una conversación. Para ilustrar el punto, haga que una persona se una a usted y se siente cara a cara, con una persona actuando como el bot y la otra actuando como el entrevistado. Lee tu entrevista basada en formularios en voz alta (leer cada etiqueta y petición de datos) y pregúntate si esta es una conversación que crees que tus clientes querrían tener con un bot.

En lugar de reutilizar una entrevista diseñada específicamente para una página web, plantéese diseñar una variación que tenga un formato más conversacional. Como querrá utilizar el mismo modelo de política como una única fuente de datos, utilice la función Inclusiones de Oracle Intelligent Advisor para crear entrevistas adicionales para ese modelo de política. Consulte Inclusiones en la documentación de Intelligent Advisor. También puede plantearse transferir datos iniciales a la entrevista para indicar que la entrevista se está realizando en una aptitud y que la entrevista se está ocultando o mostrando los artefactos según corresponda, de forma similar a los pasos descritos en Personalización de entrevistas multicanal para diferentes tipos de usuario en la documentación de Intelligent Advisor, excepto en que utilizará su propio atributo. Consulte Transferencia de valores de atributo y parámetros de conexión.

A continuación, se muestra un ejemplo. La siguiente entrevista presenta un juego de conmutadores de imagen. En una página web, el usuario puede hacer clic en las imágenes que se aplican.

Cuando se realiza en una aptitud, la entrevista presenta cada una de las imágenes y pregunta al usuario si hay una señal. El usuario debe responder de forma afirmativa o negativa a cada señal, como se muestra en este ejemplo.

Debido a que las reglas para esta entrevista solo se preocupan de si hay alguna señal presente, la entrevista se puede optimizar para una aptitud visualizando una sola imagen con todas las señales y haciendo solo una pregunta: "¿Hay alguna señal presente?" Las reglas simplemente se tienen que modificar para agregar una condición para there is any sign present, como se muestra aquí.

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

Tenga en cuenta también que el texto de entrada no es aplicable al comportamiento de la conversación de aptitud y, por lo tanto, se debe modificar u ocultar.

Antes de acceder a una entrevista anónima desde una aptitud, solicite a un administrador de Digital Assistant que agregue un servicio de Intelligent Advisor a la instancia y solicite a un gestor de hub que despliegue la entrevista en el hub de Intelligent Advisor y que la active para el servicio de chat. Una vez finalizadas esas tareas, puede acceder a la entrevista desde la aptitud agregando el componente de Intelligent Advisor al flujo de diálogo.

Consejo:

Puede crear rápidamente la aptitud desde la página de servicio de Intelligent Advisor. Haga clic en para abrir el menú lateral, haga clic en Configuración, haga clic en Servicios adicionales, haga clic en el separador Intelligent Advisor y, a continuación, haga clic en + Nueva aptitud. Asigne a la aptitud un nombre mostrado y seleccione el despliegue en la lista desplegable.

Los siguientes pasos le guiarán por el uso del componente en una aptitud creada para el modo de diálogo Visual.

1. En la aptitud, haga clic en Entidades para ver la página Entidades y, a continuación, seleccione la entidad FECHA.

2. Cambie Considerar configuración regional de usuario final a Activado y seleccione Más cercano en la lista desplegable Resolver fecha como.

   La entrevista utiliza esta configuración para determinar el formato de fecha de entrada y para interpretar fechas ambiguas como se describe en Reglas de resolución de ambigüedad para coincidencias de fecha y hora y Resolución de fecha basada en configuración regional.

3. Verifique que la opción Considerar configuración regional de usuario final esté activada para las entidades CURRENCY y NUMBER.

4. Haga clic en Flujos y, a continuación, seleccione el flujo en el que desea insertar el componente de Intelligent Advisor.

5. Pase el mouse sobre la línea que conecta los dos componentes donde desea insertar el nuevo componente y haga clic en
   
   
   
   .
6. En el campo Buscar del cuadro de diálogo Agregar estado, escriba intell y, a continuación, seleccione el componente Intelligent Advisor que se muestra.
7. Rellene los campos Nombre y Descripción y haga clic en Insertar.

8. En el inspector de propiedades del componente recién agregado, defina la propiedad Nombre de servicio de Intelligent Advisor del componente en el nombre del servicio agregado a la página Configuración > Servicios adicionales > Intelligent Advisor.

9. Defina Nombre de proyecto de despliegue en el nombre de la entrevista anónima desplegada en el hub de Intelligent Advisor.

   Consejo:

   Si no está seguro de la ortografía exacta del nombre, vaya a Servicios adicionales, haga clic en Intelligent Advisor, seleccione el servicio del hub y haga clic en Despliegues para ver una lista de los nombres de despliegue.

10. Si desea que el componente oculte los títulos de la pantalla, defina Ocultar todos los títulos de la pantalla en true. Por defecto, la entrevista muestra títulos de pantalla.

11. Por defecto, la entrevista no muestra la explicación. Puede definir la propiedad Mostrar explicación en always para mostrar la explicación cada vez, o en ask si desea que el usuario elija si desea ver la explicación.

12. Si la aptitud ya ha obtenido valores para cualquiera de los atributos de la entrevista, puede utilizar la propiedad Definir datos iniciales para transferir los valores. De lo contrario, elimine la propiedad.

    Consulte Transferencia de valores de atributo y parámetros de conexión para aprender a utilizar los datos iniciales y cómo utilizar los datos en una entrevista.

13. Por defecto, la aptitud muestra el marcado HTML y CSS de la entrevista. Si la entrevista contiene marcado HTML y CSS que hacen que la conversación contenga líneas en blanco innecesarias, plantele definir Eliminar etiquetas HTML de salida en true.

14. Si la entrevista espera una determinada moneda, defina Moneda esperada de la entrevista en el código ISO-4217 para la moneda esperada. Cuando se especifica un código, el usuario sólo puede introducir valores de moneda en los formatos permitidos para esa moneda.

15. Agregue un estado para manejar el error que se devuelve si hay un problema con la integración de Intelligent Advisor.
    • En el insector de propiedades, seleccione el separador Transiciones.
    • Cree una nueva Acción y asígnele el nombre error.
    • En el campo Transición a, seleccione Agregar estado.
    • Seleccione la plantilla Enviar mensaje o una de las plantillas de Mensajería de usuario, rellene un Nombre y una Descripción y, a continuación, haga clic en Insertar.

      Se debe insertar un nuevo componente en el diagrama de flujo con una transición de error que lo conecte al componente de Intelligent Advisor

    • Seleccione el componente recién insertado e inserte e introduzca el texto que desea que vean los usuarios en caso de error, p. ej.

      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 las cadenas que utiliza el componente para etiquetas y mensajes estándar. Consulte Entradas de grupos de recursos para Intelligent Advisor.

17. Si los canales de solo texto pueden acceder a la aptitud, asegúrese de que el valor de configuración Activar numeración automática en acciones de devolución en flujos de tareas de la aptitud esté definido en true o en una expresión que se resuelva en true para canales de solo texto, como la siguiente expresión:

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

    Esto permite al usuario simplemente seleccionar una opción escribiendo un número en lugar del texto completo de la opción.

    Para acceder a este valor, seleccione
    
    en la navegación izquierda de la aptitud y seleccione el separador Configuración.

18. (Opcional) Haga clic en Vista previa y pruebe la entrevista para todos los canales que podrán acceder a la aptitud.

Para obtener detalles sobre cada una de las propiedades de los componentes, consulte Propiedades de Intelligent Advisor.

Para obtener detalles sobre cada una de las propiedades de la versión YAML del componente y un ejemplo simple de su uso, consulte System.IntelligentAdvisor.

Si la aptitud ya ha obtenido valores para los atributos de una entrevista, puede utilizar la propiedad Definir datos iniciales en el componente Intelligent Advisor para transferir los valores a la entrevista. Si la entrevista necesita parámetros para los conectores de servicio web, puede utilizar la propiedad Parámetros de conexión para transferir los valores.

Utilice la propiedad Valor inicial de datos para definir pares clave-valor para transferir valores para cualquier atributo de entrevista que tenga activada la opción Valor inicial de parámetro de URL. Puede encontrar esta opción en el cuadro de diálogo Editar atributo de Oracle Policy Modeling.

La entrevista utiliza los valores Definir datos iniciales para definir los valores por defecto, que se muestran como valores sugeridos.

Si desea que la entrevista omita la pantalla o el paso si se proporcionan datos iniciales para ella, siga estos pasos en Policy Modeling:

1. Agregue una regla para determinar si se han proporcionado los datos iniciales:

   • Para un atributo booleano, utilice esta regla:

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

   • Para un atributo no booleano, utilice esta regla:

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

2. En el separador Entrevista, seleccione la pantalla, haga clic en Mostrar pantalla si y seleccione la regla en la lista desplegable Mostrar si.

   
   
   Descripción de la ilustración ia-show-screen-if.png
   

   Si tiene más de una pregunta en la pantalla y desea ocultar solo la pregunta, en lugar de utilizar el botón Mostrar pantalla si, seleccione la pregunta, haga clic en Obligatorio y seleccione la regla en la lista desplegable Mostrar si.

Para obtener más información sobre los datos iniciales y cómo utilizarlos en una entrevista, consulte estos artículos en la documentación de Intelligent Advisor:

Si la entrevista utiliza un conector de servicio web que contiene asignaciones de datos a datos de aplicación, utilice la propiedad Parámetros de conexión para definir pares clave-valor para transferir datos al conector.

Para obtener más información sobre los parámetros, consulte Integración de datos en la documentación de Intelligent Advisor.

Si necesita acceder a los valores de atributos con nombre definidos durante la entrevista, puede utilizar la propiedad Variable para resultados de entrevista para transferir el nombre de una variable de lista. Los valores de atributo con nombre se almacenarán en esa variable como una matriz de pares clave/valor.

Si el usuario sale de la entrevista antes de la finalización, no se creará la variable con el nombre Variable para resultados de entrevista.