可识别的格式

• 20 cents
• Five dollars
• $10

属性

• .literal：输入中解释为货币提及项的精确短语。
• .numeric_value：格式为整数或双精度值的规范数字值（以基本单位表示）。
• .location：列出解释为货币提及项的短语的文本字符串中第一个和最后一个字母的索引元素值。
• .unit：货币的基本单位，由三个字母的ISO货币代码表示。 例如，USD 或 EUR。

下表说明了每个属性从用户输入中捕获到的信息。

对于输入 veinte euro （西班牙语为 twenty euro ）或 €1.234,56，@sys-currency 返回以下值：

对于其他支持的语言和国家货币，将返回同样的结果。

@sys-currency 用法提示

如果将 @sys-currency 实体用作节点条件，并且用户将 $0 指定为值，那么该值会正确识别为货币，但该条件会求值为数字零，而不是货币零。 因此，条件中的 null 会求值为 false，并且不会处理节点。 要以正确处理零的方式检查货币值，请改为在节点条件中使用表达式 @sys-currency OR @sys-currency == 0。

有关按语言识别的货币的更多信息，请参阅 货币支持。

可识别的格式

• 星期五
• 今天
• May 8

属性

• .alternatives：在输入可供解释时保存备用日期值。 通常，会返回未来的日期作为 @sys-date 值。 如果存在不确定性，那么会将过去的日期保存为备用日期。 例如，对于输入 in January（1 月），将返回未来的日期。 但是，如果现在是 2 月（今年的 1 月已过去），那么还会返回过去的 1 月作为备用日期。 如果在指定星期几时未使用修饰语，那么还会为星期几提供备用日期。 例如，对于输入 Are you open Wednesday?（你们星期三营业吗？），将存储未来的日期，但同时还会创建使用上星期三日期的备用日期。 备用日期是针对包含修饰语（例如，next、this 或 last）的短语进行创建的，修饰语可能在不同的语言环境中具有不同的含义。 watsonx Assistant 服务将 last 和 next 日期视为引用最接近的上一个日期或下一个日期（可能是同一周，也可能是前一周）。 对于某些修饰语，是否创建备用日期取决于当前是星期几。 例如，可能输入包含 this Wednesday（本星期三）。 如果现在是星期一，那么将存储未来的日期，并且不会创建备用日期。 但是，如果现在是星期三，那么将假定日期为下一周的星期三，而将今天的日期存储为备用日期。 每个备用日期都会保存为对象，其中包含每个备用日期的值和置信度。 备用日期对象以 JSON 数组格式存储。 要获取备用值，请使用语法：@sys-date.alternative。
• .calendar_type: 指定正在使用的时区的日历类型。GREGORIAN 是唯一受支持的类型。
• .datetime_link：请参阅日期和时间提及项。
• .day：返回日期中日期的帮助程序方法。
• .day_of_week：以小写字符串形式返回日期中的星期几。
• .festival：识别特定于语言环境的假日名称，并可以返回即将来临的假日的日期，例如 Thanksgiving、Christmas 和 Halloween。 如果需要在条件 (例如 @sys-date.festival == 'thanksgiving') 中指定假日名称，请使用所有小写字母。有关识别的假日的更多信息，请参阅 节日。
• .granularity：识别时间范围提及项。 选项包括 day、weekend、week、fortnight、month、quarter 和 year。
• .interpretation：您的助手返回的对象，其中包含新的字段，可提高系统实体分类器的精确度。 可以在用于引用其字段的表达式中省略 interpretation。 例如，您可以使用快捷语法 <? @sys-date.festival ?> 来访问解释对象中 festival 字段的值。
• .literal：输入中解释为日期的精确短语。
• .location：解释为日期的短语的文本字符串中第一个和最后一个字母的索引元素值。
• .month：返回日期中月份的帮助程序方法。
• .range_link：如果提供，指示用户的输入包含日期范围。 包含日期范围的字符串的开始和结束索引值会保存为链接名称的一部分。 这提供了额外的信息，包括每个 @sys-date 在范围关系中扮演的角色。 例如，开始日期的角色类型为 date_from，结束日期的角色类型为 date_to。 要检查角色值，可以使用语法 @sys-date.role?.type == 'date_from'。 如果用户输入隐含范围，但仅指定了一个日期，那么不会返回 range_link 属性，而只会返回一个角色类型。 例如，如果用户询问 Have you been open since yesterday。 那么会将 yesterday 的日期识别为 @sys-date 提及项，并且会为其返回类型为 date_from 的角色。 此外，还会返回 range_modifier，用于标识输入中触发识别范围的词。 在此示例中，修饰符为 since。
• .relative_{timeframe}：识别并捕获用户输入中相对日期值的提及项。 返回的数字表示当前日期与指定日期之间的相差单位数。 {time frame} 单位可以是 year、month、week、weekend 或 day。
• .specific_{timeframe}：识别并捕获用户输入中特定日期单位的提及项。 {time frame} 单位可以是 year、quarter、month、day 或 day_of_week。
• .year：返回日期中年份的帮助程序方法。

