Formatos reconocidos

• 20 céntimos
• Cinco dólares
• 10 USD

Atributos

• .literal: frase exacta en la entrada que se interpreta como una mención de moneda.
• .numeric_value: valor numérico canónico como entero o doble, en unidades base.
• .location: lista los valores de elementos de índice de la primera y última letras de la serie de texto para la frase que se interpreta como una mención de moneda.
• .unit: Unidad monetaria de base que se especifica como un código monetario ISO de 3 letras. Por ejemplo, USD o EUR.

En la tabla siguiente se muestra la información que cada atributo captura de la entrada de usuario.

Para la entrada veinte euro ( twenty euro en español) o €1.234,56, @sys-currency devuelve estos valores:

Se devuelven resultados equivalentes para otros idiomas y monedas nacionales soportados.

Consejos sobre el uso de @sys-currency

Si utiliza la entidad @sys-currency como condición de nodo y el usuario especifica $0 como valor, el valor se reconoce como moneda correctamente, pero la condición se evalúa en el número cero, no la moneda cero. Como resultado, el null en la condición se evalúa como falso y el nodo no se procesa. Para comprobar los valores de moneda de forma que se haga un tratamiento correcto de los ceros, utilice en su lugar la expresión @sys-currency OR @sys-currency == 0 en la condición del nodo.

Para obtener más información sobre las monedas reconocidas por cada idioma, consulte Soporte de monedas.

Formatos reconocidos

• Viernes
• hoy
• May 8 (8 de mayo)

Atributos

• .alternatives: Guarda valores de fecha alternativos cuando la entrada puede tener distintas interpretaciones. Normalmente, la fecha futura se devuelve como el valor @sys-date. Si hay ambigüedad, se guarda la fecha pasada como una fecha alternativa. Por ejemplo, para la entrada in January (en enero), se devuelve una fecha futura. Sin embargo, si estamos a febrero (enero ya ha pasado este año), entonces también se devuelve el enero pasado como una fecha alternativa. También se proporciona una fecha alternativa para los días de la semana cuando se especifica el día de la semana sin un modificador. Por ejemplo, para la entrada Are you open Wednesday?, se guarda la fecha futura, pero se crea también una fecha alternativa con la fecha del miércoles anterior. Se crean fechas alternativas para frases que contienen modificadores como next (siguiente), this (este) o last (último), que pueden tener distintos significados en distintos entornos locales. El servicio watsonx Assistant trata las fechas last (última) and next (siguiente) como si hicieran referencia al último o al siguiente día más inmediato, que puede estar dentro de la misma semana o en la anterior. Para algunos modificadores, se crea una fecha alternativa o no según el día actual de la semana. Por ejemplo, imaginemos que la entrada contiene this Wednesday (este miércoles). Si es lunes, se guarda la fecha futura y no se crea ninguna fecha alternativa. No obstante, si hoy es miércoles, se supone que la fecha es el miércoles de la semana próxima, pero se guarda la fecha de hoy como fecha alternativa. Cada fecha alternativa se guarda como un objeto que contiene un valor y una confianza para cada fecha alternativa. Los objetos de fecha alternativa se guardan en una matriz JSON. Para obtener un valor alternativo, utilice la sintaxis: @sys-date.alternative.
• .calendar_type: Especifica el tipo de calendario para la zona horaria en uso. GREGORIAN es el único tipo admitido.
• .datetime_link: consulte Menciones de fecha y hora.
• .day: método de ayuda que devuelve el día en la fecha.
• .day_of_week: devuelve el día de la semana en la fecha como una serie en minúsculas.
• .festival: Reconoce los nombres de días festivos específicos del entorno local y puede devolver la fecha de los próximos festivos, como, por ejemplo, Thanksgiving, Christmas y Halloween. Si quiere especificar el nombre de un festivo, utilice minúsculas en la condición; por ejemplo, (@sys-date.festival == 'thanksgiving'). Para obtener más información sobre los festivos reconocidos, consulte Festivos.
• .granularity: reconoce menciones de marcos de tiempo. Las opciones son day, weekend, week, fortnight, month, quarter y year (día, fin de semana, semana, quincena, mes, trimestre y año).
• .interpretation: El objeto devuelto por su asistente, que contiene nuevos campos que aumentan la precisión del clasificador de entidades del sistema. Puede omitir interpretation de la expresión que utiliza para hacer referencia a sus campos. Por ejemplo, puede acceder al valor del campo festival del objeto de interpretación utilizando la sintaxis abreviada <? @sys-date.festival ?>.
• .literal: frase exacta en la entrada que se interpreta como la fecha.
• .location: valores de elementos de índice de la primera y última letras de la serie de texto para la frase que se interpreta como una fecha.
• .month: método de ayuda que devuelve el mes en la fecha.
• .range_link: si está presente, indica que la entrada del usuario contiene un rango de fechas. Los valores de índice de inicio y final de la serie que incluye el rango de fechas se guardan como parte del nombre de enlace. Se proporciona información adicional, incluyendo el rol que cada @sys-date juega en la relación de rango. Por ejemplo, la fecha de inicio tiene el tipo de rol de date_from y la fecha de finalización tiene el tipo de rol date_to. Para comprobar un valor de rol, puede utilizar la sintaxis @sys-date.role?.type == 'date_from'. Si la entrada de usuario implica un rango, pero solo se especifica una fecha, la propiedad range_link no se devuelve, pero se devuelve un tipo de rol. Por ejemplo, si el usuario pregunta a Have you been open since yesterday. La fecha de ayer se reconoce como la mención @sys-date, y se devuelve el rol de tipo date_from. También se devuelve un range_modifier que indica la palabra en la entrada que ha propiciado la identificación de un rango. En este ejemplo, el modificador es since.
• .relative_{timeframe}: reconoce y captura menciones de valores de fecha relativos en la entrada del usuario. Devuelve un número que muestra el número de unidades entre ahora y la fecha especificada. Las unidades {time frame} pueden ser year, month, week, weekend, o day.
• .specific_{timeframe}: reconoce y captura menciones de unidades de fecha específicas en la entrada del usuario. Las unidades {time frame} pueden ser year, quarter, month, day, o day_of_week.
• .year: método de ayuda que devuelve el año en la fecha.

