Guía de inicio rápido de Amazon Lex V2

Prerrequisitos

• Revisar Introducción a Amazon Lex

Para crear el bot inicial y añadir un nombre, idioma, voz e información básica, sigue estos pasos:

1. Inicie sesión en la Consola de administración de AWS y abra el Consola Amazon Lex V2.
2. Hacer clic Crear bot.
3. Debajo Método de creación, Seleccione Crear.
4. Debajo Configuración del bot, dale al bot un nombre y una descripción opcional. Por ejemplo, "BankBot".
5. En Permisos de IAM, elija una función que defina los permisos para el bot. Aquí, seleccione un rol existente.
6. Debajo Ley de protección de la privacidad infantil en línea (COPPA), elija la respuesta adecuada. En este ejemplo, seleccione No.
7. Debajo Tiempo de espera de la sesión inactiva, elija el tiempo que Amazon Lex V2 mantiene una sesión con un usuario abierto. Amazon Lex V2 mantiene las variables de sesión durante la sesión para que su bot pueda reanudar una conversación con las mismas variables. En nuestro ejemplo, deje la configuración predeterminada.
8. Deje todos los demás ajustes sin cambios.
9. Para crear el bot y continuar agregando un idioma, haga clic en próximo. Se abre la página Agregar idioma a un bot.
10. Agregue un idioma y una voz para que use el bot:
    1. Debajo Seleccione el idioma, elija el idioma apropiado para el bot. Aquí, deja el predeterminado inglés idioma. 
    2. Debajo Interacción de voz, seleccione la voz de texto a voz que utiliza su bot para interactuar con los usuarios. Aquí, seleccione Kendra.
    3. Debajo Umbral de puntuación de confianza de clasificación de intención, establezca el valor que utiliza Amazon Lex para determinar si una intención es la correcta. En nuestro ejemplo, deje el valor predeterminado de 4.0.
    4. Hacer clic Hecho. Se abre el editor de intenciones.

Este ejemplo utiliza el constructor visual de AWS. Cree dos intenciones: una intención de saldo de cuenta con un enunciado simple y una única ranura, y una ranura de cierre vacía. Luego, construye el bot. 

Para añadir intents y slots y luego construir el bot en el visual builder, sigue estos pasos:

1. En la parte inferior del editor, haga clic en Visual builder.
2. Añade una intent vacía y escribe "ClosingIntent". Esta intención no incluye la configuración y el bot la utiliza para terminar la conversación.
3. Agregue la intención del saldo de la cuenta.
   1. Haga clic en Añadir intento.
   2. Haga clic en Añadir intención vacía. 
   3. En Nombre de la intención, escriba "CurrentBalance" y haga clic en Añadir.
   4. Edite el bloque Start:
      1. Hacer clic Editar .
      2. Active la casilla Incluir respuesta inicial.
      3. En la casilla Mensaje, escriba "Gracias por llamar. Puedo ayudar con el enrutamiento de las tareas bancarias. ¿Cómo puedo ayudarle?"
      4. En la casilla Ejemplos de expresiones, escriba: "¿Cuál es el saldo de mi cuenta?"
      5. Haga clic en . Añada la expresión. 
   5. Crear y configurar una sola ranura:
      1. Desde la barra de herramientas, arrastre un bloque Get slot value al constructor visual.
      2. En el Nombre cuadro, escriba AccountNumber.
      3. Debajo Tipo de ranura, Seleccione AMAZON.number.
      4. En Slot Prompts, escriba: "Por favor, introduzca su número de cuenta".
      5. Conecte el bloque Start al bloque de ranura AccountNumber.
   6. Cree y configure dos bloques de intención:
      1. Desde la barra de herramientas, arrastre dos bloques Go to Intent al constructor visual.
      2. Haga clic en el primer bloque Go to Intent y en Intent Name, seleccione el ClosingIntent que creó en el paso 1.
      3. Haga clic en el segundo Vaya al bloque Intent y en Intent Name, seleccione FallbackIntent.
      4. Conecte la ruta del bloque de ranura Success del AccountNumber al bloque ClosingIntent.
      5. Conecte la ruta del bloque de ranura Failure al bloque FallbackIntent de AccountNumber.
4. Hacer clic Guardar intención.
5. Hacer clic Construir.
6. Crea una versión y un alias.

En este ejemplo, cree dos intents: una intención de mensaje de bienvenida y una intención de saldo de la cuenta con una expresión simple y un solo espacio. Luego, construye el bot.