下表说明了每个属性从用户输入中捕获到的信息。

可识别的格式

• 2pm
• at 4
• 15:30

属性

• .alternatives：捕获除作为 @sys-time 值保存的时间以外的时间，当时间未明确显示时，用户可能指的是这个时间。 备用值会保存为对象，其中包含每个备用时间的值和置信度，并以 JSON 数组格式存储。 要获取备用值，请使用语法：@sys-time.alternative。
• .calendar_type: 指定正在使用的时区的日历类型。GREGORIAN 是唯一受支持的类型。
• .granularity：识别时间范围的提及项。 选项包括 hour、minute、second 和 instant。
• .hour：将时间中指定的小时作为数字值返回的帮助程序方法。
• .interpretation：您的助手返回的对象，其中包含新的字段，可提高系统实体分类器的精确度。 可以在用于引用其字段的表达式中省略 interpretation。 例如，您可以使用快捷语法 <? @sys-time.granularity ?> 来访问解释对象中 granularity 字段的值。
• .literal：输入中确切的短语被解释为时间。
• .location：列出解释为时间提及项的短语的文本字符串中第一个和最后一个字母的索引元素值。
• .minute：返回时间中指定的分钟值的帮助程序方法。
• .part_of_day：识别表示一天中时间的词汇，例如 morning、afternoon、evening、night 或 now。 还可为一天中的每个部分设置时间范围。 响应包含两个 @sys-time 值，一个用于时间范围的开始值，一个用于时间范围的结束值。 实体数组包含具有 range_link 和 time-from 角色类型的 time-to 对象。 一天中不同部分的时间范围可能因语言环境而有所不同。 对于美式英语，上午是 6:00:00 到 12:00:00。 下午是 12:00:00 到 18:00:00。 晚上是 18:00:00 到 22:00:00。 夜间为 22:00:00 到 23:59:59。 夜间正好在午夜开始前结束，否则夜间将与新的一天重叠，新的一天由 @sys-date 进行度量。
• .range_link：如果提供，指示用户的输入包含时间范围。 包含时间范围的字符串的开始和结束索引值会保存为链接名称的一部分。 这提供了额外的信息，包括每个 @sys-time 在范围关系中扮演的角色。 例如，开始时间的角色类型为 time_from，结束时间的角色类型为 time_to。 要检查角色值，可以使用语法 @sys-time.role?.type == 'time_from'。 如果用户输入隐含范围，但仅指定了一个时间，那么不会返回 range_link 属性，而只会返回一个角色类型。 此外，还会返回 range_modifier，用于标识输入中触发识别范围的词。
• .relative_{timeframe}：识别时间的相对提及项，并且返回的数字表示当前时间与指定时间之间的相差单位数。 {timeframe} 单位可以是 hour、minute 或 second。
• .second：返回时间中指定的秒值的帮助程序方法。
• .specific_{timeframe}：识别并捕获用户输入中特定时间单位的提及项。 {timeframe} 单位可以是 hour、minute 或 second。

下表说明了每个属性从用户输入中捕获到的信息。

可识别的格式