En la tabla siguiente se muestra la información que cada atributo captura de la entrada de usuario.

Formatos reconocidos

• 2pm
• at 4
• 15:30

Atributos

• .alternatives: Captura horas distintas de la guardada como valor @sys-time que el usuario podría querer decir cuando la hora no está claramente indicada. Los valores alternativos se guardan como un objeto que contiene un valor y una confianza para cada hora alternativa y que se almacenan en una matriz JSON. Para obtener un valor alternativo, utilice la sintaxis: @sys-time.alternative.
• .calendar_type: Especifica el tipo de calendario para la zona horaria en uso. GREGORIAN es el único tipo admitido.
• .granularity: reconoce menciones de marcos de tiempo. Las opciones son hour, minute, second y instant.
• .hour: método de ayuda que devuelve la hora que se especifica en formato de hora como un valor numérico.
• .interpretation: El objeto devuelto por su asistente, que contiene nuevos campos que aumentan la precisión del clasificador de entidades del sistema. Puede omitir interpretation de la expresión que utiliza para hacer referencia a sus campos. Por ejemplo, puede acceder al valor del campo granularity del objeto de interpretación utilizando la sintaxis abreviada <? @sys-time.granularity ?>.
• .literal: Frase exacta en la entrada que se interpreta como la hora.
• .location: lista los valores de elementos de índice de la primera y última letras de la serie de texto para la frase que se interpreta como una mención de hora.
• .minute: método de ayuda que devuelve el valor de minuto que se especifica en la hora.
• .part_of_day: reconoce los términos que representan la hora del día, como, por ejemplo, morning, afternoon, evening, night o now (mañana, tarde, tarde / noche, noche o ahora). También establece un intervalo de tiempo para cada parte del día. La respuesta contiene dos valores @sys-time, uno para el inicio y otro para el final del intervalo de tiempo. La matriz de entidades contiene un objeto range_link con los tipos de rol time-from y time-to. Los rangos de tiempo para las distintas partes del día pueden diferir según el entorno local. Para inglés de Estados Unidos, la mañana es de 6:00:00 a 12:00:00. La tarde es de 12:00:00 a 18:00:00. La noche es de 18:00:00 a 22:00:00. La noche es de 22:00:00 a 23:59:59. La noche finaliza justo antes de medianoche porque, de lo contrario, se solaparía con el día siguiente, que se mide mediante @sys-date.
• .range_link: si está presente, indica que la entrada del usuario contiene un rango de horas. Los valores de índice de inicio y final de la serie que incluye el rango de horas se guardan como parte del nombre de enlace. Se proporciona información adicional, incluyendo el rol que cada @sys-time juega en la relación de rango. Por ejemplo, la hora de inicio tiene el tipo de rol de time_from y la hora de finalización tiene el tipo de rol time_to. Para comprobar un valor de rol, puede utilizar la sintaxis @sys-time.role?.type == 'time_from'. Si la entrada de usuario implica un rango, pero solo se especifica una hora, la propiedad range_link no se devuelve, pero se devuelve un tipo de rol. También se devuelve un range_modifier que indica la palabra en la entrada que ha propiciado la identificación de un rango.
• .relative_{timeframe}: reconoce menciones relativas y devuelve un número que muestra el número de unidades entre ahora y la hora especificada. Las unidades de {timeframe} pueden ser hour, minute o second (hora, minuto o segundo).
• .second: método de ayuda que devuelve el valor de segundo que se especifica en la hora.
• .specific_{timeframe}: reconoce y captura menciones de unidades de hora específicas en la entrada del usuario. Las unidades de {timeframe} pueden ser hour, minute o second (hora, minuto o segundo).

En la tabla siguiente se muestra la información que cada atributo captura de la entrada de usuario.

Formatos reconocidos

• now
• two hours from now (dentro de 2 horas)
• on Monday at 4pm (el lunes a las 4pm)

Atributos

