Documentación de Oracle Cloud Infrastructure

Entidades incorporadas

Proporcionamos entidades que identifican información de objetivos a partir de las entradas del usuario, como la hora, la fecha y las direcciones.


A continuación, se incluye la Descripción de system-entities-01.png
Descripción de la ilustración system-entities-01.png

Estas entidades incorporadas extraen valores primitivos como cadenas y enteros, pero también pueden extraer valores más complicados de la entrada del usuario utilizando grupos de propiedades.

Nota

Cuando defina una variable como una entidad en un flujo de diálogo basado en YAML, asegúrese de que coincida exactamente con el nombre de la entidad y las letras. Por ejemplo, si introduce confirm: "YESNO", en lugar de confirm: “YES_NO”, aparecerá un error de validación.

Entidades Incorporadas y sus Propiedades

Las entidades extraen contenido utilizando propiedades, cada una de las cuales reconoce un valor específico. Puede ver estas propiedades en la salida de JSON que devuelve el motor de NLU. En esta salida, las entidades coincidentes se muestran junto con el valor que han identificado en la entrada del usuario. En la definición del flujo de diálogo, puede utilizar estas propiedades para aislar una faceta concreta de un valor de entidad. Aunque cada entidad tiene sus propiedades específicas, todas las entidades tienen las siguientes propiedades:
Propiedad Descripción
beginOffset Desplazamiento inicial de este valor de entidad ranurado que comienza en 0.
endOffset Desplazamiento final de este valor de entidad ranurado que comienza en 0.
originalString Cadena original extraída de la consulta para este espacio de entidad o la respuesta a la petición de datos.
Nota

Las entidades DATE, TIME y DURATION están en desuso en la versión 22.08. Estas entidades no están disponibles para las aptitudes creadas en esta versión de la plataforma. En su lugar, utilizan la entidad DATE_TIME. Las aptitudes existentes actualizadas a la versión 22.08 seguirán admitiendo estas entidades del sistema heredado, aunque puede haber algunos cambios de comportamiento.
Nombre de la Entidad Contenido extraído Ejemplos Propiedades (con referencia en expresiones de valor) Ejemplo de respuesta del motor de consulta numérica
DIRECCIÓN Ciudad, número de la casa y calle

Esta entidad es de solo inglés.

 500 Smith Road, Smithville

  • city

  • houseNumber

  • road 

{
"road": "smith road",
"city": "smithville",
"entityName": "ADDRESS",
"houseNumber": "500",
"originalString": "500 Smith Road, Smithville"
}
MONEDA Representaciones de dinero. Puede desambiguar las monedas $ y ¥ por la configuración regional detectada del usuario.

  • $67

  • 75 dólares

  • amount

  • currency

  • totalCurrency

"CURRENCY": [ { "amount": 550, "currency": "usd", "totalCurrency": "550.0 usd", "entityName": "CURRENCY" } ]
FECHA Fecha absoluta o relativa.

Esta entidad está en desuso en la versión 22.08 y no está disponible para las aptitudes creadas en esta versión de la plataforma. Para las aptitudes creadas con versiones anteriores, considere el uso de la entidad DATE_TIME en su lugar.

Nota: si el usuario introduce el nombre de un día, pero no proporciona ningún otro contexto temporal, el sistema lo considera una fecha futura. Por ejemplo, considera que el miércoles de la siguiente entrada se refiere al próximo miércoles, no al miércoles actual o al anterior.

  • Resérvame una entrada para el miércoles.

  • Quiero archivar un informe de gastos para el miércoles.

Puede sustituir este comportamiento aplicando una regla de resolución de ambigüedad. Mientras que la entidad DATE resuelve el formato de varias configuraciones regionales soportadas, puede optar por ignorar el formato de la configuración regional detectada e imponer un formato por defecto y un tiempo (futuro, pasado, más cercano, etc.) aplicando una regla de resolución de ambigüedad.

  • 9 de noviembre de 2016

  • Hoy

 date 
  {
          "entityName": "Meeting",
          "DATE_TIME": [
            {
              "originalString": "Monday, October 16th",
              "bagItem": "Meeting:DateTime",
              "subType": "DATE",
              "timeZone": "UTC",
              "movableDateValue": "--10-16",
              "relativeRepresentation": "--10-16",
              "entityName": "DATE_TIME",
              "value": "2022-10-16"
            }
          ]
        }
      ]
