인식되는 형식

• 20 cents
• Five dollars
• $10

속성

• .literal: 입력에서 화폐 멘션으로 해석되는 정확한 구입니다.
• .numeric_value: 기본 단위로 된, 유형이 정수 또는 실수인 표준 숫자입니다.
• .location: 화폐 멘션으로 해석되는 구의 텍스트 문자열에 있는 첫 번째 및 마지막 문자의 인덱스 요소 값을 나열합니다.
• .unit: 3자리 ISO 통화 코드로 지정된 통화 단위. 예를 들어, USD 또는 EUR입니다.

다음 표는 각 속성이 사용자 입력에서 캡처하는 정보를 보여줍니다.

veinte euro (스페인어로는 twenty euro ) 또는 €1.234,56 를 입력하면 @sys-currency는 다음과 같은 값을 반환합니다

지원되는 다른 언어 및 국가 통화에 대해서도 동등한 결과가 리턴됩니다.

@sys-currency 사용 팁

@sys-currency 엔티티를 노드 조건으로 사용하고 사용자가 $0을 값으로 지정하면, 값이 통화로 올바르게 인식되지만 조건은 통화 0이 아닌 숫자 0으로 평가됩니다. 결과적으로 조건에서 null이 false로 평가되고 노드는 처리되지 않습니다. 0을 올바르게 처리하는 방식으로 통화 값 여부를 확인하려면 노드 조건에서 @sys-currency OR @sys-currency == 0 표현식을 대신 사용하십시오.

언어별로 인식되는 통화에 대한 자세한 정보는 통화 지원의 내용을 참조하십시오.

인식되는 형식

• 금요일
• 오늘
• May 8

속성

• .alternatives: 입력이 해석 가능할 때 대체 날짜 값을 저장합니다. 일반적으로 미래 날짜는 @sys-date 값으로 리턴됩니다. 모호성이 있는 경우 과거 날짜가 대체 날짜로 저장됩니다. in January 입력의 경우, 미래 날짜가 리턴됩니다. 그러나 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을 생략할 수 있습니다. 예를 들어, 해석 객체에서 festival 필드의 값에 액세스하려면 약어 구문 <? @sys-date.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
• 4시에
• 15:30

속성

• .alternatives @sys-time 로 저장된 시간 이외의 시간을 캡처합니다. 사용자가 시간을 명확하게 표시하지 않았을 때 의미할 수 있는 값입니다. 대체 값은 각 대체 시간의 값 및 신뢰도를 포함하고 JSON 배열에 저장되는 오브젝트로 저장됩니다. 대체 값을 가져오려면 @sys-time.alternative 구문을 사용하십시오.
• .calendar_type: 사용 중인 시간대의 달력 유형을 지정합니다. 지원되는 유형은 GREGORIAN 뿐입니다.
• .granularity: 시간 범위의 멘션을 인식합니다. 옵션은 hour, minute, second, instant 입니다.
• .hour: 시간에 지정된 시간을 숫자 값으로 리턴하는 헬퍼 메소드입니다.
• .interpretation: 어시스턴트가 반환하는 객체로서, 시스템 엔티티 분류기의 정확도를 높이는 새로운 필드를 포함합니다. 필드를 참조하는 데 사용하는 표현식에서 interpretation을 생략할 수 있습니다. 예를 들어, 해석 객체에서 granularity 필드의 값에 액세스하려면 약어 구문 <? @sys-time.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 to 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일 수 있습니다.

다음 표는 각 속성이 사용자 입력에서 캡처하는 정보를 보여줍니다.

인식되는 형식

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

속성

• .datetime_link: 이 옵션이 선택되어 있다면, 사용자의 입력 내용에 날짜와 시간이 함께 언급되어 있다는 것을 의미하며, 이는 날짜와 시간이 서로 관련되어 있음을 의미합니다. 날짜 및 시간을 포함하는 문자열의 시작 및 종료 인덱스 값은 링크 이름의 일부로 저장됩니다.

다음 표는 각 속성이 사용자 입력에서 캡처하는 정보를 보여줍니다.

시간대

현재 시간과 관련된 날짜나 시간의 언급은 선택한 시간대에 대해 해결됩니다. 기본적으로 시간대는 그리니치 표준시입니다. 따라서 다른 시간대에 있는 REST API 클라이언트는 now가 입력에서 언급되면 협정 세계시(UTC)를 가져옵니다.

선택적으로 REST API 클라이언트는 로컬 시간대를 컨텍스트 변수 $timezone으로 추가할 수 있습니다. 이 컨텍스트 변수는 모든 클라이언트 요청과 함께 보내야 합니다. 예를 들어, $timezone 값은 America/Los_Angeles, EST 또는 UTC일 수 있습니다. 지원되는 시간대의 전체 목록은 지원되는 시간대를 참조하십시오.

$timezone 변수가 제공되면, 상대적인 @sys-date 와 @sys-time 멘션의 값은 협정 세계시(Coordinated Universal 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 값이 숫자로 올바르게 인식됩니다. 그러나 0은 조건에 대한 null 값으로 해석되며, 이는 노드가 처리되지 않게 합니다. 0을 올바르게 처리하는 방식으로 수 여부를 확인하려면 노드 조건에서 @sys-number == 0 표현식도 사용하십시오. 사용할 전체 표현식은 @sys-number OR @sys-number == 0입니다.

• @sys-number를 사용하여 조건에서 숫자 값을 비교하는 경우 숫자의 존재에 대한 검사를 별도로 포함해야 합니다. 숫자가 없는 경우 @sys-number는 널로 평가됩니다. 숫자가 없는 경우에도 비교가 true로 평가될 수 있습니다.

  예를 들어, 숫자가 없으면 @sys-number 항목이 널로 평가되므로 @sys-number<4만 사용하지 마십시오. 널이 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% 백분율이 아닌 숫자 0으로 평가됩니다. 결과적으로 조건에서 null이 false로 평가되고 노드는 처리되지 않습니다. 0을 올바르게 처리하는 방식으로 백분율 여부를 확인하려면 노드 조건에서 @sys-percentage OR @sys-percentage == 0을 대신 사용하십시오.

• 1-2%와 같은 값을 입력하는 경우 값 1% 및 2%가 시스템 엔티티로 리턴됩니다.