Para añadir intents y slots y luego construir el bot en el editor, sigue estos pasos:

1. Agregue la intención del mensaje de bienvenida. Esta intención no tiene espacios, pero tiene un mensaje de cierre. Este mensaje es lo primero que escucha la persona que llama.
   1. Hacer clic Agregar intención y luego haga clic en Agregar intención vacía. 
   2. Debajo Nombre de la intención, escriba "Mensaje de bienvenida" y luego haga clic en Agregar.
   3. Debajo Respuestas de cierre, en el Mensaje escriba en el cuadro “Gracias por llamar. Puedo ayudar con el enrutamiento de las tareas bancarias. ¿Cómo puedo ayudarle?"
   4. Deje los ajustes restantes sin cambios.
   5. Hacer clic Guardar intención.
2. Agregue la intención del saldo de la cuenta.
   1. Hacer clic Agregar intención y luego haga clic en Agregar intención vacía. 
   2. Debajo Nombre de la intención, escriba "CurrentBalance" y haga clic en Agregar. Se abre el editor de intenciones.
   3. Debajo Expresiones de muestra, escriba "Saldo de la cuenta".
   4. En el Expresiones de muestra cuadro de texto, escriba, "¿Cuál es el saldo de mi cuenta?" y luego haga clic en Agregar expresión. 
   5. Debajo Ranuras, haga clic en Agregar espacio.
   6. En el Nombre cuadro, escriba AccountNumber.
   7. Debajo Tipo de ranura, Seleccione AMAZON.number.
   8. Debajo Indicaciones, escriba, "Ingrese su número de cuenta".
   9. Hacer clic Agregar.
   10. Hacer clic Guardar intención.
3. Hacer clic Construir.
4. Crea una versión y un alias.

Aprende más

• Cree un bot Lex V2 en AWS
• Preguntas frecuentes sobre integraciones de Amazon Lex

Documentación de Amazon Lex V2

• Agregar un idioma
• Añadiendo intenciones
• Agregar tipos de ranuras
• Probando un bot usando la consola
• Creando versiones
• Intenciones y tipos de tragamonedas incorporados
• Crear tipos de espacios personalizados
• Creando versiones
• Alias
• Uso de una función de AWS Lambda

Prerrequisitos

• Regístrese en AWS y crear un usuario administrador
• Crear un usuario de IAM

Para configurar una función de IAM:

1. Inicie sesión en AWS.
2. Navega al Servicios de AWS página y seleccione YO SOY.
3. Debajo Tablero, Seleccione Roles.
4. Sobre el Roles página, haga clic en Crear rol.
5. Seleccione Otra cuenta de AWS como el tipo de entidad de confianza.
6. En la casilla ID de cuenta, introduzca 765628985471 (regiones Core/Satellite) o 325654371633 (región FedRAMP (US-East-2)) en la casilla ID de cuenta. Este número es el ID de la cuenta de producción de Genesys Cloud.
7. Para mejorar la seguridad, Genesys recomienda que marque la Requerir identificación externa e ingrese el ID de su organización.
8. Hacer clic Próximo: Permisos.
9. A continuación, asigne políticas de permisos al rol. En el cuadro de búsqueda, escriba Lex V2. Luego seleccione el AmazonLexReadOnly y AmazonLexRunBotsOnly casillas de verificación de políticas.
10. Hacer clic Próximo: Etiquetas.
11. (Opcional) Agregue metadatos a la función adjuntando etiquetas como pares clave-valor. 
12. Hacer clic Próximo: Revisar.
13. En el Nombre de rol cuadro, escriba un nombre. Por ejemplo, DemoLexRole.
14. En el Descripción del rol cuadro, ingrese el texto descriptivo sobre el rol.
15. Verifique que el número de cuenta para Entidades confiables coincide con el ID de cuenta de producción de Genesys Cloud que ingresó en el paso 6.
16. Hacer clic Crear rol.
17. En la página de la lista, haga clic en el nombre del rol. Este enlace es el nombre que ingresó en el Nombre de rol cuadro en el paso 12. Aparecen detalles resumidos sobre el rol.
18. Nota la ARN de rol. Necesitará esta credencial más tarde. Un Nombre de recurso de Amazon (ARN) es un identificador único que identifica un recurso de forma inequívoca.
19. Haga clic en el Dupdo icono (a la derecha del ARN del rol), que copia su ARN en el portapapeles. 

Cree una política Lex V2 en formato JSON en la consola de AWS y luego asígnela a su rol de IAM. Esta política garantiza que Genesys Cloud Architect pueda interactuar con un bot de Amazon Lex V2.

