Prerrequisitos
  • Licencia de Genesys Cloud CX 1, Genesys Cloud CX 2 o Genesys Cloud CX 3.
  • Una suscripción válida a Genesys Dialog Engine Bot Flow. Para obtener más información, póngase en contacto con Genesys Cloud Sales.
  • Si tiene una cuenta Nuance Mix, las credenciales Nuance OAuth Client ID y Client secret. Para obtener más información, consulte la documentación de Nuance Mix.
  • Si no tiene una cuenta Nuance Mix, complete uno de los siguientes pasos:
    • Según la región de Nuance que prefiera, vaya a la página de inicio de Nuance Mix correspondiente para crear una cuenta gratuita con fines de prueba. Para obtener más información sobre las regiones disponibles, consulte Geographies en la documentación de Nuance Mix. Es importante tener en cuenta que la cuenta gratuita tiene limitaciones y no puede utilizarse para tráfico de producción.
    • Póngase en contacto directamente con su representante de Nuance para realizar su pedido de servicio y crear su cuenta de producción.

Puede crear un bot Architect e incorporar gramáticas ASR de terceros para su uso con flujos de chat o mensajes entrantes. Cree el bot dentro del flujo o créelo por separado y luego llámelo desde el flujo. 

Nota: Para obtener más información sobre la cobertura de idiomas, consulte la documentación de Nuance Recognizer o comuníquese directamente con los representantes de Nuance.

Paso 1: Añada y active la integración de su motor ASR de terceros

Añada la integración de su motor ASR de terceros. El ejemplo de este artículo utiliza la integración de Nuance Recognizer as a Service.

  1. Hacer clic Administración.
  2. Debajo Integraciones, haga clic en Integraciones.
  3. Hacer clic Integraciones.
  4. En el cuadro Buscar , escriba Nuance Recognizer as a Service. Aparece la tarjeta de Nuance Recognizer as a Service.
  5. Hacer clic Instalar en pc.

