Amazon Lexでスロットのバリデーションを行う
渡辺です。
Amazon Lexのスロットを理解するでは、Lexボットでのスロットについて紹介しました。 スロットとは、ユーザから入力されるパラメータのセットです。 例えば、予約インテントであれば、予約日と予約時間が必須パラメータとしてスロットに定義します。
Lexでは、必要なパラメータが揃うまでユーザにプロンプトを表示し、パラメータが揃った時点でLambdaを呼び出すことができます。 これは自動化されており非常に便利です。 一方、細かい制御、例えば値のバリデーション（妥当性チェック）を行いたい場合にはカスタマイズが必要です。 今回は、Lexボットでスロットのバリデーションを紹介します。
バリデーション関数の設定
はじめに、以下のコードでLambda関数（Node.js 6.10）を作成し、バリデーション関数として設定しましょう。
exports.handler = function (event, context, callback) {
console.log(JSON.stringify(event));
var response = {
sessionAttributes: event.sessionAttributes,
dialogAction: {
type: 'Delegate',
slots: event.currentIntent.slots
}
};
callback(null, response);
};
続けて、Lexボットのインテントでバリデーションを有効にし、Lambda関数を選択します。
これで、ユーザがスロットの値を入力後、Lexが処理する前にLambda関数が呼ばれるようになります。 現在の実装は、Lambdaで何もせずにLexに処理を委譲（Delegate）している状態です。
入力イベントのスロット情報
Lambdaでは、Lexボットからの入力をJSON形式でイベントを受けます。 この入力イベントには、次のように、スロット情報やセッション情報が含まれます。
{
"currentIntent": {
"name": "intent-name",
"slots": {
"slot name": "value",
"slot name": "value"
},
"slotDetails": {
"slot name": {
"resolutions" : [
{ "value": "resolved value" },
{ "value": "resolved value" }
],
"originalValue": "original text"
},
"slot name": {
"resolutions" : [
{ "value": "resolved value" },
{ "value": "resolved value" }
],
"originalValue": "original text"
}
},
"confirmationStatus": "None, Confirmed, or Denied (intent confirmation, if configured)",
},
"sessionAttributes": {
"key": "value",
"key": "value"
}
}
入力イベントから必要なスロット値を取得し、バリデーション（妥当性チェック）を行いましょう。
slots
currentIntent.slots には、スロットの情報が「スロット名: 値」の形式で含まれます。
例えば、DateとTimeがスロット値として定義されているならば、次のようになるでしょう。
"slots": {
"Date": "2017-1-25",
"Time": null
}
ここではDateはユーザが入力済みなため日付けが設定されていますが、Timeは未入力なのでnullが設定されています。 単純なバリデーションであれば、slotsの値だけで判定できます。
slotDetails
currentIntent.slotDetails には、スロットの詳細情報が含まれます。
originalValueにはユーザが入力したテキストが、そのまま含まれます。
Lexでは、例えば、Dateタイプで「明日」というユーザの入力があった場合、自動的に日付け計算を行い、例えば「2018-1-26」という日付けに変換する機能があります。
ユーザが入力した元の値が、originalValueです。
resolutions配は、スロットで認識された値のリストです。
originalValueからどのように値を解決したのかに関する情報が5個まで含まれます。
出力イベントのdialogAction
レスポンスとなる出力イベントのdialogActionでは、次にユーザが入力する情報についてのヒントをLexに返します。
今回はバリデーションを失敗時に、dialogAction.typeにElicitSlotを指定し、ユーザに再入力を求めます。
バリデーションが不要な場合や妥当な値だった場合は、Delegateを指定し、Lexに処理を委譲します（おまかせモード）。
{
"sessionAttributes": {
"key1": "value1",
"key2": "value2"
...
},
"dialogAction": {
"type": "ElicitIntent, ElicitSlot, ConfirmIntent, Delegate, or Close",
Full structure based on the type field. See below for details.
}
}
妥当性チェックを実装する
実装してみましょう。 ここでは予約可能時間が10時から17時までとしてみます（微妙にバグってますが気にしないでください）。
exports.handler = function(event, context, callback) {
console.log(JSON.stringify(event));
var time = event.currentIntent.slots.Time;
if (time != null && !isValidateTime(time)) {
event.currentIntent.slots.Time = null;
var response = {
sessionAttributes: event.sessionAttributes,
dialogAction: {
type: 'ElicitSlot',
message: {
contentType: "PlainText",
content: "Sorry, it is out of business hours.\nYou can reserve from 10:00 to 17:00."
},
intentName: event.currentIntent.name,
slotToElicit: 'Time',
slots: event.currentIntent.slots
}
};
callback(null, response);
}
else {
var response = {
sessionAttributes: event.sessionAttributes,
dialogAction: {
type: 'Delegate',
slots: event.currentIntent.slots
}
};
callback(null, response);
}
};
const isValidateTime = function(time) {
var hour = Number(time.split(':')[0]);
return 10 <= hour && hour <= 17;
}
dialogActionでElicitSlotを指定する場合、intentName, slotToElicit, slotsが必須です。
intentNameは、今回、インテントが変わるわけではないため、現在のインテント名で問題ありません。。
slotToElicitは、入力を促すスロット名（Time）を指定します。
slotsには不正な値をクリアするため、未入力（null）にしておきます。
メッセージは必須ではありませんが、営業時間外であることを伝え、営業時間を入力するように促します。 未指定の場合、Lexボットのスロット定義にあるプロンプトが表示されます。
動作確認
それでは動作確認してみます。
しっかりと、バリデーションが効いていることが確認出来ました。
まとめ
インターフェイスを作成するならば、値のバリデーションは必要不可欠です。 Lexでは必要最小限のコードで、バリデーションを行い、良い感じにユーザに入力を促せることができます。 曜日判定なども行えば、より洗練された予約ボットとなるでしょう。 24/365で受付を行うブラックボットは作らないでくださいね。