DATE_TIME Extrae información relacionada con el tiempo mediante los siguientes subtipos: una fecha, una hora, una fecha y hora, un evento recurrente, un intervalo o una duración.
  • Fecha: 1 de enero de 2023
  • Hora: 10am
  • Fecha y hora: 1 de enero de 2023 a las 10 a.m.
  • Intervalo: 1 de enero de 2023 a partir de las 10 am durante 2 horas
  • Duración: 2 horas
   Para "Programar una reunión para cada martes de 10:00 am a 1 pm a partir del 23 de enero de 2022 y hasta el 23 de febrero":
   "entityMatches": {
      "Meeting": [
        {
          "entityName": "Meeting",
          "DATE_TIME": [
            {
              "originalString": "February 23",
              "bagItem": "Meeting:DateTime",
              "subType": "DATE",
              "timeZone": "UTC",
              "role": "end",
              "movableDateValue": "--02-23",
              "relativeRepresentation": "--02-23",
              "entityName": "DATE_TIME",
              "value": "2023-02-23"
            },
            {
              "originalString": "January 23, 2022",
              "bagItem": "Meeting:DateTime",
              "subType": "INTERVAL",
              "startDate": {
                "originalString": "January 23, 2022",
                "subType": "DATE",
                "timeZone": "UTC",
                "entityName": "DATE_TIME",
                "value": "2022-01-23"
              },
              "entityName": "DATE_TIME"
            },
            {
              "originalString": "every Tuesday from 10:00 am to 1 pm",
              "bagItem": "Meeting:DateTime",
              "subType": "RECURRING",
              "timeZone": "UTC",
              "recurrenceFrequency": {
                "originalString": "every Tuesday from 10:00 am to 1 pm",
                "subType": "DURATION",
                "timeZone": "UTC",
                "entityName": "DATE_TIME",
                "value": "P1W"
              },
              "startInterval": {
                "originalString": "Tuesday from 10:00 am to 1 pm",
                "subType": "INTERVAL",
                "timeZone": "UTC",
                "startDate": {
                  "originalString": "Tuesday",
                  "subType": "DATE",
                  "timeZone": "UTC",
                  "weekday": "TU",
                  "relativeReference": "weekday",
                  "entityName": "DATE_TIME",
                  "value": "2022-10-18"
                },
                "startTime": {
                  "originalString": "10:00 am",
                  "subType": "TIME",
                  "timeZone": "UTC",
                  "entityName": "DATE_TIME",
                  "value": "10:00:00"
                },
                "endTime": {
                  "originalString": "1 pm",
                  "subType": "TIME",
                  "timeZone": "UTC",
                  "entityName": "DATE_TIME",
                  "value": "13:00:00"
                },
                "entityName": "DATE_TIME"
              },
              "entityName": "DATE_TIME"
            }
          ]
        }
      ]
    }
  • Interpretación del 23 de febrero por las reglas de resolución de tiempo. Dado que el caso de uso es para programar una reunión, la fecha siempre se interpretará como prospectiva. 
    "movableDateValue": "--02-23",
              "relativeRepresentation": "--02-23"
  • "value": "P1W": representación estándar de intercambio ISO 8601 de semanal/una vez a la semana, donde P es el desecador de duración y W es el designador de semana.
DURATION Cantidad de tiempo entre los dos extremos de un intervalo de tiempo

Esta entidad está en desuso en la versión 22.08 y no está disponible para las aptitudes creadas en esta versión de la plataforma. Para las aptitudes creadas con versiones anteriores, considere el uso de la entidad DATE_TIME en su lugar.

  • 4 años

  • dos semanas

  • startDate

  • endDate

[ { "originalString": "2 hours", "bagItem": "Meeting:DateTime", "subType": "DURATION", "timeZone": "UTC", "entityName": "DATE_TIME", "value": "PT2H" } ] } ]
Correo electrónico Dirección de correo electrónico. El sistema de consulta numérica puede reconocer las direcciones de correo electrónico que incluyen una combinación de los siguientes elementos:
  • parte anterior al símbolo de arroba (@):
    • letras mayúsculas y minúsculas del alfabeto latino (A-Z y a-z)
    • dígitos (0-9)
    • los siguientes caracteres imprimibles: !#$%&'*+-/=?^_`{}~
    • punto (.)
  • parte posterior al símbolo de arroba (@):
    • letras mayúsculas y minúsculas del alfabeto latino (A-Z y a-z)
    • dígitos (0-9)
    • guión (-)
ragnar.smith@example.com    
UBICACIÓN Extrae ciudades, estados y países de la entrada del usuario.
  • Redwood City
  • AC
  • USA
  • city
  • state
  • country
"LOCATION": [ { "originalString": "Redwood City, CA, USA", "name": "redwood city, ca, usa", "country": "usa", "state": "ca", "city": "redwood city", "entityName": "LOCATION" } ]
NÚMERO Parea los números ordinales y los cardinales. Puede resolver una entidad como el formato específico de configuración regional (agrupación de miles por paradas completas, comas, espacios, etc.).

  • 1st

  • primero

  • 1

  • uno

    
PERSON Reconoce una cadena como el nombre de una persona.

La entidad PERSON no puede coincidir con los nombres que también sean ubicaciones (por ejemplo, Virginia North).

Para expandir la entidad PERSON para que coincida siempre con las personas de su organización, puede asociarla a una entidad de lista de valores.
  • John J. Jones
  • Ashok Kumar
  • Gabriele D'Annunzio
  • Jones, David
  • Cantiflas
  • Zhang San
  • Virginia Jones
 name "PERSON": [ { "originalString": "John J. Johnson", "name": "john j. johnson", "entityName": "PERSON" } ]