Para configurar la integración de Nuance Recognizer as a Service para un grupo de idiomas de Nuance, realice los siguientes pasos:

  1. Abra la integración de Nuance Recognizer as a Service:
    • Si no ha instalado previamente la integración en su organización de Genesys Cloud, instálela ahora
    • Si ha instalado la integración, abra el menú Genesys Cloud Admin y en Integrations, haga clic en Integrations. A continuación, busque y abra la integración de Nuance Recognizer as a Service.
  2. En la página de integración de Nuance Recognizer as a Service, haga clic en la pestaña Configuration.
  3. En Propiedades, localice la sección URL del punto final del reconocedor.
  4. En el campo Value, introduzca el punto final regional para el grupo de idiomas de Nuance que admite su bot:
    • Por ejemplo, si desea usar Nuance Recognizer as a Service para en-US, ja-JP y zh-CN, use nr-apac4.api.nuance.com.
    • Si tu bot sólo admite un idioma, utiliza el URI de un grupo de idiomas que incluya el idioma y esté más cerca de la ubicación de tu organización. Por ejemplo, si tu bot admite fr-FR por defecto y tu organización existe en Suiza, utiliza nr-wu2.api.nuance.eu. Para obtener más información, consulte Grupos de idiomas por región en la documentación de Nuance Recognizer.
  5. Haga clic en el Cartas credenciales pestaña.Genesys Cloud enumera las credenciales para todas las URL de punto final de autorización que puede utilizar para autenticarse en los puntos finales asociados con los distintos grupos de idiomas de Nuance. Configure las credenciales sólo para el punto final del reconocedor predeterminado .
    Nota: Para determinar qué credenciales configurar para un grupo de idiomas específico, verifique a qué región de Nuance pertenece el grupo de idiomas según su URL de punto final correspondiente. Para obtener más información, consulte Geographies en la documentación de Nuance Mix.
    Haga clic en la imagen para ampliarla.Ejemplo de credenciales
  6. Haga clic en Configurar para las Credenciales de Nuance Recognizer para la URL predeterminada del punto final del Reconocedor. Se abre el cuadro de diálogo Configurar credenciales.
  7. Copie el valor "client_id" de su configuración OAuth en el campo Nuance Client ID. Utilice su ID de cliente AU, EU o US dependiendo de si su bot utiliza idiomas de la región Nuance AU, EU o US.
    Nota: Por ejemplo, si el URI del punto final regional que especificó en el paso 4 termina en nuance.eu, utilice el ID de cliente de sus credenciales mix.nuance.eu. Si el URI termina en nuance.com, utilice el ID de cliente de sus credenciales mix.nuance.com.
    Haga clic en la imagen para ampliarla.ID de cliente de Nuance Mix
  8. Copie el valor "client_secret" de su configuración de OAuth en el campo Nuance Client Secret . Utilice su secreto de cliente AU, EU o US dependiendo de si su bot utiliza idiomas de la región Nuance AU, EU o US.
    1. Copie el "private_key_id" del archivo JSON en el campo Nuance Private Key ID.
    2. Copie el valor "private_key" del archivo JSON en el campo Nuance Private Key.
  9. Hacer clic OK.
  10. Hacer clic Ahorrar.
  11. Para activar el estado de Nuance Recognizer como Servicio, en la columna Estado haga clic en Inactivo. Se abre el cuadro de diálogo Cambiar estado.
  12. Hacer clic . El estado de integración de Nuance Recognizer as a Service cambia a Active.
  1. Abra la integración de Nuance Recognizer as a Service:
    • Si no ha instalado previamente la integración en su organización de Genesys Cloud, instálela ahora
    • Si ha instalado la integración, abra el menú Genesys Cloud Admin y en Integrations, haga clic en Integrations. A continuación, busque y abra la integración de Nuance Recognizer as a Service.
  2. En la página de integración de Nuance Recognizer as a Service, haga clic en la pestaña Configuration.
  3. En Propiedades, localice la sección URL del punto final del reconocedor.
  4. En el campo Valor, introduzca un punto final regional basado en los siguientes criterios:
    • Si un grupo de idiomas incluye todos los idiomas que admite tu bot, utiliza su URI correspondiente. Por ejemplo, si desea usar Nuance Recognizer as a Service para en-US, ja-JP y zh-CN, use nr-apac4.api.nuance.com. Si tu bot sólo admite un idioma, utiliza el URI de un grupo de idiomas que incluya el idioma y esté más cerca de la ubicación de tu organización. Por ejemplo, si tu bot admite fr-FR por defecto y tu organización tiene su sede en Suiza, utiliza nr-wu2.api.nuance.eu. Para obtener más información, consulte Grupos de idiomas por región en la documentación de Nuance Recognizer.
    • Si los idiomas que admite su bot y para los que desea usar Nuance Recognizer como servicio pertenecen a varios grupos de idiomas, use un URI de un grupo de idiomas que incluya un idioma que su bot admita de manera predeterminada. Especifique los URI de los demás grupos de idiomas en la pestaña Advanced. Para obtener más información, consulte Grupos de idiomas por región en la documentación de Nuance Recognizer. 
  5. Haga clic en el Avanzado pestaña.
  6. Para configurar asignaciones para los idiomas que Nuance no sirve a través del punto final predeterminado que especificó previamente en la sección URL de punto final del reconocedor, siga estos pasos:
    Notas:
    • Excepto para los idiomas que cubre el punto final regional predeterminado, asegúrese de asignar todos los idiomas a un punto final Nuance apropiado.
    • Si asigna un idioma a un punto final regional de Nuance, debe configurar las credenciales para esa región de idioma en Credenciales, incluso si el punto final regional predeterminado y sus credenciales correspondientes cubrirían ese idioma.
    • Si un idioma no tiene un valor asignado en la sección Configuración avanzada, Genesys Cloud intentará utilizar el punto final regional predeterminado con las credenciales predeterminadas.
    1. (Opcional) Para descargar e inspeccionar el esquema JSON con el que Genesys Cloud valida su configuración avanzada, haga clic en Descargar esquema.
    2. Añade una propiedad llamada "endpointMappings" como objeto.
    3. Añada las etiquetas de idioma de los idiomas admitidos y los correspondientes puntos finales de Nuance como pares clave-valor al objeto:Ejemplo de configuración avanzada
      Nota: La interfaz de usuario valida el objeto con respecto al esquema JSON esperado y le informa si el objeto no es conforme.
  7. Haga clic en el Cartas credenciales pestaña.Genesys Cloud enumera las credenciales para todas las URL de punto final de autorización que puede utilizar para autenticarse en los puntos finales asociados con los distintos grupos de idiomas de Nuance.
    Nota: Para determinar qué credenciales configurar para un grupo de idiomas específico, verifique a qué región de Nuance pertenece el grupo de idiomas según su URL de punto final correspondiente. Para obtener más información, consulte Geographies en la documentación de Nuance Mix.
    Haga clic en la imagen para ampliarla.
    Ejemplo de credenciales
  8. Hacer clic Configurar. Se abre el cuadro de diálogo Configurar credenciales.
  9. Copie el valor "client_id" de su configuración OAuth en el campo Nuance Client ID. Utilice su ID de cliente AU, EU o US dependiendo de si su bot utiliza idiomas de la región Nuance AU, EU o US.
    Nota: Por ejemplo, si el URI del punto final regional para el que desea configurar las credenciales termina en nuance.eu, utilice el ID de cliente de sus credenciales mix.nuance.eu. Si el URI termina en nuance.com, utilice el ID de cliente de sus credenciales mix.nuance.com.
    Haga clic en la imagen para ampliarla.ID de cliente de Nuance Mix
  10. Copie el valor "client_secret" de su configuración de OAuth en el campo Nuance Client Secret . Utilice su secreto de cliente AU, EU o US dependiendo de si su bot utiliza idiomas de la región Nuance AU, EU o US.
    1. Copie el "private_key_id" del archivo JSON en el campo Nuance Private Key ID.
    2. Copie el valor "private_key" del archivo JSON en el campo Nuance Private Key.
  11. Hacer clic OK.
  12. Repita el paso 8 para todas las demás credenciales que deba configurar.
    Notas:
    • Si configuró una asignación de punto final para un idioma en la pestaña Advanced, debe configurar las credenciales para la URL del punto final de autorización de Nuance específico con el que está asociado el grupo del idioma.
    • Si no ha configurado ninguna asignación de punto final para el idioma en la pestaña Avanzado, deberá configurar las credenciales para el punto final regional predeterminado que especificó previamente en la pestaña Propiedades.
  13. Hacer clic Ahorrar.
  14. Para activar el estado de Nuance Recognizer como Servicio, en la columna Estado haga clic en Inactivo. Se abre el cuadro de diálogo Cambiar estado.
  15. Hacer clic . El estado de integración de Nuance Recognizer as a Service cambia a Active.

