数値収集の事前構築済みコンポーネント

この事前構築済みコンポーネントは、エンドユーザーから数列を収集します。受け入れられる最小と最大の長さは、入力パラメータを介して構成できます。

コンポーネントは、会話ターンごとにユーザーから桁数を分けた数字を取得して連結し、最終シーケンスを形成します。チャンクごとに受け入れられる最小と最大の長さは、入力パラメータを介して構成できます。

シーケンス キャプチャは、prebuilt_components_confirmation_done インテントと一致する入力を使用してエンドユーザーが数列を完了するまで続きます。

制限事項

一般的な事前構築済みコンポーネントの制限に加えて、この事前構築済みコンポーネントには次の制限があります。

• 数字以外の文字は使用できません。文字と数字のサポートについては、英数字コレクションをご覧ください。

エージェント向けの推奨設定

DTMF を有効にすると、ユーザーは電話の番号入力を使用して数値を入力できます。

追加機能

この事前構築されたコンポーネントには、以下の追加機能が用意されています。

• 繰り返し
• ティールブルー
• 再生

サンプル ダイアログ

次のサンプル ダイアログは、この事前構築されたコンポーネントによって処理される一般的なシナリオを示しています。サンプル ダイアログは、コンポーネントがテレフォニー経由で呼び出されたときの動作を示しています。呼び出しにより、Default Welcome Intent と会話開始時の最初のエージェント レスポンスがトリガーされます。

単一のチャンク

エンドユーザーが最初の試行で数値シーケンスを指定し、エージェントが正常に受け入れます。

ユーザー入力	エージェントの応答
	まずは、数列の最初の 1～30 桁を言ってください。完了したら、「完了」と言って収集を完了します。また、「再生」と言うと、いつでも現在収集されている数列を確認できます。
2374 30940 029 30
	23743094002930 ですね？
はい
	では、数列の次の部分を言うか、入力してください。
完了
	ありがとうございます。収集した数列は 23743094002930 です。間違いありませんか？
○
	ありがとうございます。数列の収集が完了しました。

複数のチャンク

エンドユーザーが複数のチャンクで数値シーケンスを指定します。エージェントが正常に受け入れます。

ユーザー入力	エージェントの応答
	まずは、数列の最初の 1～30 桁を言ってください。完了したら、「完了」と言って収集を完了します。また、「再生」と言うと、いつでも現在収集されている数列を確認できます。
2374 30940 029 30
	23743094002930 ですね？
いいえ
	心配無用です。数字シーケンスの最初の 1～30 桁をもう一度お知らせください。
2374
	2374 ですね。正しいですか？
はい
	では、数列の次の部分を言うか、入力してください。
3094
	3094 ですね。正しいですか？
はい
	では、数列の次の部分を言うか、入力してください。
002930
	002930 ですね。正しいですか？
いいえ
	23743094 の後は？
2930
	2930 ですね。正しいですか？
はい、そうです。
	ありがとうございます。収集した数列は 237430942930 です。間違いありませんか？
はい
	ありがとうございます。数列の収集が完了しました。

再試行が成功

エンドユーザーは、最初の試行で数列を指定します。エージェントはそれを再確認しますが、エンドユーザーは「いいえ」と言います。エージェントはエンドユーザーにもう一度数列を指定するよう求めます。エンドユーザーが数列を提供し、エージェントが正常に受け入れたことを確認します。

ユーザー入力	エージェントの応答
	まずは、数列の最初の 1～30 桁を言ってください。完了したら、「完了」と言って収集を完了します。また、「再生」と言うと、いつでも現在収集されている数列を確認できます。
92832938 3489
	928329383459 ですね？
無料
	心配無用です。数字シーケンスの最初の 1～30 桁をもう一度お知らせください。
928329383435
	928329383435 ですね？
はい、これで以上です
	ありがとうございます。収集した数列は 928329383435 です。間違いありませんか？