NÚMERO DE TELÉFONO Número de teléfono: el motor de consulta numérica reconoce los números de teléfono que tienen siete dígitos o más (no puede reconocer los números de teléfono con menos dígitos). Todos los códigos de país deben tener como prefijo un signo más (+), excepto en el caso de los Estados Unidos de América (donde el signo más es opcional). Las distintas partes del número de teléfono (el código de área, el prefijo y el número de línea) se pueden separar con puntos (.), guiones (-) o espacios. Si se han introducido varios números de teléfono en la entrada del usuario, el motor de consulta numérica puede reconocerlos si están separados por comas. No puede reconocer distintos números de teléfono si están separados por puntos, guiones o espacios.

  • (650)-555-55555

  • 16.505.555.555

  • +61,3

  • phoneNumber

  • completeNumber

{ "phone_number":"(650)-555-5555", "complete_number":"(650)-555-5555", "entityName":"PHONE_NUMBER" }
TIME Hora específica

Esta entidad está en desuso en la versión 22.08 y no está disponible para las aptitudes creadas en esta versión de la plataforma. Para las aptitudes creadas con versiones anteriores, considere el uso de la entidad DATE_TIME en su lugar.

En algunos casos, por ejemplo, cuando la entrada es ambigua, puede que necesite que la entidad TIME resuelva la entrada de forma consistente como una hora pasada o futura, o que se aproxime a la hora más cercana. Para ello, aplique una regla de resolución de ambigüedad.

2:30 pm

  • hrs

  • mins

  • secs

  • "hourFormat":"PM"