Instalar Nuance Recognizer como servicio

Haga clic en la imagen para ampliarla.

Instalar Nuance Recognizer

Configurar Nuance Recognizer como servicio

Haga clic en la imagen para ampliarla.

Configurar Nuance Recognizer 

Paso 2: Añada la gramática de su motor ASR de terceros a la página de gramática de Architect

Añade la gramática de tu motor de terceros a Architect.

<?xml version="1.0"?>
<grammar xmlns="http://www.w3.org/2001/06/grammar" xml:lang="en-US" version="1.0" root="fruits"> 
     <rule id="fruits" scope="public">
          <one-of>
               <item>apple</item>
               <item>banana</item>
               <item>blueberry</item>
               <item>cherry</item>
               <item>grape</item>
               <item>peach</item>
               <item>pear</item>
               <item>pineapple</item>
               <item>strawberry</item>
               <item>watermelon</item>
          </one-of>
     </rule>
</grammar>

  1. Hacer clic Administración.
  2. Debajo Arquitecto, haga clic en Arquitecto.Architect se abre en una nueva pestaña.
  3. Haga clic en Gramáticas.
  4. Hacer clic Agregar. Se abre el cuadro de diálogo Crear nueva gramática.
  5. Nombra la gramática Fruta.
  6. En Descripción de la gramática, añada detalles descriptivos sobre la gramática. Por ejemplo, "lista de fruta en venta".
  7. Haga clic en Starting Language y seleccione el idioma inicial que desea que utilice la gramática.
  8. Hacer clic Crear. Se abre el Editor gramatical.
  9. Dependiendo del tipo de gramática que desee añadir, haga clic en una de las siguientes pestañas:
    • Voz
    • DTMF
  10. Para agregar manualmente contenido GRXML desde la gramática ASR de Nuance Recognizer, ingrese la sintaxis en el editor.
    Nota: Si la gramática supera la validación XML, aparecerá un mensaje verde que le informará de que la gramática no contiene errores. Si aparece un mensaje en rojo, Architect le indica la ubicación en el GRXML en la que existe el error o los errores.
  11. Nota:
    1. Click .grxml and select .gram.
    2. Click Select File. The Add A Grammar File dialog box opens.
    3. Click Select .gram file and upload the appropriate file.
    4. Click Add File. Architect uploads the file but does not check for errors.
  12. Hacer clic Ahorrar.

