Cree un flujo de bots y utilice la guía rápida de gramática ASR de terceros

Prerrequisitos
  • Genesys Cloud CX 1, Genesys Cloud CX 2, Genesys Cloud CX 3, or Genesys Cloud CX 4 license.
  • 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 utilizarlas con flujos de llamadas. Cree el bot desde dentro del flujo de llamadas, o créelo por separado y luego llámelo desde el flujo de llamadas. 

Idioma Región Idioma etiqueta
Vasco Unión Europea eu-ES
catalán España ca-ES
holandés Países Bajos nl-NL
chino Simplificado: República Popular de China  zh-CN
Tradicional - RAE de Hong Kong cn-HK
inglés Australia  en-AU
Gran Bretaña  en-GB
India en-IN
Estados Unidos en-US
francés Bélgica fr-BE
Canadá  fr-CA
Francia fr-FR
alemán Alemania  de-DE
Suiza de-CH
Galician España gl-ES
italiano Italia eso eso
japonés Japón ja-JP
coreano Corea ko-KR
portugués Brasil  pt-BR
Portugal pt-PT
ruso Rusia ru-RU
Español España es-ES
Estados Unidos y América Latina es-US
Valencian España va-ES

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:
    • For example, if you want to use Nuance Recognizer as a Service for en-US, ja-JP, and zh-CN, use nr-apac4.api.nuance.com.
    • If your bot only supports one language, use the URI of a language group that includes the language and is closest to your organization's location. For example, if your bot supports fr-FR by default and your organization exists in Switzerland, use nr-wu2.api.nuance.eu. For more information, see Language groups by region in the Nuance Recognizer documentation.
  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.
    Note: For example, if the regional endpoint URI you specified in step 4 ends in nuance.eu, use the client ID of your mix.nuance.eu credentials. If the URI ends in nuance.com, use the client ID of your mix.nuance.com credentials.
    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:
    • If a language group includes all the languages that your bot supports, use its corresponding URI. For example, if you want to use Nuance Recognizer as a Service for en-US, ja-JP, and zh-CN, use nr-apac4.api.nuance.com. If your bot only supports one language, use the URI of a language group that includes the language and is closest to your organization's location. For example, if your bot supports fr-FR by default and your organization is based in Switzerland, use nr-wu2.api.nuance.eu. For more information, see Language groups by region in the Nuance Recognizer documentation.
    • 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 puntos finales Nuance correspondientes como pares clave-valor al objeto:Ejemplo de configuración avanzada Puede copiar y pegar el siguiente ejemplo en el editor de Configuración Avanzada y modificarlo según sus necesidades:
      {
      "endpointMappings": {
      "ca-ES": "nr-wu1.api.nuance.eu",
      "es-ES": "nr-wu1.api.nuance.eu",
      "es-US": "nr-na1.api.nuance.com",
      "gl-ES": "nr-wu1.api.nuance.eu",
      "va-ES": "nr-wu1.api.nuance.eu",
      "fr-FR": "nr-wu5.api.nuance.eu",
      "en-GB": "nr-wu1.api.nuance.eu",
      "eu-ES": "nr-wu1.api.nuance.eu"
      }
      }
      
      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.
    Note: For example, if the URI of the regional endpoint you want to configure credentials for ends in nuance.eu, use the client ID of your mix.nuance.eu credentials. If the URI ends in nuance.com, use the client ID of your mix.nuance.com credentials.
    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:
    • If you configured an endpoint mapping for a language in the Advanced tab, then you must configure the credentials for the specific Nuance authorization endpoint URL that the language's group is associated with.
    • 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 

Step 2: Add grammar from your third-party ASR engine to Architect's grammar page

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. Haga clic en .grxml y seleccione.gram.
    2. Haga clic en Seleccionar archivo. Se abre el cuadro de diálogo Añadir un archivo de gramática.
    3. Haga clic en Seleccione el archivo .gram y cargue el archivo correspondiente.
    4. Haga clic en Añadir archivo. Architect carga el archivo pero no comprueba si hay errores.
  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.

Ejemplo de fruta DTMF Grammar Editor

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 llamadas entrantes. En este ejemplo, construye el flujo del bot para preguntar a los usuarios qué quieren hacer. Pueden pagar su factura pendiente o pedir fruta.

  1. Crear un nuevo flujo de bots:
    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. Click the Default Language list and select the flow's default supported language.
    6. Haga clic en el Divisiones lista y seleccione la división en la que colocar el flujo.
    7. Haga clic en 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 pendiente.
    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.
    9. Repita los pasos a-c para añadir una ranura para CustomerAccountNumber y asóciela con un tipo de ranura New RegEx.
  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. Añada varios valores de tipo de ranura, como fresa, piña, pera, melocotón, uva, cereza, arándano, plátano, manzana y sandía.
      Nota: La ranura de pago ya está relacionada con un tipo de ranura incorporada.
  7. Configure el tipo de ranura RegEx que creó para la ranura CustomerAccountNumber . Especifique expresiones regulares que puedan identificar un número de cuenta válido.
  8. Guarde su flujo bot y continúe con el Paso 4.

