Cómo escribir expresiones

Editar en línea

Puedes escribir _expresiones_ para especificar valores que sean independientes de, o que se deriven de, valores recopilados en pasos o almacenados en variables de sesión. Puede utilizar una expresión para definir una condición de paso o para definir el valor de una variable de sesión.

Utilización de una expresión en una condición de paso

Puede utilizar una expresión en una condición de paso si desea condicionar un paso al resultado de un cálculo basado en la información que ha recopilado durante la conversación.

Por ejemplo, supongamos que un cliente tiene 200 $ en una cuenta de ahorro y quiere transferir 150 $ de la misma a una nueva cuenta corriente. La comisión por una transferencia de fondos es de 3 $, y el banco cobra una comisión cuando una cuenta de ahorro contiene menos de 50 $. Podría crear un paso con una condición de paso que compruebe esta situación. La condición de paso utilizaría una expresión como esta:

${savings} - (${Step_232} + ${transfer_fee}) < 50

donde:

  • ${savings} representa una variable de sesión que almacena el total de la cuenta de ahorro del cliente.

  • ${Step_232} representa el paso que solicita la cantidad que el cliente desea transferir.

  • ${transfer_fee} representa una variable de sesión que especifica la comisión por una transferencia de fondos.

Si se cumple la condición de paso, el paso avisa al usuario de que la transferencia solicitada arrojará un saldo de la cuenta de ahorros inferior al mínimo de $50 y exigirá el pago de una comisión, y solicitará confirmación antes de continuar.

Para utilizar una expresión en una condición de paso, siga estos pasos:

  1. En este paso, haz clic en «Añadir condición ».

Una condición se genera automáticamente con la opción más probable, que suele ser cualquier variable que se haya establecido en el paso anterior.

  1. Pulse el primer segmento de la condición generada y, a continuación, desplácese hacia abajo y pulse Expresión.

  2. Opcional: Haz clic en el icono Icono Expandir de expansión para abrir la ventana del editor de expresiones. (También puede escribir la expresión directamente en el campo sin abrir la ventana, pero el editor facilita la edición de una expresión más larga o compleja)

  3. Escriba la expresión que desea utilizar.

Utilización de una expresión para asignar un valor a una variable de sesión

Puede utilizar las siguientes expresiones de ejemplo para combinar cadenas o calcular números al asignar valores a variables de sesión:

Combinación de cadenas : para concatenar varias cadenas o valores de texto, utilice el símbolo " + " en una expresión.

${session_variable_1} + " some string of text " + ${session_variable_2}

El valor resultante es el contenido de session_variable_1 seguido de " some string of text " y el valor de session_variable_2.

Cálculo de números : Para calcular valores basados en otras variables, utilice expresiones.

Por ejemplo, suponga que desea indicar a su cliente el coste total de una compra, incluidos el 6% de impuestos sobre ventas y3.00 de gastos de tramitación. Para calcular el coste total, cree una variable de sesión y asígnele el valor mediante una expresión:

(${price} * 1.06) + 3

A continuación, puede hacer referencia a esta variable en el campo Asistente dice.

Para utilizar una expresión al asignar un valor a una variable de sesión, siga estos pasos:

  1. Desde un paso, haga clic en Establecer valores de variables.

  2. Haga clic en Establecer nuevo valor.

  3. En la lista desplegable, seleccione la variable de sesión en la que desea almacenar el valor.

  4. Después de to, seleccione Expresión.

  5. Escriba la expresión que desea utilizar.

  6. Si utiliza el editor de expresiones, haga clic en Aplicar para guardar los cambios y cerrar la ventana del editor.

También puede utilizar una expresión para asignar un valor inicial a una variable de sesión. En la ventana Variable de sesión, vaya al campo Valor inicial y haga clic en Utilizar expresión.

También puede escribir una expresión directamente sin elegir primero una variable:

  1. Desde un paso, haga clic en Establecer valores de variables.

  2. Haga clic en Establecer nuevo valor.

  3. En la lista desplegable, seleccione Expresión.

  4. Escriba la expresión que desea utilizar.

  5. Si utiliza el editor de expresiones, haga clic en Aplicar para guardar los cambios y cerrar la ventana del editor.

sintaxis de expresiones

El lenguaje de expresiones del asistente de IA se basa en el Spring Expression Language ( SpEL ), aunque presenta algunas diferencias importantes en cuanto a la sintaxis. Para obtener información detallada sobre el lenguaje de expresiones de Spring (SpEL, ), consulte Spring Expression Language ( SpEL ).

Variables

Para hacer referencia a una variable en una expresión, escriba un signo de dólar ($) y, a continuación, seleccione una variable de la lista. La referencia se inserta en su expresión en la notación correcta, haciendo referencia a la variable utilizando su ID de variable en lugar de su nombre para mostrar (por ejemplo, ' ${step_773} o ' ${customer_id}). No edites esta referencia a menos que quieras referirte a una variable diferente y estés seguro de su ID de variable.

Para hacer referencia a la acción definida por el usuario o a las variables de sesión en una aplicación cliente personalizada, utilice el prefijo de palabra clave reservada ' user_defined_. Por ejemplo, utilice ' ${user_defined_my_context_var} para obtener el valor de ' my_context_var ' establecido por su cliente.

Matemáticas estándares

Para los valores numéricos, puede utilizar expresiones para realizar cálculos matemáticos. Para la aritmética básica, puede utilizar operadores estándar (+, ' -, ' *, ' /).

También puede utilizar métodos para realizar operaciones matemáticas adicionales. Para obtener más información, consulte Métodos del lenguaje de expresión para acciones.

Matrices

Para definir un valor de matriz, escriba el valor entre corchetes, con comas separando los elementos (por ejemplo, ' [ "one", "two", "three" ]).

Para hacer referencia a un elemento de una matriz, utilice la notación de corchetes y especifique el índice basado en cero del elemento de la matriz Por ejemplo, " ${Items}[0] representa el primer elemento de la matriz " Items.

También puedes utilizar el método de array ' get() ' para recuperar un elemento de un array. Para obtener más información, consulte Métodos del lenguaje de expresión para acciones.

Objetos JSON

Utilice la notación JSON para definir objetos compuestos en expresiones. Por ejemplo, la siguiente expresión asigna un objeto JSON complejo como valor de una variable:

{
  "name": {
    "firstname": "John",
    "lastname": "Doe"
  },
  "age": 36
}

Puede utilizar variables y matemáticas estándar dentro de JSON para crear objetos dinámicos que se calculan en tiempo de ejecución. Por ejemplo, la siguiente expresión define un objeto JSON que hace referencia a variables y calcula un valor medio:

{
  "temp_1": ${temp_1},
  "temp_2": ${temp_2},
  "avg_temp": (${temp_1} + ${temp_2}) / 2
}

Para hacer referencia a un objeto hijo contenido en un valor JSON, utilice la notación con puntos para expresar la ruta al objeto (por ejemplo, ' ${customer}.name.lastname).

Si necesita hacer referencia a un hijo de un objeto que podría estar definido o no, utilice el operador de navegación segura (?). Por ejemplo, la expresión ' ${customer}.name?.lastname se evalúa como ' null si ' customer.name ' es ' null. (Sin el operador de navegación segura, se produciría un error)

métodos

Utilizar métodos del lenguaje de expresión para manipular valores (por ejemplo, dar formato a una cadena o añadir un elemento a una matriz). Para obtener más información sobre los métodos compatibles con cada tipo de datos, consulte «Métodos del lenguaje de expresiones para acciones ».