힌트 매개변수

후처리 정확도를 높이고 사용자 의도에 더 잘 부합하도록 스마트 포맷터는 이제 새로운 hints 매개변수를 지원합니다. hints 매개변수는 예상되는 속성 유형을 표시하여 서식을 안내하는 데 도움이 됩니다. 이 매개변수를 사용하면 포맷터가 특히 사용자 입력이 모호하거나 구조가 느슨한 경우 데이터를 보다 효과적으로 해석하고 구조화할 수 있습니다.

지원되는 값

hints 매개변수는 다음 값을 지원합니다:

힌트 매개변수에 지원되는 값
힌트	설명	모호성 해결	예
`date`	입력 형식을 날짜로 지정합니다.	숫자 표현식과 날짜 참조를 구분합니다. 예를 들어 `six twenty seven twenty fourteen` 같은 음성 입력은 숫자나 날짜로 해석될 수 있습니다. `date` 힌트를 지정하면 날짜로 올바르게 형식이 지정됩니다.	`six twenty seven twenty fourteen` 의 형식은 `06/27/2014` 입니다.
`alphanum`	입력 형식을 영숫자 문자열(문자와 숫자 결합)로 지정합니다.	오디오 입력에서 화자가 `o` 라고 말하면 문자 `o` 또는 숫자 `0` 를 가리킬 수 있습니다. `alphanum` 힌트를 지정하면 스마트 포맷터는 0으로 변환하는 대신 `o` 문자를 그대로 유지합니다.	`A o 5 B` 의 형식은 `Ao5B` 입니다.

date 및 alphanum 외에도 hints 매개변수는 다음 값도 지원합니다:

number- 모호한 문맥에서 숫자 시퀀스를 올바르게 해석합니다.
email- 음성 이메일 주소의 모호함을 해결합니다.
phonenumber- 전화번호를 다른 숫자 표현식과 구분합니다.

개발자는 힌트를 지정하여 포맷터의 기능을 향상시켜 사용자의 기대에 더 근접한 결과를 제공할 수 있습니다. 스마트 포맷터에 대한 자세한 내용은 스마트 포맷터를 참조하세요.

힌트 매개변수 사용

hints 매개 변수는 스마트 서식 지정이 버전 2.0 에서 활성화된 경우에만 작동합니다. 이 기능을 사용하려면 요청에 다음 매개 변수를 포함하세요:

smart_formatting=true
smart_formatting_version=2.0

현재 date 및 alphanum 이 지원되는 힌트입니다.

요청 예제:

curl -X POST -u "apikey:<apikey>"
-H "Content-Type: audio/wav"
--data-binary @{path}New_Recording.wav  
"{URL}/v1/recognize?model=en-US&hints=date&smart_formatting=true&smart_formatting_version=2.0"

리소스 예:

text msg received %s {
   "result_index": 0,
   "results": [
      {
         "final": true,
         "alternatives": [
            {
               "transcript": "9/9/88 ",
               "confidence": 0.93
            }
         ]
      }
   ]
}

엄격한 속성

strict 속성은 힌트와 함께 사용하여 출력에서 원치 않거나 추가 컨텍스트를 제거할 수 있습니다. 사용자 입력에 형식화된 출력에 필요하지 않은 추가 단어가 포함된 경우 보다 간결하고 정확한 결과를 생성하는 데 도움이 됩니다.

요청 예제:

curl -X POST -u "apikey:<apikey>"  
-H "Content-Type: audio/wav"  
--data-binary @{path}New_Recording.wav  
"{URL}/v1/recognize?model=en-US&hints=date,strict&smart_formatting=true&smart_formatting_version=2.0"

예를 들어 입력이 My Birthday is on June twenty seven two thousand fourteen 인 경우 date 속성이 있는 출력은 My Birthday is on 06/27/2014 입니다. date 및 strict 속성이 모두 포함된 출력은 06/27/2014 입니다. strict 속성은 주변 컨텍스트(있는 경우)를 제거하여 필수 형식의 값만 반환되도록 하는 데 도움이 됩니다.

지원되는 언어

hints 매개변수는 현재 영어(미국)를 지원합니다(en-US).