Editor gramatical para DTMF

El ejemplo de este artículo utiliza la gramática DTMF. Para obtener más información y un ejemplo de gramática de voz, consulte Añadir una gramática para un flujo de bot en Architect.

Haga clic en la imagen para ampliarla.

DTMF Grammar Editor example fruit

Paso 3: Crear un bot para un flujo de entrada y añadir intentos, ranuras y tipos de ranura.

Este procedimiento describe cómo crear un bot para un flujo de mensajes de entrada. En este ejemplo, construye el flujo del bot para preguntar a los usuarios qué quieren hacer. Pueden pagar su factura o pedir fruta.

  1. Crear un nuevo flujo bot entrante:
    1. Desde la página de inicio de Architect, haga clic o coloque el cursor sobre el Flujos menú y seleccione Bot Flow.
    2. Hacer clic Agregar. Se abre el cuadro de diálogo Crear flujo.
    3. En el Nombre campo, ingrese un nombre único para el flujo.
    4. (Opcional) En el Descripción campo, agregue una oración o frase corta para describir este flujo.
    5. Haga clic en el Idioma predeterminado lista y seleccione el idioma admitido predeterminado del flujo.
    6. Haga clic en el Divisiones lista y seleccione la división en la que colocar el flujo.
    7. Hacer clic Crear flujo. Se abre la página de configuración del flujo.
  2. En Comprensión del lenguaje natural, haga clic en Intenciones.
  3. Añade la primera intención:
    1. Haga clic en Add Intent.
    2. Nombre la intención Pagar mi factura.
    3. Hacer clic Agregar instancia.
    4. En la página de expresiones, añada una expresión. Por ejemplo, "pago". 
    5. Hacer clic Agregar.
    6. Repita los pasos a-e para añadir otro enunciado. Las buenas prácticas recomiendan añadir cinco o más enunciados. 
  4. Añade la segunda intención:
    1. Haga clic en Add Intent.
    2. Nombre de la intención Orden de fruta.
    3. Hacer clic Agregar instancia.
    4. En la página de expresiones, añada una expresión. Por ejemplo, "hacer un pedido". 
    5. Hacer clic Agregar.
    6. Repita los pasos a-e para añadir más enunciados. Las buenas prácticas recomiendan añadir cinco o más enunciados. 
  5. Añade ranuras:
    1. En el menú Comprensión del Lenguaje Natural, haga clic en Slots.
    2. Haga clic en Añadir ranura. se abre el cuadro de diálogo Añadir ranura.
    3. Nombre de la ranura PickFruit.
    4. En Tipo de ranura asociada, seleccione Nueva lista.
    5. Haga clic en Engine y seleccione el motor ASR de terceros. En este ejemplo, seleccione Nuance Recognizer como servicio.
    6. Haga clic en Gramática y seleccione la gramática que añadió en la sección Paso 2 anterior, Fruta.
    7. Hacer clic Ahorrar.
    8. Repita los pasos a-g para añadir una ranura para Pago y asóciela con el tipo de ranura existente builtin:amountOfMoney
  6. Añade un tipo de ranura para el ejemplo de la fruta:
    1. En el menú Comprensión del lenguaje natural, haga clic en Tipos de ranura.
    2. Haga clic en Añadir tipo de ranura. Se abre el cuadro de diálogo Añadir tipo de ranura.
    3. Nombre la ranura Elija el tipo de fruta y, a continuación, haga clic en Guardar.
    4. Add various slot type values, such as strawberry, pineapple, pear, peach, grape, cherry, blueberry, banana, apple, and watermelon.
      Nota: La ranura de pago ya está relacionada con un tipo de ranura incorporada.
  7. Guarde su flujo bot y continúe con el Paso 4.

