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 muestra 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 números enteros, pero también pueden extraer valores más complicados de la entrada del usuario mediante 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”, se generará 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, se muestran las entidades coincidentes junto con el valor que han identificado a partir de 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 El desplazamiento inicial de este valor de entidad ranurado comienza en 0.
endOffset Desplazamiento final de este valor de entidad ranurado a partir de 0.
originalString La cadena original que se extrajo 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 heredadas, 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
ADDRESS Ciudad, número de la casa y calle

Esta entidad es solo en 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 de $ 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 se resuelve en 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 a. m. 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 según las reglas de resolución de tiempo. Debido a 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 semanal/una vez por semana, donde P es el desigador 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)
    • guion (-)
ragnar.smith@example.com    
LOCATION Extrae ciudades, estados y países de la entrada del usuario.
  • Redwood City
  • AC
  • EE. UU.
  • 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 la configuración regional (agrupación de miles por paradas completas, comas, espacios, etc.).

  • 1st

  • primer

  • 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–5555

  • 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

Existen muchas formas en las que la aptitud puede necesitar obtener la entrada de fecha y hora. 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 qué información recopilar. En la siguiente tabla se muestra qué subtipo utilizar para cada escenario posible y enlaces a información sobre los atributos de cada subtipo.

Caso Subtipo DATE_TIME Referencia
Una fecha. Fecha. Atributos de Subtipo DATE
Un momento. Hora Atributos de subtipo TIME
Una fecha y una hora. Date Time Atributos de subtipo DATETIME
Lapso de tiempo. Por ejemplo, 1 hora o 4 días. Duración Atributos de subtipo de DURATION
Ocurrencia única de un período definido por una fecha de inicio y finalización o una fecha y hora de inicio y finalización. Intervalo Atributos de Subtipo INTERVAL
Período recurrente regular definido por, por ejemplo, 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 las entidades del sistema DATE, TIME, DURATION y SET, que están 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 admitirá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 Resolve Entity y Resolve Declarative Entity.

Nota

Si utiliza los subtipos Date, Time y Duration como entidades autónomas de un flujo de diálogo basado en YAML, especifique el subtipo utilizando 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 de DATE_TIME se representan como ISO 8601. Para obtener una salida fácil de recordar, 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", 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 ranurada no representa una fecha específica (es decir, es una fecha móvil, como el 4 de julio), 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 de 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", 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 que se califica con el nombre de un mes, como julio en "cada primer lunes de julio", representa el cualificador especificado explícitamente ("M" para el 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 "every Monday", 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 "every Monday of 2023", representa el valor de año especificado explícitamente.

A continuación, se muestra un ejemplo de la respuesta 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 acerca de 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.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 Atributos de subtipo de FECHA.
entityName Cadena DATE_TIME
subType Cadena DATETIME
time TIME Este objeto contiene los atributos descritos en TIME Subtype Attributes.

A continuación, se muestra un ejemplo de la respuesta 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 de DURATION

El subtipo DURATION contiene estos atributos sobre una duración de día u hora, 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 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 definido por una fecha y hora de inicio y finalización, o 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 Atributos de subtipo de FECHA.

Se incluye para los tipos de campo Fecha y Hora y Solo fecha.
endTime TIME Este objeto contiene los atributos descritos en TIME Subtype Attributes.

Se incluye para los tipos de campo Solo fecha y hora.
entityName Cadena DATE_TIME
startDate FECHA Este objeto contiene los atributos descritos en Atributos de subtipo de FECHA.

Se incluye para los tipos de campo Fecha y Hora y Solo fecha.
startTime TIME Este objeto contiene los atributos descritos en TIME Subtype Attributes.

Se incluye para los tipos de campo Solo fecha y 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 Fecha y hora:

          "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 periódico regular:

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

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

Se incluye para el tipo de campo Solo fecha.
startDateTime DATETIME Este objeto contiene los atributos descritos en DATETIME Subtype Attributes.

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 campo Fecha y hora.
startInterval INTERVAL Este objeto contiene los atributos descritos en Atributos de Subtipo INTERVAL.
startTime TIME Este objeto contiene los atributos descritos en TIME Subtype Attributes.

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

A continuación, se muestra un ejemplo de la respuesta NLU para el subtipo RECURRING con el tipo de campo 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"
  • "Crear un informe de gastos para el 7/11"
  • "Crear 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 tiempo en el pasado. Para garantizar que los subtipos de fecha y hora de la entidad DATE_TIME puedan resolver entradas ambiguas como pasado, presente 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 (fallo de validación) 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 muestra la descripción de 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 asociada a la misma intención, actualice a la versión 21.12 para asegurarse de que las reglas de resolución de ambigüedad específicas de cada referencia de entidad se gestionen por separado y no se sobrescriban con las reglas definidas para una entidad resuelta anteriormente.

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 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 como 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.
Futuras 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.
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 se trata de un miércoles, es decir).

Reglas de resolución para coincidencias con el subtipo Time

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 a. m." y la hora actual es 10:00 a. m., la hora se resuelve como 9:00 a. m. hoy.
  • Si la expresión incluye "9 pm" y la hora actual es 10:00 am, la hora se resuelve como 9:00 pm de 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.
Futuras 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 10:00 a. m., la hora se resuelve como 9:00 a. m.
  • Si la expresión incluye "9 pm" y la hora actual es 10:00 am, la hora se resuelve como 9 pm 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 cercana 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 10:00 a. m., la hora se resuelve como hoy 9:00 a. m.
  • Si la expresión incluye "9 pm" y la hora actual es 10:00 am, la hora se resuelve como 9:00 pm 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. ayer.
Por defecto Resuelve la entrada mediante el método utilizado en las versiones anteriores a la 21.06 de Oracle Digital Assistant.
  • Si la expresión incluye es "9 a. m." y la hora actual es 10 a. m., la hora se resuelve como 9 a. m. 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 am" y la hora actual es 2 pm, la hora se resuelve como 1 am mañana.

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 muestra la descripción de currency-entity-customization.png
Descripción de la ilustración currency-entity-customization.png

En función de la entidad, esta opción tiene diferentes aplicaciones:
  • DATE se resuelve en el formato específico de la configuración regional: puede resolver 11/7 como 7 de noviembre para en-US o 11 de julio para en-AU, por ejemplo. Para 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 utilizado 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 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 para 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 con el formato de fecha por defecto seleccionado.
Para esta configuración regional... Esta entrada... ... Se resuelve como... Formato (secuencia de fecha y mes)
Estados Unidos (en_US) 11/7 7 de noviembre de MONTH_DAY
Gran Bretaña (en_GB) 11/7 Julio de 11 DAY_MONTH
Canadá - Inglés (en_CA) 11/7 7 de noviembre de MONTH_DAY
Canadá - Francés (fr_CA) 11/7 7 de noviembre de 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 de MONTH_DAY
Árabe (ar_AR) 11/7 7 de noviembre de 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 de MONTH_DAY
Japón (ja_JP) 11/7 7 de noviembre de MONTH_DAY

Resolución de moneda basada en configuración regional

Para esta configuración regional... Esta entrada... ... Se resuelve como (ambigüedad de dólar) Esta entrada... ... Se resuelve como (yen ambigüedad)
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 20.0 AUD 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 configuración regional

Cuando se desactiva Considerar configuración regional de usuario final, el formato numérico se define 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