ヒントパラメータ

後処理の精度を向上させ、ユーザーの意図により沿うよう、Smart Formatterは新たに hints パラメータをサポートしました。 hints パラメータは、予想される属性タイプを示すことで、書式設定の指針となります。このパラメータを使うと、特にユーザー入力があいまいだったり、構造が緩かったりする場合に、フォーマッタがデータをより効果的に解釈し、構造化できるようになります。

サポートされる値

hints パラメーターは以下の値をサポートする：

hintsパラメータでサポートされている値
ヒント	説明	曖昧さを解消する	例
`date`	入力を日付としてフォーマットする。	数値表現と日付参照を区別する。例えば、 `six twenty seven twenty fourteen` のような音声入力は、数字または日付として解釈されるかもしれない。 `date` ヒントが指定されると、日付として正しくフォーマットされます。	`six twenty seven twenty fourteen` の書式は `06/27/2014`。
`alphanum`	入力を英数字の文字列（文字と数字を組み合わせたもの）としてフォーマットする。	音声入力において、スピーカーが `o` と言った場合、それは文字 `o` または数字 `0` のどちらかを指すかもしれない。 `alphanum` ヒントを指定すると、スマートフォーマッタは `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 パラメーターは現在、英語（US）をサポートしている (en-US)。