1. Inicie sesión en la Consola de administración de AWS y abra el Consola de IAM.
2. En el panel de navegación del lado izquierdo, haga clic en Políticas.
3. Hacer clic Crear política.
4. Haga clic en el JSON pestaña.
5. Escriba o pegue el siguiente contenido JSON: 
   {
      "Versión": "2012-10-17",
     "Declaración": [
          {
               "Sid": "VisualEditor0",
               "Efecto": "Permitir",
               "Acción": [
                    "lex: Lista *",
                    "lex: Describe *",
                    "lex: StartConversation",
                ],
                "Recurso": "*"
          }
     ]
}
6. Resuelva las advertencias de seguridad, los errores o las advertencias generales que genera la validación de la política y luego haga clic en Política de revisión.
   Nota: Puede cambiar entre el editor visual y las pestañas JSON en cualquier momento. Sin embargo, si realiza cambios o elige Siguiente: Etiquetas en la pestaña Editor visual, IAM podría reestructurar su política para optimizarla para el editor visual.
     
7. Hacer clic Próximo: Etiquetas.
8. (Opcional) Agregue metadatos a la política adjuntando etiquetas como pares clave-valor. 
9. Sobre el Política de revisión página, escriba un Nombre y un Descripción (opcional) para la póliza. Revise el Resumen de la política para ver los permisos que otorga su política.
10. Hacer clic Crear política.
11. Después de crear una política, adjúntelo al rol de IAM que creaste arriba.

Ejemplo:

Aprende más

• Preguntas frecuentes sobre integraciones de Amazon Lex

Guía del usuario de AWS Identity and Access Management

• Roles de IAM 
  
• Etiquetado de entidades de IAM 
• Crear políticas de IAM
• Agregar y quitar permisos de identidad de IAM
• Crear roles y adjuntar políticas 

Prerrequisitos

• Comuníquese con Genesys Cloud Sales y solicite actualizar su suscripción.

Para instalar Amazon Lex V2 en su organización:

1. Inicie sesión en Genesys Cloud para la organización en la que agregará Amazon Lex V2.
2. Hacer clic Administración.
3. Debajo Integraciones, haga clic en Integraciones.
4. Hacer clic Integraciones.
5. En el Buscar caja, tipo Amazon Lex V2. Aparece la tarjeta para Amazon Lex V2.
6. Haga clic en el Amazon Lex V2 tarjeta. Aparece información sobre la aplicación.
7. Hacer clic Instalar en pc.

Amazon Lex V2 ya está disponible para configurar y activar desde Genesys Cloud Administración > Integraciones página. 

Aprende más

• ¿Qué son las aplicaciones premium?
• Acerca de las aplicaciones premium
• Acerca de la integración de Amazon Lex V2

Documentación de Amazon Lex V2

• Guía para desarrolladores de Amazon Lex V2
• Cómo funciona

Para acceder al Llamar a la acción Lex V2 Bot en Architect, primero debe agregar y configurar la integración de Amazon Lex V2 y luego otorgar permiso para acceder a los recursos de AWS en su organización. 

1. En Genesys Cloud, haga clic en Administración.
2. Debajo Integraciones, haga clic en Integraciones.
3. Hacer clic Agregar integración.
4. Busque la integración de Amazon Lex V2.
5. En el mosaico de Amazon V2 Lex, haga clic en Instalar en pc. Genesys Cloud instala la integración.
6. Hacer clic Integraciones.
7. Junto a Amazon Lex V2, haga clic en Más y seleccione Editar integración.
8. Haga clic en el Configuración pestaña y luego haga clic en el Cartas credenciales pestaña.
9. Hacer clic Configurar. 
10. En el ARN de rol caja, presione Ctrl + V para pegar el ARN que almacenó en el Portapapeles en el ARN de rol caja. Si usa una Mac, presione Comando + V pegar. 
11. Hacer clic OK y luego haga clic en Ahorrar.
12. Selecciona el Detalles pestaña.
13. Para activar la integración, haga clic en Inactivo. Aparece el cuadro de diálogo Cambiar estado y le pide que confirme que desea activar Amazon Lex.
14. Hacer clic sí. El estado cambia a Activo.

Aprende más

• Configurar y activar la integración Lex V2 en Genesys Cloud
• Preguntas frecuentes sobre integraciones de Amazon Lex
• Solucionar problemas de integraciones de Amazon Lex

Requisito previo