• .datetime_link: Si está presente, indica que la entrada del usuario menciona una fecha y una hora juntas, lo que implica que la fecha y la hora están relacionadas entre sí. Los valores de índice de inicio y final de la serie que incluye la fecha y la hora se guardan como parte del nombre de enlace.

En la tabla siguiente se muestra la información que cada atributo captura de la entrada de usuario.

Husos horarios

Las menciones de fecha u hora relativas a la hora actual se resuelven con respecto al huso horario elegido. De forma predeterminada, el huso horario es la hora media de Greenwich. Por lo tanto, los clientes de API REST que se encuentran en diferentes husos horarios obtienen la hora universal coordinada actual cuando se menciona now (ahora) en la entrada.

Opcionalmente, el cliente de la API REST puede añadir el huso horario local como variable de contexto $timezone. Esta variable de contexto se debe enviar con cada solicitud de cliente. Por ejemplo, el valor de $timezone puede ser America/Los_Angeles, EST o UTC. Para ver una lista completa de los husos horarios soportados, consulte Husos horarios soportados.

Cuando se proporciona la variable $timezone, los valores de las menciones relativas @sys-date y @sys-time se calculan en función de la zona horaria del cliente en lugar de la Hora Universal Coordinada.

Para obtener información sobre el proceso de los valores de fecha y hora, consulte la Referencia del método de fecha y hora.

Formatos reconocidos

• 21
• twenty one
• 3.13

Atributos

• .literal: frase exacta en la entrada que se interpreta como el número.
• .location: valores de elementos de índice de la primera y última letras de la serie de texto que se interpreta como un número.
• .numeric_value: valor numérico canónico como entero o doble.
• .range_link: si está presente, indica que la entrada del usuario contiene un rango de números. El valor de ubicación del texto que especifica el rango se añade al nombre de enlace. Se proporciona información adicional, incluyendo el rol que cada @sys-number juega en la relación de rango. Por ejemplo, el número de inicio tiene el tipo de rol number_from y el número final tiene el tipo de rol number_to. Para comprobar un valor de rol, puede utilizar la sintaxis @sys-number.role?.type == 'number_from'.

En la tabla siguiente se muestra la información que cada atributo captura de la entrada de usuario.

Consejos sobre el uso de @sys-number

• Si utiliza la entidad @sys-number como una condición nodo y el usuario especifica cero como valor, el valor 0 se reconoce correctamente como un número. Sin embargo, el valor 0 se interpreta como un valor null para la condición, lo que da como resultado que el nodo no se esté procesando. Para comprobar los números de forma que se haga un tratamiento correcto de los ceros, utilice también la expresión @sys-number == 0 en la condición del nodo. La expresión completa a utilizar es @sys-number OR @sys-number == 0.

• Si utiliza @sys-number para comparar valores numéricos en una condición, asegúrese de incluir por separado una comprobación de la presencia del propio número. Si no se encuentra ningún número, @sys-number se evalúa como nulo. La comparación se puede evaluar como true aunque no haya ningún número.

  Por ejemplo, no utilice @sys-number<4 únicamente porque, si no se encuentra ningún número, @sys-number se evalúa como null (nulo). Puesto que el valor nulo es menor que 4, la condición se evalúa como verdadera, aunque no haya ningún número presente.

  En su lugar, utilice (@sys-number OR @sys-number == 0) AND @sys-number < 4. Si no hay ningún número, la primera condición se evalúa como false. Como resultado, toda la condición se evalúa como false.

Para obtener más información sobre el proceso de valores numéricos, consulte la Referencia del método Numbers.

Formatos reconocidos

• 15 %
• 10 percent (10 por ciento)

Atributos

• .literal: frase exacta en la entrada que se interpreta como un porcentaje.
• .location: valores de elementos de índice de la primera y última letras de la serie de texto que se interpreta como una mención de porcentaje.
• .numeric_value: valor numérico canónico como entero o doble
• .range_link: si está presente, indica que la entrada del usuario contiene un rango, como, por ejemplo, from 2 to 3 percent (de 2 a 3 por ciento). El valor de ubicación del texto que especifica el rango se añade al nombre de enlace. Se proporciona información adicional, incluyendo el rol que cada @sys-percentage juega en la relación de rango. Por ejemplo, el número de inicio tiene el tipo de rol number_from y el número final tiene el tipo de rol number_to. Para comprobar un valor de rol, puede utilizar la sintaxis @sys-percentage.role?.type == 'number_from'.

En la tabla siguiente se muestra la información que cada atributo captura de la entrada de usuario.

Consejos sobre el uso de @sys-percentage

• Si utiliza la entidad @sys-percentage como condición de nodo y el usuario especifica 0% como valor, el valor se reconoce como un porcentaje correctamente, pero la condición se evalúa en el número cero, no en el porcentaje 0 %. Como resultado, el null en la condición se evalúa como falso y el nodo no se procesa. Para comprobar los porcentajes de forma que se haga un tratamiento correcto de aquellos que sean cero, en su lugar utilice la expresión @sys-percentage OR @sys-percentage == 0 en la condición del nodo.

• Si especifica un valor como 1-2%, los valores 1% y 2% se devuelven como entidades del sistema.