• now
• two hours from now
• on Monday at 4pm

属性

• .datetime_link：如果存在，则表明用户的输入同时提到了日期和时间，这意味着日期和时间彼此相关。 包含日期和时间的字符串的开始和结束索引值会保存为链接名称的一部分。

下表说明了每个属性从用户输入中捕获到的信息。

时区

相对于当前时间的日期或时间的提及项会针对所选时区进行解析。 缺省情况下，时区是格林威治标准时间。 因此，在输入中提及 now 时，位于不同时区的 REST API 客户机会获得当前全球标准时间。

（可选）REST API 客户机可以将本地时区添加为上下文变量 $timezone。 此上下文变量必须随每个客户机请求一起发送。 例如，$timezone 值可以为 America/Los_Angeles、EST 或 UTC。 有关受支持时区的完整列表，请参阅支持的时区。

当提供 $timezone 变量时，相对 @sys-date 和 @sys-time 提及的值将根据客户所在时区而非协调世界时进行计算。

有关处理日期和时间值的信息，请参阅日期和时间方法参考。

可识别的格式

• 21
• twenty one
• 3.13

属性

• .literal：输入中解释为数字的精确短语。
• .location：解释为数字的文本字符串中第一个和最后一个字母的索引元素值。
• .numeric_value：格式为整数或双精度值的规范数字值。
• .range_link：如果提供，指示用户的输入包含数字范围。 指定范围的文本的位置值会附加到链接名称。 这提供了额外的信息，包括每个 @sys-number 在范围关系中扮演的角色。 例如，开始数字的角色类型为 number_from，结束数字的角色类型为 number_to。 要检查角色值，可以使用语法 @sys-number.role?.type == 'number_from'。

下表说明了每个属性从用户输入中捕获到的信息。

@sys-number 用法提示

• 如果将 @sys-number 实体用作节点条件，并且用户将零指定为值，那么会将 0 值正确识别为数字。 但是，0 会被解释为条件的 null 值，这会导致不处理节点。 要以正确处理零的方式检查数字，还请在节点条件中使用表达式 @sys-number == 0。 要使用的完整表达式为 @sys-number OR @sys-number == 0。

• 如果使用 @sys-number 来比较条件中的数字值，请确保单独包含一项检查来确认是否存在数字本身。 如果找不到数字，@sys-number 会求值为 null。 即使没有数字，比较也可能会求值为 true。

  例如，不要单独使用 @sys-number<4，因为如果没有找到数字，@sys-number 将返回空值。 由于 null 小于 4，因此即便不存在任何数字，条件也会求值为 true。

  请改用 (@sys-number OR @sys-number == 0) AND @sys-number < 4。 如果不存在任何数字，那么第一个条件求值为 false。 因此，整个条件求值为 false。

有关处理数字值的更多信息，请参阅数字方法参考。

可识别的格式

• 15%
• 10 percent

属性

• .literal：输入中解释为百分比的精确短语。
• .location：解释为百分比提及项的文本字符串中第一个和最后一个字母的索引元素值。
• .numeric_value：格式为整数或双精度值的规范数字值。
• .range_link：如果提供，指示用户的输入包含范围，例如 from 2 to 3 percent。 指定范围的文本的位置值会附加到链接名称。 这提供了额外的信息，包括每个 @sys-percentage 在范围关系中扮演的角色。 例如，开始数字的角色类型为 number_from，结束数字的角色类型为 number_to。 要检查角色值，可以使用语法 @sys-percentage.role?.type == 'number_from'。

下表说明了每个属性从用户输入中捕获到的信息。

@sys-percentage 用法提示

• 如果您将 @sys-percentage 实体用作节点条件，且用户将 0% 指定为值，则该值会被正确识别为百分比，但条件评估结果为数字零，而非百分比 0%。 因此，条件中的 null 会求值为 false，并且不会处理节点。 要以正确处理零百分比的方式检查百分比，请改为在节点条件中使用表达式 @sys-percentage OR @sys-percentage == 0。

• 如果输入像 1-2% 这样的值，那么值 1% 和 2% 会作为系统实体返回。