"startTime": { "date": 1613653200000, "zoneOffset": "0", "endOffset": 4, "mins": 0, "zone": "UTC", "entityName": "TIME", "secs": 0, "hrs": 1, "originalString": "1 pm", "type": "TIME", "hourFormat": "PM", "beginOffset": 0 }
URL Un URL: esta entidad puede extraer direcciones IPv4, URL web, enlaces profundos (http://example.com/path/page), rutas de acceso de archivo y URI de tipo mailto. Si la entrada de usuario especifica las credenciales de conexión, también debe incluir el protocolo. De lo contrario, el protocolo no es necesario. http://example.com

  • protocol

  • domain

  • fullPath

{"protocol":"http","domain":"example.com",}
SÍ_NO Detecta un "Sí" o un "No".     "YES_NO": [ { "beginOffset": 0, "endOffset": 4, "originalString": "Yeah", "yesno": "YES", "entityName": "YES_NO", "type": "YES_NO" } ]

Entidad DATE_TIME

Puede que la aptitud necesite obtener la entrada de fecha y hora de muchas formas. Por ejemplo, puede que necesite una fecha u hora simple, una fecha y una hora, o un período único o recurrente. Puede utilizar la entidad DATE_TIME para recopilar información para todos estos escenarios.

Con la entidad DATE_TIME, puede seleccionar un subtipo específico para definir la información que desea recopilar. La siguiente tabla muestra qué subtipo utilizar para cada escenario posible y enlaces a información sobre los atributos de cada subtipo.

Caso DATE_TIME Subtipo Referencia
Una fecha. Fecha. Atributos de Subtipo DATE
Un tiempo. Hora Atributos de subtipo TIME
Una fecha y una hora. Date Time Atributos de subtipo DATETIME
Período de tiempo. Por ejemplo, 1 hora o 4 días. Duración Atributos de subtipo DURATION
Ocurrencia única de un período definido por una fecha de inicio y de fin o por una fecha y hora de inicio y de fin. Intervalo Atributos de Subtipo INTERVAL
Período recurrente regular definido, por ejemplo, por el inicio y el final del primer período, el intervalo entre los períodos recurrentes y cuando los períodos dejan de ser recurrentes. Recurrente Atributos de subtipo RECURRING
Nota

La entidad DATE_TIME sustituye a las entidades del sistema DATE, TIME, DURATION y SET, que se han quedado en desuso y no están disponibles en las aptitudes creadas en la versión 22.08 y posteriores. Las aptitudes existentes actualizadas a la versión 22.08 soportarán estas entidades del sistema en desuso, aunque puede haber algunos cambios de comportamiento.
Puede utilizar los subtipos Fecha, Hora y Duración como entidades independientes en el flujo de diálogo (donde declara variables independientes para cada una), pero solo puede utilizar los subtipos Intervalo y Recurrente incorporándolos en una entidad de bolsa compuesta.
Nota

Recomendamos que todos los subtipos DATE_TIME se gestionen dentro de una entidad de bolsa compuesta.

En el modo de diálogo visual, haga referencia a los subtipos DATE_TIME mediante los estados Resolver entidad y Resolver entidad declarativa.

Nota

Si utiliza los subtipos Date, Time y Duration como entidades autónomas en un flujo de diálogo basado en YAML, especifique el subtipo mediante la notación de puntos: DATE_TIME.DATE, DATE_TIME.TIME, DATE_TIME.DURATION y, para SET, DATE_TIME.RECURRING. Por ejemplo:
context:
  variables:
    iResult: "nlpresult"
    Startdate: "DATE_TIME.DATE"
    duration: "DATE_TIME.DURATION"
En el nodo states, haga referencia a estas variables mediante un componente System.ResolveEntities.
Los valores DATE_TIME se representan como ISO 8601. Para una salida fácil de usar, utilice Apache FreeMarker .xs incorporado. Por ejemplo, el subtipo Time se extrae mediante .value.value?time.xs?string['hh:mm a'] en la siguiente referencia de grupo de recursos:
${rb('pizzaDeliveryMessage','time',deliveryTime.value.value?time.xs?string['hh:mm a'])}
El primer value obtiene el contenido de la variable como un objeto. El segundo value es un atributo del objeto DATE_TIME que contiene el valor de tiempo.

Atributos para cada subtipo DATE_TIME

Estos son los atributos de cada subtipo DATE_TIME.

Tenga en cuenta que, al igual que cualquier otra entidad del sistema, los subtipos también incluyen las propiedades beginOffset, endOffset y originalString.

Atributos de Subtipo DATE

El subtipo DATE contiene estos atributos sobre una fecha específica:

Atributo Tipo Explicación
entityName Cadena DATE_TIME
month Entero

Cuando DATE es un atributo del subtipo RECURRING y la cadena original incluye el nombre de un mes, como "cada lunes de julio", esto representa la representación numérica ("7" en este ejemplo) del valor de mes especificado explícitamente.
movableDateValue Cadena

Cuando DATE es un atributo de RECURRING y la fecha de ranura no representa una fecha específica (es decir, es una fecha móvil como el 4 de julio), esto representa el valor de fecha móvil especificado explícitamente que utiliza el atributo DATE del subtipo RECURRING para diferenciar entre la fecha móvil resuelta y la fecha no móvil resuelta. Por ejemplo, si la fecha con espacio es el 4 de julio, este valor es --07-04.

ordinal Entero

Cuando DATE es un atributo del subtipo RECURRING y la cadena original especifica un valor ordinal, como el primero en "cada primer lunes", esto representa el valor numérico del ordinal (en este ejemplo, "1").
ordinalReference Enumeración

Cuando DATE es un atributo del subtipo RECURRING y la cadena original incluye un ordinal cualificado por el nombre de un mes, como julio en "cada primer lunes de julio", esto representa el calificador especificado explícitamente ('M' para mes).
subType Cadena DATE
timezone Cadena Desfase de zona horaria. Por ejemplo: +07:00.
type Cadena DATE_TIME
value Cadena Valor resuelto en formato ISO 8601. Por ejemplo 2022-08-05.
weekday Enumeración

Cuando DATE es un atributo del subtipo RECURRING y la cadena original incluye el nombre de un día, como "cada lunes", esto representa el valor de día de la semana especificado explícitamente con el formato iCalendar, como MO, TU y WE.
year Entero

Cuando DATE es un atributo del subtipo RECURRING y la cadena original incluye el año, como "cada lunes de 2023", esto representa el valor de año especificado explícitamente.

A continuación, se muestra un ejemplo de la respuesta de NLU para el subtipo DATE:

          "aDate": {
            "endOffset": 8,
            "entityName": "DATE_TIME",
            "timeZone": "-10:00",
            "originalString": "tomorrow",
            "subType": "DATE",
            "type": "DATE_TIME",
            "value": "2022-09-07",
            "beginOffset": 0
          }

Atributos de subtipo TIME

El subtipo TIME contiene estos atributos sobre una hora específica:

Atributo Tipo Explicación
entityName Cadena DATE_TIME
subType Cadena TIME
timezone Cadena Desfase de zona horaria. Por ejemplo: +07:00.
type Cadena DATE_TIME
value Cadena Valor resuelto en formato ISO 8601. Por ejemplo 12:00:00.

A continuación, se muestra un ejemplo de la respuesta de NLU para la entidad TIME:

          "aTime": {
            "endOffset": 4,
            "entityName": "DATE_TIME",
            "timeZone": "-10:00",
            "originalString": "2 pm",
            "subType": "TIME",
            "type": "DATE_TIME",
            "value": "14:00:00",
            "beginOffset": 0
          }

Atributos de subtipo DATETIME

El subtipo DATETIME contiene estos atributos sobre una fecha y hora específicas:

Atributo Tipo Explicación
date FECHA Este objeto contiene los atributos descritos en DATE Subtype Attributes.
entityName Cadena DATE_TIME
subType Cadena DATETIME
time TIME Este objeto contiene los atributos descritos en Atributos de Subtipo TIME.

A continuación, se muestra un ejemplo de la respuesta de NLU para el subtipo DATETIME:


          "aDateAndTime": {
            "date": {
              "endOffset": 5,
              "entityName": "DATE_TIME",
              "timeZone": "-10:00",
              "originalString": "today",
              "subType": "DATE",
              "type": "DATE_TIME",
              "value": "2022-09-06",
              "beginOffset": 0
            },
            "entityName": "DATE_TIME",
            "subType": "DATETIME",
            "time": {
              "endOffset": 13,
              "entityName": "DATE_TIME",
              "timeZone": "-10:00",
              "originalString": "noon",
              "subType": "TIME",
              "type": "DATE_TIME",
              "value": "12:00:00",
              "beginOffset": 9
            }
          }

Atributos de subtipo DURATION

El subtipo DURATION contiene estos atributos sobre un día o una duración de tiempo, como 1 semana:

Atributo Tipo Explicación
entityName Cadena DATE_TIME
subType Cadena DURATION
timezone Cadena Desfase de zona horaria. Por ejemplo: +07:00.
type Cadena DATE_TIME
value Cadena Duración en formato ISO 8601. Ejemplos: PT1H durante 1 hora,P4D durante 4 días, P1W durante 1 semana, P2M durante 2 meses.

A continuación, se muestra un ejemplo de la respuesta de NLU para el subtipo DURATION:

          "aDuration": {
            "endOffset": 7,
            "entityName": "DATE_TIME",
            "timeZone": "-10:00",
            "originalString": "3 hours",
            "subType": "DURATION",
            "type": "DATE_TIME",
            "value": "PT3H",
            "beginOffset": 0
          }

Atributos de Subtipo INTERVAL

El subtipo INTERVAL contiene estos atributos sobre un período que se define por una fecha y hora de inicio y finalización, o se define por una fecha, hora de inicio y duración, como 2 horas.

Atributo Tipo Explicación
duration ENTIDAD Este objeto contiene los atributos descritos en Atributos de Subtipo DURATION.
endDate FECHA Este objeto contiene los atributos descritos en DATE Subtype Attributes.

Se incluye para los tipos de petición de datos Fecha y Hora y Solo fecha.
endTime TIME Este objeto contiene los atributos descritos en Atributos de Subtipo TIME.

Se incluye para los tipos de petición de datos Fecha, Hora y Solo hora.
entityName Cadena DATE_TIME
startDate FECHA Este objeto contiene los atributos descritos en DATE Subtype Attributes.

Se incluye para los tipos de petición de datos Fecha y Hora y Solo fecha.
startTime TIME Este objeto contiene los atributos descritos en Atributos de Subtipo TIME.

Se incluye para los tipos de petición de datos Fecha, Hora y Solo hora.
subType Cadena INTERVAL

A continuación, se muestra un ejemplo de la respuesta de NLU para la entidad INTERVAL con el tipo de petición de datos Date and Time:

          "anInterval": {
            "duration": {
              "entityName": "DATE_TIME",
              "subType": "DURATION",
              "value": "P1D"
            },
            "endDate": {
              "endOffset": 8,
              "entityName": "DATE_TIME",
              "timeZone": "-10:00",
              "originalString": "tomorrow",
              "subType": "DATE",
              "type": "DATE_TIME",
              "value": "2022-09-07",
              "beginOffset": 0
            },
            "entityName": "DATE_TIME",
            "subType": "INTERVAL",
            "startTime": {
              "endOffset": 4,
              "entityName": "DATE_TIME",
              "timeZone": "-10:00",
              "originalString": "noon",
              "subType": "TIME",
              "type": "DATE_TIME",
              "value": "12:00:00",
              "beginOffset": 0
            },
            "endTime": {
              "endOffset": 4,
              "entityName": "DATE_TIME",
              "timeZone": "-10:00",
              "originalString": "noon",
              "subType": "TIME",
              "type": "DATE_TIME",
              "value": "12:00:00",
              "beginOffset": 0
            },
            "startDate": {
              "endOffset": 5,
              "entityName": "DATE_TIME",
              "timeZone": "-10:00",
              "originalString": "today",
              "subType": "DATE",
              "type": "DATE_TIME",
              "value": "2022-09-06",
              "beginOffset": 0
            }
          }

Atributos de subtipo RECURRING

El subtipo RECURRING contiene estos atributos sobre un período recurrente regular:

Atributo Tipo Explicación
entityName Cadena DATE_TIME
recurrenceDates Matriz de fechas Se incluye cuando se proporcionan varias fechas recurrentes. Este objeto contiene una matriz de objetos DATE con los atributos descritos en DATE Subtype Attributes.
recurrenceFrequency DURATION Este objeto contiene los atributos descritos en Atributos de Subtipo DURATION.
recurrenceTimes Matriz de tiempo Se incluye cuando se dan varias horas recurrentes. Este objeto contiene una matriz de objetos TIME con los atributos descritos en Atributos de Subtipo TIME.
recurrenceUntil INTERVALO Especifica los límites de la repetición. Normalmente, sólo se especifica la fecha de fin. Este objeto contiene los atributos descritos en Atributos de Subtipo INTERVAL.
startDate FECHA Este objeto contiene los atributos descritos en DATE Subtype Attributes.

Tenga en cuenta que para las entidades RECURRING, el objeto DATE puede incluir los atributos month. movevableDateValue, ordinal, ordinalReference, weekday y year.

Incluido para el tipo de campo Solo fecha.
startDateTime DATETIME Este objeto contiene los atributos descritos en Atributos de Subtipo DATETIME.

Tenga en cuenta que para las entidades RECURRING, el subobjeto DATE de DATETIME puede incluir los atributos month. movevableDateValue, ordinal, ordinalReference, weekday y year.

Se incluye para el tipo de petición de datos Fecha y hora.
startInterval INTERVALO Este objeto contiene los atributos descritos en Atributos de Subtipo INTERVAL.
startTime TIME Este objeto contiene los atributos descritos en Atributos de Subtipo TIME.

Incluido para el tipo de campo Solo tiempo.
subType Cadena RECURRING

A continuación, se muestra un ejemplo de la respuesta de NLU para el subtipo RECURRING con el tipo de petición de datos Fecha y hora:

          "aRecurringPeriod": {
            "startInterval": {
              "duration": {
                "entityName": "DATE_TIME",
                "subType": "DURATION",
                "value": "PT1H"
              },
              "endDate": {
                "entityName": "DATE_TIME",
                "timeZone": "-10:00",
                "subType": "DATE",
                "value": "2022-07-28"
              },
              "entityName": "DATE_TIME",
              "subType": "INTERVAL",
              "startTime": {
                "endOffset": 7,
                "entityName": "DATE_TIME",
                "timeZone": "-10:00",
                "originalString": "12 noon",
                "subType": "TIME",
                "bagItem": "Meeting:DateTime",
                "type": "DATE_TIME",
                "value": "12:00:00",
                "beginOffset": 0
              },
              "endTime": {
                "entityName": "DATE_TIME",
                "timeZone": "-10:00",
                "subType": "TIME",
                "value": "13:00:00"
              },
              "startDate": {
                "endOffset": 8,
                "entityName": "DATE_TIME",
                "timeZone": "-10:00",
                "originalString": "tomorrow",
                "subType": "DATE",
                "bagItem": "Meeting:DateTime",
                "type": "DATE_TIME",
                "value": "2022-07-28",
                "beginOffset": 0
              }
            },
            "recurrenceFrequency": {
              "endOffset": 10,
              "entityName": "DATE_TIME",
              "timeZone": "-10:00",
              "originalString": "every week",
              "subType": "DURATION",
              "type": "DATE_TIME",
              "bagItem": "Meeting:DateTime",
              "value": "P1W",
              "beginOffset": 0
            },
            "entityName": "DATE_TIME",
            "subType": "RECURRING",
            "recurrenceUntil": {
              "endDate": {
                "endOffset": 6,
                "entityName": "DATE_TIME",
                "timeZone": "-10:00",
                "originalString": "Sept 1",
                "subType": "DATE",
                "bagItem": "Meeting:DateTime",
                "type": "DATE_TIME",
                "value": "2022-09-01",
                "beginOffset": 0
              },
              "entityName": "DATE_TIME",
              "subType": "INTERVAL"
            }
          }

Reglas de resolución de ambigüedad para coincidencias de fecha y hora

Los usuarios pueden introducir fechas parciales en las que el tiempo esté implícito. Por ejemplo:
  • "Programar una reunión para el lunes"
  • "Creación de un informe de gastos para el 7/11"
  • "Creación de un informe de gastos para el día 11"
Algunas situaciones, como programar una reunión, implican un tiempo futuro. Otros, como la creación de un informe de gastos, hacen referencia a algún momento del pasado. Para garantizar que los subtipos de fecha y hora de la entidad DATE_TIME puedan resolver entradas ambiguas como pasadas, presentes o como la aproximación más cercana, puede aplicar reglas de resolución de ambigüedad. Para definir el contexto temporal para la resolución de tiempo, por ejemplo, haga clic en la entidad DATE_TIME y, a continuación, aplique una regla.
Nota

Las reglas de resolución de ambigüedad no validan la entrada del usuario. Puede validar la entrada del usuario con un validador personalizado que utilice Apache FreeMarker (que no se recomienda) o en un manejador de eventos de entidad (que se recomienda). Este validador devuelve false (la validación falla) si se proporciona una fecha pasada para un caso de uso prospectivo (por ejemplo, un programador de reuniones). Para un caso de uso retrospectivo, como los informes de gastos, el validador devuelve false si el usuario introduce una fecha futura.

A continuación se describe time-entity-configuration.png
Descripción de la ilustración time-entity-configuration.png

Nota

Si hace referencia a la misma entidad con dos o más elementos dentro de la misma bolsa compuesta, o si dos o más bolsas compuestas hacen referencia a la misma entidad y también lo hacen asociado a la misma intención, actualice a la versión 21.12 para garantizar que las reglas de resolución de ambigüedad específicas de cada referencia de entidad se manejen por separado y no se sobrescriban con las reglas definidas para una entidad resuelta previamente.

Reglas de resolución para coincidencias con el subtipo de fecha

La fecha se resuelve en la fecha UTC, no en la fecha del servidor ni en la fecha del explorador. Por ejemplo, "hoy" pronunciado a las 8 pm del 8 de julio desde la Zona Horaria Hawai-Aleutiana (UTC-10:00) se resuelve el 9 de julio.
Regla Funcionamiento Ejemplos
Anterior Resuelve la entrada ambigua como el día de la semana más cercano en el pasado.
  • Si la expresión incluye "Lunes" y el día actual también es lunes, "Lunes" se resuelve como hoy.
  • Si la expresión incluye "Lunes" y el día actual es miércoles, el "Lunes" se resuelve como el lunes anterior.
Futuro Resuelve la entrada ambigua como el día más cercano en el futuro
  • Si la expresión incluye "Lunes" y el día actual también es lunes, "Lunes" se resuelve como hoy.
  • Si la expresión incluye "Lunes" y el día actual es Martes, "Lunes" se resuelve como el lunes siguiente.
  • Si la expresión incluye "Martes" y el día actual es lunes, "Martes" se resuelve como este martes.
Más cercano Resuelve la entrada ambigua como el día más cercano.
  • Si la expresión incluye "Lunes" y el día actual también es lunes, el "Lunes" se resuelve como hoy. Si la expresión incluye "Lunes" y el día actual es Martes, "Lunes" se resuelve como ayer.
  • Si la expresión incluye "Lunes" y el día actual es domingo, el "Lunes" se resuelve como mañana.
Valor por Defecto Resuelve la entrada ambigua como una fecha futura. Por ejemplo, si la entrada incluye el miércoles, el día se interpreta como el próximo miércoles, no como el miércoles anterior o el día actual (si es un miércoles, es decir).

Reglas de resolución para coincidencias con el subtipo de tiempo

Regla Funcionamiento Ejemplos
Anterior Resuelve la entrada a la hora más cercana en el pasado en relación con la hora actual en la zona horaria UTC.
  • Si la expresión incluye "9 am" y la hora actual es 10:00 am, la hora se resuelve como 9:00 am hoy.
  • Si la expresión incluye "9 p. m." y la hora actual es 10:00 a. m., la hora se resuelve como 9:00 p. m. ayer.
  • Si la expresión incluye "9" y la hora actual es 10:00 a. m., la hora se resuelve como 9:00 a. m. hoy.
Futuro Resuelve la entrada a la hora más próxima en el futuro en relación con la hora actual en la zona horaria UTC.
  • Si la expresión incluye "9 a. m." y la hora actual es a las 10:00 a. m., la hora se resuelve como 9:00 a. m.
  • Si la expresión incluye "9 p. m." y la hora actual es 10:00 a. m., la hora se resuelve como 9 p. m. hoy.
  • Si la expresión incluye "9" y la hora actual es 10:00 a. m., la hora se resuelve como 9:00 p. m. hoy.
Más cercano Resuelve la entrada como la hora más próxima relativa a la hora actual en la zona horaria UTC.
  • Si la expresión incluye "9 am" y la hora actual es 10:00 am, la hora se resuelve como hoy a las 9:00 am.
  • Si la expresión incluye "9 p. m." y la hora actual es 10:00 a. m., la hora se resuelve como 9:00 p. m. hoy.
  • Si la expresión incluye "9" y la hora actual es 10:00 a. m., la hora se resuelve como 9:00 a. m. hoy.
  • Si la expresión incluye "10:00" y la hora actual es 1:00 a. m., la hora se resuelve como 10:00 p. m. de ayer.
Valor por Defecto Resuelve la entrada por el método utilizado en las versiones anteriores a la 21.06 de Oracle Digital Assistant.
  • Si la expresión que incluye es "9 am" y la hora actual es 10 am, la hora se resuelve como 9 am hoy.
  • Si la expresión incluye "9 pm" y la hora actual es 10 am, la hora se resuelve como 9 pm hoy.
  • Si la expresión incluye "9" y la hora actual es 10 a. m., la hora se resuelve como 9 a. m. hoy.
  • Si la expresión incluye "1:00 a. m." y la hora actual es 2 p. m., la hora se resuelve como 1 a. m.

Resolución de entidad basada en configuración regional

Puede activar las entidades CURRENCY, DATE y NUMBER para que se resuelvan en la configuración regional del usuario activando Considerar configuración regional de usuario final.
A continuación, se incluye la Descripción de currency-entity-customization.png
Descripción de la ilustración divisa-entidad-customization.png

Según la entidad, esta opción tiene diferentes aplicaciones:
  • DATE se resuelve en el formato específico de la configuración regional: se puede resolver 11/7 como 7 de noviembre para en-US o 11 de julio para en-AU, por ejemplo. Para las configuraciones regionales no admitidas, puede aplicar un formato y un contexto temporal, como pasado o futuro.
  • NUMBER se resuelve en el formato numérico específico del país: la coma, el punto o el espacio utilizados para separar grupos de miles y la coma decimal con o sin un espacio delgado que separa la parte fraccional del número. Por ejemplo, el Reino Unido y los Estados Unidos utilizan una coma para separar grupos de miles.
    Nota

    Cuando se desactiva Considerar configuración regional de usuario final, la entidad NUMBER se resuelve como COMMA_DOT (1.000,00).
  • CURRENCY utiliza la configuración regional para resolver una moneda específica de $ o ¥. Cuando no se detecta ninguna configuración regional, puede definir la entrada para que se resuelva como la moneda $ o ¥ definida por la regla de resolución de ambigüedad.
Nota

Si hace referencia a la misma entidad con dos elementos más dentro de la misma bolsa compuesta, o si dos o más bolsas compuestas hacen referencia a la misma entidad y también están asociadas con la misma intención, actualice a la versión 21.12 para asegurarse de que la personalización de la configuración regional específica de cada referencia de entidad se maneje por separado y no se sobrescriba con la configuración regional de una entidad resuelta anteriormente.

Resolución de fecha basada en configuración regional

Cuando no se puede detectar la configuración regional del usuario, la fecha se resuelve como el formato de fecha predeterminado seleccionado.
Para esta configuración regional... Esta entrada... ... Resuelve como... Formato (secuencia de fecha-mes)
Estados Unidos (en_US) 11/7 7 de noviembre MONTH_DAY
Gran Bretaña (en_GB) 11/7 Julio de 11 DAY_MONTH
Canadá - Inglés (en_CA) 11/7 7 de noviembre MONTH_DAY
Canadá (Francés) (fr_CA) 11/7 7 de noviembre MONTH_DAY
Australia (en_AU) 11/7 Julio de 11 DAY_MONTH
México (es_MX) 11/7 Julio de 11 DAY_MONTH
Singapur (zh_SG) 11/7 Julio de 11 DAY_MONTH
Emiratos Árabes Unidos (ar_AE) 11/7 7 de noviembre MONTH_DAY
Árabe (ar_AR) 11/7 7 de noviembre MONTH_DAY
Francia (fr_FR) 11/7 Julio de 11 DAY_MONTH
Países Bajos (nl_NL) 11/7 Julio de 11 DAY_MONTH
Alemania (de_DE) 11/7 Julio de 11 DAY_MONTH
Italia (it_IT) 11/7 Julio de 11 DAY_MONTH
Portugal (pt_PT) 11/7 Julio de 11 DAY_MONTH
España (en_ES) 11/7 Julio de 11 DAY_MONTH
China (zh_CN) 11/7 7 de noviembre MONTH_DAY
Japón (ja_JP) 11/7 7 de noviembre MONTH_DAY

Resolución de moneda basada en configuración regional

Para esta configuración regional... Esta entrada... ... Resuelve como (ambigüedad del dólar) Esta entrada... ... Resuelve como (ambigüedad yen)
Estados Unidos (en_US) 20 dólares 20.0 USD 20 ¥ 20,0 JPY
Gran Bretaña (en_GB) 20 dólares 20.0 USD 20 ¥ 20,0 JPY
Canadá - Inglés (en_CA) 20 dólares 20.0 CAD 20 ¥ 20,0 JPY
Canadá (Francés) (fr_CA) 20 dólares 20.0 CAD 20 ¥ 20,0 JPY
Australia (en_AU) 20 dólares AUD 20,0 20 ¥ 20,0 JPY
México (es_MX) 20 dólares 20,0 MXN 20 ¥ 20,0 CNY
Singapur (zh_SG) 20 dólares 20,0 SGD 20 ¥ 20,0 JPY
Emiratos Árabes Unidos (ar_AE) 20 dólares 20.0 USD 20 ¥ 20,0 JPY
Árabe (ar_AR) 20 dólares 20.0 USD 20 ¥ 20,0 JPY
Francia (fr_FR) 20 dólares 20.0 USD 20 ¥ 20,0 JPY
Países Bajos (nl_NL) 20 dólares 20.0 USD 20 ¥ 20,0 JPY
Alemania (de_DE) 20 dólares 20.0 USD 20 ¥ 20,0 JPY
Italia (it_IT) 20 dólares 20.0 USD 20 ¥ 20,0 JPY
Portugal (pt_PT) 20 dólares 20.0 USD 20 ¥ 20,0 JPY
España (en_ES) 20 dólares 20.0 USD 20 ¥ 20,0 JPY
China (zh_CN) 20 dólares 20.0 USD 20 ¥ 20,0 CNY
Japón (ja_JP) 20 dólares 20.0 USD 20 ¥ 20,0 JPY

Resolución de números basada en la configuración regional

Cuando la opción Considerar configuración regional de usuario final está desactivada, el formato numérico se establece por defecto en COMMA_DOT (1.000,00).
Cuando la configuración regional está activada para... ... El formato reconocido es... Ejemplo
Estados Unidos (en_US) COMMA_DOT 1.000.000
Gran Bretaña (en_GB) COMMA_DOT 1.000.000
Canadá - Inglés (en_CA) COMMA_DOT 1.000.000
Canadá (Francés) (fr_CA) DOT_COMMA 1
Australia (en_AU) COMMA_DOT 1.000.000
México (es_MX) COMMA_DOT 1.000.000
Singapur (zh_SG) COMMA_DOT 1.000.000
Emiratos Árabes Unidos (ar_AE) DOT_COMMA 1
Árabe (ar_AR) DOT_COMMA 1
Francia (fr_FR) SPACE_COMMA 1 0 0
Países Bajos (nl_NL) DOT_COMMA 1
Alemania (de_DE) DOT_COMMA 1
Italia (it_IT) DOT_COMMA 1
Portugal (pt_PT) COMMA_DOT 1.000.000
España (en_ES) DOT_COMMA 1
China (zh_CN) COMMA_DOT 1.000.000
Japón (ja_JP) COMMA_DOT 1.000.000