○
	ありがとうございます。数列の収集が完了しました。

再試行が失敗

エンドユーザーが数値シーケンスを 3 回指定し、再確認のステップで「いいえ」と言います。コンポーネントは、3 回目の確認失敗の後にフローを終了します。

ユーザー入力	エージェントの応答
	まずは、数列の最初の 1～30 桁を言ってください。完了したら、「完了」と言って収集を完了します。また、「再生」と言うと、いつでも現在収集されている数列を確認できます。
928329383435
	928329383835 ですね？
無料
	心配無用です。数字シーケンスの最初の 1～30 桁をもう一度お知らせください。
23 289 0239 903
	232890239953 ですね？
無料
	心配無用です。数字シーケンスの最初の 1～30 桁をもう一度お知らせください。
23847 02938
	2384702938 ですね。正しいですか？
無料
	すみません。試行回数が多すぎたため、回答を収集できませんでした。

認識されない入力

エンドユーザーが認識できない入力を 3 回提供すると、コンポーネントはフローを終了します。

ユーザー入力	エージェントの応答
	まずは、数列の最初の 1～30 桁を言ってください。完了したら、「完了」と言って収集を完了します。また、「再生」と言うと、いつでも現在収集されている数列を確認できます。
大丈夫です
	すみません、聞き取れませんでした。まずは、数列の最初の 1～30 桁を言ってください。完了したら、「完了」と言って収集を完了します。また、「再生」と言うと、いつでも現在収集されている数列を確認できます。
nice
	うーん、やはりわかりませんでした。回答が数列の最初の 1～30 桁であることを確認してください。完了したら、「完了」と言って収集を完了します。また、「再生」と言うと、いつでも現在収集されている数列を確認できます。音声認識に問題がある場合は、キーパッドを使用して数列を入力することもできます。
すばらしい
	申し訳ありませんが、応答を理解するのが難しいです。

命名規則

この事前構築済みコンポーネントでは、次の命名規則が使用されています。

機能	形式	例
フロー	[コンポーネント名]	数値の収集
コンポーネントに固有のインテント	prebuilt_components_[component_name]_[intent_name]	prebuilt_components_numeric_collection_collect_numeric_sequence
パラメータ	[param_name]	user_provided_cur_seq

入力パラメータ

入力パラメータは、コンポーネントの特定の動作を構成するために使用されるパラメータです。このパラメータは、コンポーネントの動作を決定するためにフロー内の 1 つ以上の条件によって使用されます。フロースコープのパラメータは、後述するように、コンポーネントのスタートページで設定する必要があります。セッション スコープのパラメータは、呼び出しフローまたはこのコンポーネントのスタートページで設定できます。

フローのスタートページでパラメータ プリセットを変更することで、キャプチャごとおよび最終的に収集された数列に対して受け入れられる最小と最大の長さを構成できます。

この事前構築済みコンポーネントは、次の入力パラメータを受け入れます。

パラメータ名	説明	入力形式
$flow.numeric_min_length	最後の数値シーケンスの最小長	integer
$flow.numeric_max_length	最後の数値シーケンスの最大長	integer
$flow.lower_limit	ユーザーが各ターンで指定できるチャンクの最小長	integer
$flow.upper_limit	ユーザーが各ターンで指定できるチャンクの最大長	integer

出力パラメータ

出力パラメータは、コンポーネントを終了した後もアクティブな状態を継続するセッション パラメータです。これらのパラメータには、コンポーネントによって収集される重要な情報が含まれます。この事前構築されたコンポーネントは、次の出力パラメータの値を提供します。

パラメータ名	説明	出力形式
numeric_collection_numeric_sequence	このパラメータは、セッション中にキャプチャされた数列を返します。	string

基本設定

この事前構築済みコンポーネントを設定するには:

1. 事前構築済みコンポーネントをインポートします。

完了

これで、エージェントが設定され、テストの準備が整いました。