Intenciones

Haga clic en la imagen para ampliarla.

Ejemplo de flujo de bots Intents

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.

Ejemplo de flujo de bots de tragamonedas

Tipos de tragamonedas:

Haga clic en la imagen para ampliarla.

Tipos de ranuras Ejemplos de flujos de bots

Step 4: Configure the bot flow's starting bot task

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. Click the Question, change the text to ask “What type of fruit would you like to order?“, and click Save. Notice that the Grammar for this action uses the slot's grammar.
  4. Desde el menú Ask añada otra acción Ask for Slot debajo de la ruta Fruit order y configure la acción:
    1. Haga clic en la lista Slot y seleccione CustomerAccountNumber.
    2. Haga clic en Pregunta, cambie el texto para preguntar "¿Cuál es su número de cuenta?", y haga clic en Guardar.
  5. Para verificar si el cliente introduce un número de cuenta válido, añada una acción de decisión del menú Logical debajo de las acciones en la ruta del pedido de fruta y configure la acción utilizando una expresión personalizada basada en sus necesidades.
  6. From the Communicate menu add Communicate actions below the Decision action's Yes and No paths to inform the customer whether the account number is valid or not.
  7. 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 pendiente. 
  8. Add your preferred action below the Pay my bill's failure path. For example, a Communicate action.
  9. Guarde y publique su flujo.

Haga clic en la imagen para ampliarla.

Ejemplo de flujo de bots

Paso 5: Crea un flujo de llamadas entrantes

Cree un flujo de llamadas entrantes que llame a su nuevo flujo de bots.

The following example flow illustrates a scenario where a customer calls a fruit company and the call transfers to the bot flow that you created in Section 3. If the bot detects that the customer wants to reach an agent, the call transfers to an appropriate queue. If the bot detects that the customer intends to place an order, the call transfers the customer to a secure call flow to complete the order, and passes information to the secure call flow about the customer's fruit of choice and account number.

  1. Desde la página de inicio de Architect, haga clic o coloque el cursor sobre el Flujos menú y seleccione Llamada entrante.
  2. Haga clic en Añadir. Se abre el cuadro de diálogo Crear flujo.
  3. En el campo Name , escriba un nombre único para el flujo de llamadas 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. Click Create Flow. The flow's configuration page opens.
  7. En Tareas reutilizables, haga clic en Tareas.
  8. In the flow design area, click the task's name and type a distinctive name for the task.
  9. En la caja de herramientas, despliegue el menú Bot y añada y configure una acción Call Bot Flow debajo de Start en el editor de tareas:
    1. En Bot Flow, busque y seleccione el bot que creó en Sección 3.
    2. En Salidas, añada una variable de salida para la ranura Pickfruit que configuró en la Sección 3.
    3. En Salidas, añada otra variable de salida para la ranura CustomerAccountNumber que configuró en la Sección 3.
    4. En Resultados de la ejecución, añada variables para almacenar la Razón de salida y la Intención.
  10. En la caja de herramientas, expanda el menú Logical y añada y configure una acción Decision debajo de la acción Call Bot Flow:
    • To determine whether the invoked bot flow exited because the customer requested agent assistance, add the expression Task.ExitReason == "AgentRequestedByUser" in the Decision action's Expression field.
  11. Under the Decision action's Yes path, add and configure a Transfer to ACD action. From the Toolbox, expand the Transfer menu and drag a Transfer to ACD action into the task editor:
    • En Cola, seleccione una cola a la que transferir la interacción.
  12. Under the Decision action's No path, add and configure another Decision action to configure actions based on the intent that the bot flow returned:
    • To determine whether Architect detected the intent to place an order, add the expression Task.Intent == "Fruit order" in the Decision action's Expression field.
  13. En la sección Desde la caja de herramientas, despliegue el menú Transferir y arrastre una acción de flujo Transferir a seguro al editor de tareas:
    1. En Flujo de llamadas seguro, seleccione el flujo de llamadas seguro al que transferir la interacción.
    2. Under Invocation Data,  add the variables you configured for the Pickfruit and CustomerAccountNumber slots to pass the information these variables contain to the secure flow that you want to use for the order. You can use the Append function to append the two strings together: Append(Task.FruitToOrder, ",", Task.CustomerAccountNumber)and then in the secure call flow, you can use the following to access them separately:
      Split(Flow.InvocationData, ",")[0] -> Fruit Type 
      Split(Flow.InvocationData, ",")[1] -> Account Number
      Note: You can add and configure a Call Data Action to do a lookup in the secure call flow based on the customer's account number to determine who is doing the ordering.
  14. En el diseño de tareas reutilizables área, haga clic en y haga clic en Establecer esto como la tarea de partida. Observe que la tarea reutilizable pasa a ser la Tarea inicial y que el Saludo inicial aparece ahora en el área Tarea inicial. Además, el menú principal se mueve a la parte inferior de la página a los menús reutilizables.Como el menú no se utiliza, puede eliminarlo.
  15. 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 llamadas entrantes de Architect.

Haga clic en la imagen para ampliarla.

Flujo de llamadas de ejemplo