Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Crear rutas de conversación Normalmente, Amazon Lex V2 gestiona el flujo de las conversaciones con los usuarios. En el caso de los bots simples, el flujo predeterminado puede ser suficiente para crear una buena experiencia para los usuarios. Sin embargo, en el caso de los bots más complejos, es posible que desee tomar el control de la conversación y dirigir el flujo hacia rutas más complejas. Por ejemplo, en el caso de un bot para reservar coches de alquiler, es posible que no quiera alquilarlos a conductores más jóvenes. En este caso, puede crear una condición que compruebe si un conductor tiene menos de cierta edad y, de ser así, pasar directamente a la respuesta de cierre. ![\[Un diagrama de flujo que muestra el flujo de conversación de un bot para alquiler de coches que no alquila a conductores menores de 24 años.\]](http://docs.aws.amazon.com/es_es/lexv2/latest/dg/images/conditional-flowchart.png) Para diseñar estas interacciones, puede configurar el siguiente paso en cada punto de la conversación, evaluar las condiciones, establecer valores e invocar enlaces de código. La ramificación condicional le ayuda a crear rutas para sus usuarios a través de interacciones complejas. Puede usar una ramificación condicional en cualquier momento en el que pase el control de la conversación a su bot. Por ejemplo, puede crear una condición antes de que el bot obtenga el primer valor del slot, puede crear una condición entre la obtención de cada valor de slot o puede crear una condición antes de que el bot finalice la conversación. Para ver una lista de los puntos en los que puede añadir condiciones, consulte [Adición de intenciones](add-intents.md). Al crear un bot, Amazon Lex V2 crea una ruta predeterminada a través de la conversación en función del orden de prioridad de los slots. Para personalizar la ruta de la conversación, puede modificar el siguiente paso en cualquier momento de la conversación. Para obtener más información, consulte [Configurar los siguientes pasos de la conversación](paths-nextstep.md). Para crear rutas alternativas en función de las condiciones, puede usar una rama condicional en cualquier punto de la conversación. Por ejemplo, puede crear una condición antes de que el bot obtenga el primer valor del slot. Puede crear una condición entre la obtención de cada valor de slot o puede crear una condición antes de que el bot finalice la conversación. Para ver una lista de los puntos en los que puede añadir condiciones, consulte [Añadir condiciones a las conversaciones ramificadas](paths-branching.md). Puede establecer condiciones en función de los valores de los slots, los atributos de sesión, el modo de entrada y la transcripción de entrada o una respuesta de Amazon Kendra. Puede configurar los valores de los atributos y los slots de la sesión en cualquier momento de la conversación. Para obtener más información, consulte [Establecer valores durante la conversación](paths-setting-values.md). También puede configurar la siguiente acción en un enlace de código de diálogo para ejecutar una función de Lambda. Para obtener más información, consulte [Invocar el enlace de código de diálogo](paths-code-hook.md). En la imagen siguiente, se muestra la creación de una ruta para un slot en la consola. En este ejemplo, Amazon Lex V2 obtendrá el slot «edad». Si el valor de la ranura es inferior a 24, Amazon Lex V2 pasa a la respuesta de cierre; de lo contrario, Amazon Lex V2 seguirá la ruta predeterminada. ![\[La consola Amazon Lex V2 muestra el editor de estado de una ranura.\]](http://docs.aws.amazon.com/es_es/lexv2/latest/dg/images/conditional-slot.png) **nota** El 17 de agosto de 2022, Amazon Lex V2 publicó un cambio en la forma en que se gestionan las conversaciones con el usuario. Este cambio le da más control sobre la ruta que sigue el usuario a lo largo de la conversación. Para obtener más información, consulte [Cambios en los flujos de conversación en Amazon Lex V2](understanding-new-flows.md). Los bots creados antes del 17 de agosto de 2022 no admiten mensajes de enlace de código de diálogo, ni permiten establecer valores, configurar los pasos siguientes ni añadir condiciones. # Configurar los siguientes pasos de la conversación Puede configurar el siguiente paso en cada etapa de la conversación para diseñar las conversaciones. Normalmente, Amazon Lex V2 configura automáticamente los siguientes pasos predeterminados para cada etapa de la conversación según el siguiente orden. Respuesta inicial → Obtención de slot → Confirmación (si está activa) → Cumplimiento (si está activo) → Respuesta de cierre (si está activa) → Fin de la conversación Puede modificar los siguientes pasos predeterminados y diseñar la conversación en función de la experiencia del usuario esperada. Los siguientes pasos se pueden configurar en cada etapa de la conversación: **Saltar a** + **Respuesta inicial**: la conversación se reinicia desde el principio de la intención. Puede optar por omitir la respuesta inicial al configurar el siguiente paso. + **Obtener un slot**: puede obtener cualquier slot en la intención. + **Evaluar las condiciones**: puede evaluar las condiciones y diversificar la conversación en cualquier etapa de la conversación. + **Invocar el enlace de código de diálogo**: puede invocar la lógica empresarial en cualquier momento. + **Confirmar la intención**: se le pedirá al usuario que confirme la intención. + **Cumplir la intención**: el cumplimiento de la intención comenzará como el siguiente paso. + **Respuesta de cierre**: la respuesta de cierre se devolverá al usuario. **Cambiar a** + **Intención**: puede cambiar a una intención diferente y continuar la conversación con esa intención. Si lo desea, puede omitir la respuesta inicial de la intención mientras realiza la transición. + **Intención: slot específico:** puede obtener directamente un slot específico con una intención diferente si ya ha capturado algunos valores de slot en la intención actual. **Espera a la entrada del usuario**: el bot espera a que el usuario introduzca información para reconocer cualquier nueva intención. Puede configurar mensajes como «¿Puedo ayudarte con algo más?» antes de configurar el siguiente paso. El bot tendrá el estado `ElicitIntent` de diálogo. **Finalizar conversación**: se cierra la conversación con el bot. **nota** El 17 de agosto de 2022, Amazon Lex V2 publicó un cambio en la forma en que se gestionan las conversaciones con el usuario. Este cambio le da más control sobre la ruta que sigue el usuario a lo largo de la conversación. Para obtener más información, consulte [Cambios en los flujos de conversación en Amazon Lex V2](understanding-new-flows.md). Los bots creados antes del 17 de agosto de 2022 no admiten mensajes de enlace de código de diálogo, ni permiten establecer valores, configurar los pasos siguientes ni añadir condiciones. # Establecer valores durante la conversación Amazon Lex V2 ofrece la posibilidad de establecer valores de slot y valores de atributos de sesión en cada paso de la conversación. A continuación, puede utilizar estos valores durante la conversación para evaluar las condiciones o utilizarlos para cumplir la intención. Puede establecer valores de slot para la intención actual. Si el siguiente paso de la conversación es invocar otra intención, puede establecer los valores de slot de la nueva intención. Si el slot asignado no está ocupado o si no se puede analizar la ruta JSON, el atributo se establecerá en `null`. Utilice la siguiente sintaxis cuando utilice valores de slot y atributos de sesión: + **Valores de slot**: escriba el nombre del slot entre corchetes («\$1 \$1»). Para los valores de slot con la intención actual, solo necesita usar el nombre del slot. Por ejemplo, `{slot}`. Si va a establecer un valor en la siguiente intención, debe utilizar tanto el nombre de la intención como el nombre del slot para identificarlo. Por ejemplo, `{intent.slot}`. Ejemplos: + `{PhoneNumber} = "1234567890"` + `{CheckBalance.AccountNumber} = "99999999"` + `{BookingID} = "ABC123"` + `{FirstName} = "John"` El valor de un slot puede ser cualquiera de los siguientes: + una cadena constante + una ruta JSON que hace referencia al bloque de transcripciones de la respuesta de Amazon Lex (para en-US y en-GB) + un atributo de sesión Ejemplos: + `{username} = "john.doe" ` + `{username_confidence} = $.transcriptions[0].transcriptionConfidence ` + `{username_slot_value} = [username] ` **nota** Los valores de slot también se pueden configurar como `null`. Si necesita volver a obtener el valor de un slot que ya se ha ocupado, debe establecer el valor en `null` antes de volver a solicitar al cliente el valor del slot. Si el slot asignado no está ocupado o si no se puede analizar la ruta JSON, el atributo se establecerá en `null`. + **Atributos de sesión**: escriba el nombre del atributo entre corchetes («[ ]»). Por ejemplo, `[sessionAttribute]`. Ejemplos: + ` [username] = "john.doe" ` + ` [username_confidence] = $.transcriptions[0].transcriptionConfidence ` + ` [username_slot_value] = {username} ` El valor del atributo de sesión puede ser uno de los siguientes valores: + una cadena constante + una ruta JSON que hace referencia al bloque de transcripciones de la respuesta de Amazon Lex (para en-US y en-GB) + una referencia de valor de slot **nota** Si el slot asignado no está ocupado o si no se puede analizar la ruta JSON, el atributo se establecerá en `null`. **nota** El 17 de agosto de 2022, Amazon Lex V2 publicó un cambio en la forma en que se gestionan las conversaciones con el usuario. Este cambio le da más control sobre la ruta que sigue el usuario a lo largo de la conversación. Para obtener más información, consulte [Cambios en los flujos de conversación en Amazon Lex V2](understanding-new-flows.md). Los bots creados antes del 17 de agosto de 2022 no admiten mensajes de enlace de código de diálogo, ni permiten establecer valores, configurar los pasos siguientes ni añadir condiciones. # Añadir condiciones a las conversaciones ramificadas Puede usar la *ramificación condicional* para controlar la ruta que sigue su cliente durante la conversación con su bot. Puede ramificar la conversación en función de los valores de los slots, los atributos de sesión, los contenidos del modo de entrada y los campos de transcripción de entrada o una respuesta de Amazon Kendra. Puede definir hasta cuatro ramas. Cada rama tiene una condición que debe cumplirse para que Amazon Lex V2 siga esa rama. Si ninguna de las ramas cumple su condición, se sigue una rama predeterminada. Cuando define una rama, define la acción que Amazon Lex V2 debe realizar si las condiciones correspondientes a esa rama resultan verdaderas. Puede definir cualquiera de las siguientes acciones: + Una respuesta enviada al usuario. + Valores de slots para aplicarlos a los slots. + Valores de los atributos de sesión para la sesión actual. + El siguiente paso de la conversación. Para obtener más información, consulte [Crear rutas de conversación](building-paths.md). ![\[Puede elegir diferentes opciones para la ramificación condicional.\]](http://docs.aws.amazon.com/es_es/lexv2/latest/dg/images/conditional-choose.png) Cada rama condicional tiene una expresión booleana que debe cumplirse para que Amazon Lex V2 siga esa rama. Existen operadores de comparación y booleanos, funciones y operadores cuantificadores que puede utilizar para sus condiciones. Por ejemplo, la siguiente condición se vuelve verdadera si el slot \$1edad\$1 es inferior a 24. ``` {age} < 24 ``` La siguiente condición se cumple si el slot multivalor \$1ingredientes\$1 contiene la palabra «piña». ``` {toppings} CONTAINS "pineapple" ``` Puede combinar varios operadores de comparación con un operador booleano para condiciones más complejas. Por ejemplo, la siguiente condición se cumple si el valor del slot \$1marca\$1 es «Honda» y el valor del slot \$1modelo\$1 es «Civic». Use paréntesis para establecer el orden de evaluación. ``` ({make} = "Honda") AND ({model} = "Civic") ``` En los siguientes temas se proporcionan detalles sobre los operadores y las funciones de las ramas condicionales. **nota** El 17 de agosto de 2022, Amazon Lex V2 publicó un cambio en la forma en que se gestionan las conversaciones con el usuario. Este cambio le da más control sobre la ruta que sigue el usuario a lo largo de la conversación. Para obtener más información, consulte [Cambios en los flujos de conversación en Amazon Lex V2](understanding-new-flows.md). Los bots creados antes del 17 de agosto de 2022 no admiten mensajes de enlace de código de diálogo, ni permiten establecer valores, configurar los pasos siguientes ni añadir condiciones. **Topics** + [Operadores de comparación](#branching-comparison) + [Operadores booleanos](#branching-boolean) + [Operadores cuantificadores](#branching-quentifier) + [Funciones](#branching-function) + [Ejemplos de expresiones condicionales](#sample-conditional-expressions) ## Operadores de comparación Amazon Lex V2 admite los siguientes operadores de comparación para las condiciones: + Igual (=) + Distinto de (\$1=) + Menor que (<) + Menor que o igual a (<=) + Mayor que (>) + Mayor que o igual a (>=) Cuando se utiliza un operador de comparación, se utilizan las siguientes reglas. + El lado izquierdo debe ser una referencia. Por ejemplo, para hacer referencia a un valor del slot, utilice `{slotName}`. Para hacer referencia a un valor de atributo de sesión, utilice `[attribute]`. Para el modo de entrada y la transcripción de entrada, se utiliza `$.inputMode` y `$.inputTranscript`. + El lado derecho debe ser constante y del mismo tipo que el lado izquierdo. + Cualquier expresión que haga referencia a un atributo que no se haya establecido se considera inválida y no se evalúa. + Al comparar un slot con varios valores, el valor utilizado es una lista separada por comas de todos los valores interpretados. Las comparaciones se basan en el tipo de slot de la referencia. Se resuelven de la siguiente manera: + **Cadenas**: las cadenas se comparan en función de su representación en ASCII. Esta comparación no distingue entre mayúsculas y minúsculas. + **Números**: los slots basados en números se convierten de la representación de cadena a un número y, a continuación, se comparan. + **Fecha/hora**: los slots basados en el tiempo se comparan en función de la serie temporal. La fecha u hora anterior se considera más pequeña. En cuanto a la duración, los períodos más cortos se consideran más pequeños. ## Operadores booleanos Amazon Lex V2 admite operadores booleanos para combinar operadores de comparación. Permiten crear declaraciones similares a las siguientes: ``` ({number} >= 5) AND ({number} <= 10) ``` También puede utilizar las siguientes operaciones: + Y (&&) + O (\$1\$1) + NO (\$1) ## Operadores cuantificadores Los operadores cuantificadores evalúan los elementos de una secuencia y determinan si uno o más elementos cumplen la condición. + **CONTIENE**: determina si el valor especificado está contenido en un slot con varios valores y devuelve el valor verdadero si lo es. Por ejemplo, `{toppings} CONTAINS "pineapple"` devuelve el valor verdadero si el usuario pidió piña para su pizza. ## Funciones Las funciones deben ir precedidas de la cadena `fn.`. El argumento de la función es una referencia a un slot, un atributo de sesión o un atributo de solicitud. Amazon Lex V2 proporciona dos funciones para obtener información de los valores de los slots: SessionAttribute o RequestAttribute. + **fn.COUNT ()**: cuenta el número de valores de un slot con varios valores. Por ejemplo, si el slot `{toppings}` contiene el valor «pepperoni, piña»: `fn.COUNT({toppings}) = 2` + **fn.IS\$1SET ()**: el valor es verdadero si se establece un slot, un atributo de sesión o un atributo de solicitud en la sesión actual. Basado en el ejemplo anterior: `fn.IS_SET({toppings})` + **fn.LENGTH()**: el valor es la longitud del valor del atributo de sesión, el valor de ranura o el atributo de ranura que se establece en la sesión actual. Esta función no admite ranuras de valores múltiples ni ranuras compuestas. Ejemplo: Si la ranura `{credit-card-number}` contiene el valor “123456781234”: `fn.LENGTH({credit-card-number}) = 12` ## Ejemplos de expresiones condicionales Estos son algunos ejemplos de expresiones condicionales. NOTA: `$.` representa el punto de entrada a la respuesta JSON de Amazon Lex V2. El siguiente valor se `$.` analizará en la respuesta de Amazon Lex V2 para recuperar el valor. Las expresiones condicionales que utilicen la referencia de ruta JSON al bloque de transcripciones en la respuesta de Amazon Lex V2 solo se admitirán en las mismas configuraciones regionales que admiten las puntuaciones de transcripción de ASR. | Tipo de valor | Caso de uso | Expresión condicional | | --- | --- | --- | | Slot personalizado | El valor del slot pizzaSize es igual a grande | \$1pizzaSize\$1 = "large" | | Slot personalizado | pizzaSize es igual a grande o mediana | \$1pizzaSize\$1 = "large" O \$1pizzaSize\$1 = "medium" | | Slot personalizado | Expresiones con () y AND/OR | \$1pizzaType\$1 = "pepperoni" O \$1pizzaSize\$1 = "medium" O \$1pizzaSize\$1 = "small" | | Slot personalizado (slot con varios valores) | Compruebe si uno de los ingredientes es cebolla | \$1toppings\$1 CONTAINS "Onion" | | Slot personalizado (slot con varios valores) | El número de ingredientes es superior a 3 | fn.COUNT(\$1topping\$1) > 2 | | AMAZON.AlphaNumeric | bookingIDes ABC123 | \$1bookingID\$1 = "ABC123" | | AMAZON.Number | el valor del slot de edad es superior a 30 | \$1age\$1 > 30 | | AMAZON.Number | el valor del slot de edad es igual a 10 | \$1age\$1 = 10 | | AMAZON.Date | valor del slot dateOfBirth antes de 1990 | \$1dateOfBirth\$1 < "1990-10-01" | | AMAZON.State | el valor del slot destinationState es igual a Washington | \$1destinationState\$1 = "washington" | | AMAZON.Country | el valor del slot destinationCountry es no Estados Unidos | \$1destinationCountry\$1 \$1= "united states" | | AMAZON.FirstName | el valor del slot firstName es John | \$1firstName\$1 = "John" | | AMAZON.PhoneNumber | el valor del slot phoneNumber es 716767891932 | \$1phoneNumer\$1 = 716767891932 | | AMAZON.Percentage | Compruebe si el valor del slot porcentual es mayor o igual a 78 | \$1percentage\$1 >= 78 | | AMAZON.EmailAddress | el valor del slot emailAddress es userA@hmail.com | \$1emailAddress\$1 = "userA@hmail.com" | | AMAZON.LastName | el valor del slot lastName es Doe | \$1lastName\$1 = "Doe" | | AMAZON.City | El valor del slot de la ciudad es igual a Seattle | \$1city\$1 = "Seattle" | | AMAZON.Time | La hora es después de las 8 p. m. | \$1time\$1 > "20:00" | | AMAZON.StreetName | el valor del slot streetName es Boren Avenue | \$1streetName\$1 = "boren avenue" | | AMAZON.Duration | el valor del slot travelDuration es inferior a 2 horas | \$1travelDuration\$1 < P2H | | Modo de entrada | El modo de entrada es voz | \$1.inputMode = "Speech" | | Transcripción de entrada | La transcripción de entrada equivale a «Quiero una pizza grande» | \$1.inputTranscript = "I want a large pizza" | | Atributos de sesión | compruebe el atributo customer\$1subscription\$1type | [customer\$1subcription\$1type] = "yearly" | | Atributo de solicitud | compruebe el indicador retry\$1enabled | ((retry\$1enabled)) = "TRUE" | | Respuesta de Kendra | La respuesta de Kendra contiene preguntas frecuentes | fn.IS\$1SET(((x-amz-lex:kendra-search-response-question\$1answer-question-1))) | | Expresión condicional con transcripciones | Expresiones condicionales que utilizan la ruta JSON de transcripciones | \$1.transcriptions[0].transcriptionConfidence < 0.8 AND \$1.transcriptions[1].transcriptionConfidence > 0.5 | | Establecer atributos de sesión | Establezca los atributos de sesión mediante la ruta JSON de las transcripciones y los valores de los slots. | [sessionAttribute] = "\$1.transcriptions..." AND [sessionAttribute] = "\$1\$1" | | Establecer valores de slot | Establezca los valores de slot utilizando atributos de sesión y la ruta JSON de las transcripciones. | \$1slotName\$1 = [] AND \$1slotName\$1 = "\$1.transcriptions..." | **nota** `slotName`hace referencia al nombre de una ranura en el bot Amazon Lex V2. Si el slot no está resuelto (nulo) o si no existe, las asignaciones se ignoran durante el tiempo de ejecución. `sessionAttribute` hace referencia al nombre del atributo de sesión que establece el cliente en el momento de la compilación. # Invocar el enlace de código de diálogo En cada paso de la conversación, cuando Amazon Lex V2 envíe un mensaje al usuario, podrá utilizar una función Lambda como siguiente paso de la conversación. Puede utilizar la función para implementar la lógica empresarial en función del estado actual de la conversación. La función de Lambda que se ejecuta está asociada al alias del bot que está utilizando. Para invocar la función de Lambda en todos los enlaces de código de diálogo en su intención, debe seleccionar **Utilizar una función de Lambda para inicializar y validar** la intención. Para obtener más información sobre elegir una función de Lambda, consulte [Creación de una AWS Lambda función para su bot Amazon Lex V2](lambda-attach.md). Para utilizar una función de Lambda, se deben realizar dos pasos. En primer lugar, debe activar el enlace de código de diálogo en cualquier momento de la conversación. En segundo lugar, debe configurar el siguiente paso de la conversación para utilizar el enlace de código de diálogo. En la imagen siguiente, se muestra el enlace de código de diálogo activado. ![\[Muestra que el enlace de código de respuesta condicional está activo.\]](http://docs.aws.amazon.com/es_es/lexv2/latest/dg/images/code-hook-active.png) A continuación, establezca el enlace de código como la siguiente acción del paso de la conversación. Para ello, configure el siguiente paso de la conversación para invocar el enlace de código de diálogo. La siguiente imagen muestra una rama condicional en la que el siguiente paso para la ruta predeterminada de la conversación es invocar el enlace de código de diálogo. ![\[Una ramificación condicional que muestra un enlace de código como siguiente paso de la conversación.\]](http://docs.aws.amazon.com/es_es/lexv2/latest/dg/images/code-hook-choose.png) Cuando los enlaces de código están activos, puede configurar tres respuestas para devolverlas al usuario: + **Éxito**: se envía cuando la función de Lambda se completó correctamente. + **Error**: se envía si ocurrió un problema al ejecutar la función de Lambda o si la función de Lambda devolvió un valor `intent.state` de `Failed`. + **Tiempo de espera agotado**: se envía si la función de Lambda no se completó en el período de tiempo de espera configurado. ![\[Diagrama de flujo que muestra las opciones disponibles para los mensajes después de ejecutar una función de Lambda.\]](http://docs.aws.amazon.com/es_es/lexv2/latest/dg/images/conditional-code-hook.png) Seleccione el **enlace de código de diálogo Lambda** y, a continuación, seleccione **Opciones avanzadas** para ver las tres opciones de respuestas que corresponden a la invocación de la función de Lambda. Puede establecer valores, configurar los siguientes pasos y aplicar las condiciones correspondientes a cada respuesta para diseñar el flujo de la conversación. En ausencia de una condición o de un siguiente paso explícito, Amazon Lex V2 decide el siguiente paso en función del estado actual de la conversación. En la página **Opciones avanzadas**, también puede optar por habilitar o deshabilitar la invocación de la función de Lambda. Cuando la función está habilitada, el enlace de código de diálogo se invoca con una invocación a Lambda, seguida del mensaje de éxito, error o tiempo de espera agotado basado en los resultados de la invocación a Lambda. Cuando la función está deshabilitada, Amazon Lex V2 no ejecuta la función de Lambda y continúa como si el enlace de código de diálogo se hubiera realizado correctamente. También puede establecer una etiqueta de invocación que se envíe a la función de Lambda cuando se invoque mediante este mensaje. Puede usar esto para ayudar a identificar la sección de la función de Lambda que debe ejecutarse. **nota** El 17 de agosto de 2022, Amazon Lex V2 publicó un cambio en la forma en que se gestionan las conversaciones con el usuario. Este cambio le da más control sobre la ruta que sigue el usuario a lo largo de la conversación. Para obtener más información, consulte [Cambios en los flujos de conversación en Amazon Lex V2](understanding-new-flows.md). Los bots creados antes del 17 de agosto de 2022 no admiten mensajes de enlace de código de diálogo, ni permiten establecer valores, configurar los pasos siguientes ni añadir condiciones.