• Un bot de Amazon Lex V2 configurado en la consola de AWS. 

Para crear un flujo de arquitecto, siga estos pasos:

1. En Genesys Cloud, haga clic en Administración.
2. Debajo Arquitecto, haga clic en Arquitecto. Aparece la página de inicio de Architect.
3. Desde la página de inicio de Architect, haga clic o coloque el cursor sobre el Flujos menú y elegir Flujo de llamadas entrantes.
4. Hacer clic Agregar . Se abre el cuadro de diálogo Crear flujo.
5. En el Nombre campo, ingrese un nombre único para el flujo. Aquí, ingrese "BankingBot".
6. (Opcional) En el Descripción campo, incluya una oración o frase corta para describir este flujo.
7. Haga clic en el Idioma predeterminado lista y seleccione el idioma admitido predeterminado del flujo. En este ejemplo, deje el idioma inglés predeterminado.
8. Haga clic en el Divisiones lista y seleccione la división en la que colocar el flujo. En este ejemplo, use la división Casa predeterminada.
9. Hacer clic Crear flujo. Se abre la página de configuración de flujo.

Estos pasos garantizan la coherencia entre el bot y el flujo.

1. Debajo Ajustes, haga clic en Idiomas admitidos.
2. En el Idiomas admitidos panel, debajo Texto a voz, escoger Amazon Polly.
3. Debajo Voz, Seleccione Kendra.

Ejemplo:

Cree una nueva tarea y llame al bot Lex V2.

1. Debajo Tareas reutilizables, haga clic en Agregue una tarea reutilizable aquí, luego haga clic en Caja de herramientas y seleccione Tarea.
2. Encima del editor de tareas, cambie el nombre de la tarea "Autoservicio" y haga clic en Hecho.
3. Hacer clic Más y en el menú que aparece, haga clic en Establecer esto como la tarea inicial.
4. Desde la Caja de herramientas, expanda la categoría Bot y arrastre un Llamar al bot Lex V2 acción en el editor de tareas.
5. En el panel Llamar a Lex V2 Bot, configure la acción:
   1. Debajo Nombre del bot, Seleccione BankBot.
   2.  Debajo Alias de bot, Seleccione TestBotAlias.
   3. En Nombre de la intención inicial, especifique la intención del mensaje de bienvenida que creó anteriormente:
      • Si creó la intención en el constructor visual, seleccione CurrentBalance.
      • Si ha creado la intención en el editor, seleccione WelcomeMessage.

En Intenciones, observe que Architect incluye rutas para cada posible intención coincidente. 

1. Para capturar el número de cuenta en una variable de arquitecto, en Saldo actual escriba "Task.AccountBalance".
2. Agregue una secuencia de audio a la ruta CurrentBalance.
3. Desde la Caja de herramientas, expanda el Audio categoría y arrastre un Reproducir acción de audio en el editor de tareas, debajo de la ruta CurrentBalance.
4. En el panel Reproducir audio, junto a Audio, haga clic en Secuencia de audio . Se abre el cuadro de diálogo Secuencia de audio.
5. En el Texto a voz en el cuadro, escriba "Veo que su número de cuenta es".
6. Hacer clic Agregar datos, y en el Datos tipo de cuadro Task.AccountNumber.
7. Hacer clic Seleccione opciones y elige Habla cada personaje.
8. Hacer clic Cerrar.
9. Continúe agregando rutas de resultados para cada intento. Por ejemplo:
   • Agregue otra acción de reproducción de audio debajo de la ruta CurrentBalance que lea el saldo de la cuenta al cliente.
   • Agrega un Transferir a la acción ACD y transfiera la llamada a un equipo de soporte en caso de que el flujo tome la ruta de falla.
10. Agrega un Desconectar acción hasta el final de la tarea.
11. Hacer clic Publicar.

Ejemplo:

Ejemplo:

Aprende más

• Descripción general de los flujos entrantes
• Trabajar con flujos entrantes
• Crea un flujo entrante
• Acciones del editor de tareas y estados
• Acción del bot Call Lex V2 de Genesys Cloud Architect
• Preguntas frecuentes sobre integraciones de Amazon Lex

Para configurar la entrada de la ruta de llamada, realice los siguientes pasos:

1. En Genesys Cloud, para abrir el Llamadas clic en el panel Llamadas .
2. En el Ingrese nombres y números Tipo de campo BankingBot.
3. Haga clic en el Llama o presione Enter.
4. Siga las indicaciones del bot.

Aprende más

• Haz una llamada