Intenciones

Haga clic en la imagen para ampliarla.

Intents bot flow example

Añadir una ranura

Haga clic en la imagen para ampliarla.

Ranura con gramática

Lista de ranuras

Haga clic en la imagen para ampliarla.

Slots bot flow example

Tipos de tragamonedas:

Haga clic en la imagen para ampliarla.

Slot types bot flow examples

Paso 4: Configurar la tarea de inicio del flujo de bots

Completa la configuración del bot, guárdala y publícala.

  1. En Starting Bot, haz clic en Default Bot.
  2. En Toolbox, despliegue el menú Ask y añada una acción Ask for Intent debajo de start en el editor de tareas.
  3. Desde el menú Ask añada una acción Ask for Slot debajo de la ruta del pedido de fruta y configure la acción:
    1. Haga clic en la lista Slot y seleccione PickFruit.
    2. Haga clic en Pregunta, cambie el texto para que pregunte "¿Cuál es el tipo de fruta que desea comprar?", y haga clic en Guardar. Observe que la gramática de esta acción utiliza la gramática de la ranura.
  4. En Caja de herramientas, amplíe el menú Transferencia y añada una acción Transferir a ACD debajo de la ruta Pagar mi factura. 
  5. Añada su acción preferida debajo de la ruta de fallo de Pagar mi factura. Por ejemplo, una acción de Comunicar.
  6. Guarde y publique su flujo.

Haga clic en la imagen para ampliarla.

Use a grammar in a bot flow example

Paso 5: Crear un flujo de mensajes entrantes

Crea un flujo de mensajes entrantes que llame a tu nuevo flujo de bots.

  1. En la página de inicio de Architect, haga clic o pase el ratón por encima del menú Flujos y seleccione Mensaje entrante.
  2. Haga clic en Añadir. Se abre el cuadro de diálogo Crear flujo.
  3. En el campo Nombre , escriba un nombre único para el flujo de mensajes entrantes. 
  4. (Opcional) En el Descripción campo, agregue una oración o frase corta para describir este flujo.
  5. Haga clic en el Divisiones lista y seleccione la división en la que colocar el flujo.
  6. (Opcional) Haga clic en el Cola de transferencia de eventos de error lista y seleccione la cola en la que transferir el flujo si Architect detecta un error.
  7. Hacer clic Crear flujo. Se abre la página de configuración del flujo.
  8. En Estado inicial, haga clic en Estado inicial.
  9. En la caja de herramientas, despliegue el menú Bot y añada una acción Call Bot Flow debajo de Start en el editor de tareas.
  10. En Flujo de bots, busque y seleccione el bot que creó en la sección 3.
  11. Guarde y publique su flujo.

Ahora puede probar e implementar un flujo de bots que utilice su gramática ASR de terceros en un flujo de mensajes entrantes de Architect.

Haga clic en la imagen para ampliarla.

Inbound message flow example