1. サイド・ナビゲーション・バーで「エンティティ」をクリックします。

2. 「エンティティの追加」をクリックします。

3. エンティティ・タイプとして「コンポジット・バッグ」を選択します。

4. 名前と説明を入力します。
5. エンティティ・イベント・ハンドラを使用してコンポジット・バッグのプロンプトおよびロジックをプログラムで実行する場合は、「+イベント・ハンドラ」をクリックします。

6. 「+バッグ・アイテム」をクリックして、「バッグ・アイテムの追加」ダイアログを開きます。組込みエンティティまたは既存のカスタム・エンティティを追加する場合は、それにバッグ固有の名前を作成し、コンポジット・バッグのコンテキスト内でのその役割の説明を追加できます。

7. バッグには、カスタム・エンティティ、組込みエンティティおよび次のものを含めることができます:

   • STRING—ユーザーからのフリー・テキストを取得します。

   • LOCATION—ユーザーのロケーションを取得します。

   • ATTACHMENT—ユーザーによってアップロードされたファイル、オーディオ・ファイル、ビデオまたはイメージ・ファイルを受け入れます。コンポジット・バッグ・エンティティには、アタッチメントがホストされているURLが格納されます。

   ノート
   
   DATE_TIMEエンティティを追加すると、サブタイプの入力を求められます。

   項目は、追加した順に変換されます。ただし、コンポジット・バッグの個々のメンバーを構成する方法に応じて、順序に影響が生じることがあります。

8. 「閉じる」をクリックすると、「エンティティ」ページに戻りますが、先にバッグ固有の他の機能をアイテムに追加できます(または、「エンティティ」ページでをクリックして後で更新することもできます)。

9. 次のステップ:

   • バッグ・アイテムについて個別のエラー・メッセージ、あいまい性解消のプロンプトまたは条件付きプロンプトを追加します。
     ノート
     
     これらは、エンティティをコンポジット・バッグに追加すると上書きされます。

   • エンティティをインテントに追加します。インテントへのエンティティの追加を参照してください。

   • コンポジット・バッグ・エンティティを使用するようにダイアログ・フローを構成します。

• 現在解決中のアイテムのみが更新されます。一致が複数のバッグ・アイテムに適用されると、現在解決されているバッグ・アイテムが他のアイテムより優先されます。拡張スロット充填をオフにすると、すべてのアイテムが同じ値で更新されます。
• 現在の解決アイテムがSTRINGバッグ・アイテムである場合、他のバッグ・アイテムは更新されません。
• エンティティの一致が複数の(解決されていない)バッグ・アイテムに適用される場合、曖昧さ回避ダイアログが表示され、ユーザーはすべてのバッグ・アイテムを更新するのではなく、どのアイテムを更新するかを選択できます。
• エンティティの「あいまい化の要求」スイッチは無視されます。エンティティ・イベント・ハンドラを使用して、カスタムの明確化を実装することをお薦めします。

1. プロンプトを有効にする場合は、「値のプロンプト」フィールドを空白(デフォルトの状態)のままにします。「値のプロンプト」フィールドにfalseと入力すると、プロンプトは表示されません。条件値の入力を要求するには、true (プロンプト)またはfalseに評価されるFreeMarkerブール式を追加します。

   ヒント:

   「値のプロンプト」をfalseに設定しても、「順不同の抽出」を有効にすると、入力を要求されている別のアイテムの一部としてアイテムを解決できます。
2. 「プロンプトの追加」をクリックして、プロンプト・シーケンスを作成します。ドラッグ・アンド・ドロップ・ジェスチャを使用してフィールドをシャッフルするか、番号を付けなおすことによって、プロンプトの順序を変更できます。2つ以上のプロンプトに同じ番号を付けると、プロンプトの出力をランダム化できます。

   ノート
   
   組込みエンティティのプロンプトは、それらをコンポジット・バッグに追加する場合にのみ追加できます。

   プロンプトは、リソース・バンドル(たとえば、${rb.askCheese})に格納することも、テキストとFreeMarker式の組合せとして記述することもできます。

• 常時– デフォルトのオプション。アイテムに対してこのオプションを選択すると、プロンプトを表示せずにその値をスロットに入れることができます。たとえば、顧客が「ピザの「大」がほしい」と入力したときに、PizzaSizeエンティティが解決されたとします。このオプションでは、「更新可能」プロパティの式がfalseに評価されない場合、項目値をいつでも変更できます。たとえば、コンポジット・バッグがPizzaTypeエンティティの入力を求めたときに、顧客は「野菜をお願いします。でも、「中」にしてください」と応答します。バッグのPizzaSizeおよびPizzaTypeアイテムに対して「常に」が有効になっているため、スキルは、会話を再開することなくPizzaSizeエンティティの値を「中」に更新できます。
  ノート
  
  このオプションはデフォルトの動作ですが、必ずしもSTRINGアイテムに適しているとはかぎりません。たとえば、STRINGアイテムに対してこのオプションを選択した場合、最初のユーザー・メッセージは、目的のエンティティによって照合されるのではなく、STRINGアイテムによって格納されます(これは、解決するバッグ内の最初のアイテムとして指定される場合があります)。
• なし– このオプションを選択すると、アイテムは、他のユーザー・メッセージに有効な値が含まれている場合でも、入力を求められた後にのみスロットされます。不注意一致を防止するには、「なし」を選択します。
• インテント発話を解決する場合のみ– 順不同値のスロットを、コンポジット・バッグ・エンティティに関連付けられているインテントに解決された最初のユーザー発話に制限します。

• このコンポジット・バッグには、住所に関連する2つのエンティティがあります: 自宅やオフィスなどの値を持つリスト値エンティティであるNamedAddressと、ADDRESSエンティティであるDeliveryAddressです。
• DeliveryAddressエンティティのプロンプトは、「配達先はどこにしますか。」です
• NamedAddressエンティティでは、入力は要求されません(「値のプロンプト」フィールドにfalseが入力されています)。
• NamedAddressエンティティは、DeliveryAddressを使用して抽出できます(「次を使用して抽出」メニューから「DeliveryAddress」が選択されています)。

${varName.value.itemName}

${expense.value.Amount.amount > 4}

Amounts below 5 ${expense.value.Amount.currency} cannot be expensed. Enter a higher amount or type 'cancel'.

• userInput
• prompt
• promptCount
• updatedEntities
• outOfOrderMatches
• disambiguationValues
• enumValues
• needShowMoreButton
• rangeStartVar
• nextRangeStart

Sorry,'${system.entityToResolve.value.userInput!'this'}' is not a valid pizza size.

    metadata:
      responseItems:        
      - type: "text" 
        text: "<#list system.entityToResolve.value.updatedEntities>I have updated <#items as ent>${ent.description}<#sep> and </#items>. </#list><#list system.entityToResolve.value.outOfOrderMatches>I got <#items as ent>${ent.description}<#sep> and </#items>. </#list>"
      - type: "text" 
        text: "${system.entityToResolve.value.prompt}"
        actions:
        - label: "${enumValue}"
          type: "postback"
          iteratorVariable: "system.entityToResolve.value.enumValues"

        globalActions: 
        - label: "Show More"
          type: "postback" 
          visible:
            expression: "${system.entityToResolve.value.needShowMoreButton}"
          payload:
            action: "system.showMore"
            variables: 
              ${system.entityToResolve.value.rangeStartVar}: ${system.entityToResolve.value.nextRangeStart} 
        - label: "Cancel"
          type: "postback" 
          visible:
            onInvalidUserInput: true
          payload:
            action: "cancel"

ノート

EEHにデプロイされたサービスは、「コンポーネント」ページから管理できます。

ExpenseDate: {

        validate: async (event, context) => {
          if (new Date(event.newValue.date) > new Date()) {
            context.addValidationError("ExpenseDate",context.translate('ExpenseDate.text'));
            return false;
          }          
        }

1. DATE_TIMEバッグ・アイテムを作成する前に、ユース・ケースに適した日付と時間のあいまいさ解決ルールを構成します。たとえば、経費精算書スキルを作成する場合は、「過去」を選択します。スキルが会議スケジューラの場合は、「将来」を選択します。
2. コンポジット・バッグ・エンティティ内で、「アイテムの追加」をクリックします。
3. 「タイプ」メニューから「エンティティ」を選択します。
4. 「エンティティ名」メニューからDATE_TIMEを選択します。
5. 「サブタイプ」メニューからDATE_TIMEサブタイプを選択します。
   
   
   図select-date-time-subtype.pngの説明
   
   「バッグ・アイテムの追加」ページの構成オプションは、選択したサブタイプに応じて変わります。たとえば、「繰返し」サブタイプを選択した場合、繰返しイベントの設定に固有のネストされたバッグ・アイテムの構成オプション(初期開始日時の「日時」オブジェクト、イベント頻度の設定用の「期間」オブジェクトなど)にアクセスできます。
   
   
   図edit-date-time-bag-item.pngの説明
   
   
6. 「繰返し」または「間隔」サブタイプを選択した場合:
   • コンポジット・バッグが「プロンプト対象」メニューからプロンプトするサブタイプ値を設定します。
   • 会議は通常同じ日に開始および終了するため、startDateサブタイプの「デフォルトの終了日から開始日」をオンにします。これにより、ユーザー メッセージに終了日が指定されていない(または終了日が順不同で抽出されない)場合、終了日は開始日と同じに設定されます。
     
     
     
     
7. オプションで、ユーザー入力が複数のサブタイプと一致できる場合は、曖昧さ回避ラベルを追加します。

   ヒント:

   拡張スロット充填、Apache FreeMarkerによるスロッティング値の更新、カスタム・プロンプト、エラー・メッセージなど、DATE_TIME固有ではないプロパティを構成することもできます。
8. サブタイプ・レベルの構成にアクセスするには、サブタイプをクリックします。横断を使用して、品目レベルの構成に戻ります。
   
   
   
   
9. 次のステップ:
   • コンポジット・バッグ・エンティティをインテントに関連付けます。
   • ダイアログ・フローでエンティティの変数を宣言します。
   • ダイアログ・フローで、「コンポジット・バッグの解決」状態を使用して、DATE_TIME項目を含むコンポジット・バッグ・エンティティを参照します。
   • DATE_TIME値は、ISO 8601として表されます。わかりやすい出力には、Apache FreeMarker .xs built-inを使用します。次のスニペットでは、Timeサブタイプの値は.value?time.xs?string['hh:mm a']を使用して書式設定されます。

     Your pizza will be delivered at ${pizza.value.deliveryTime.value?time.xs?string['hh:mm a']}.
     

     DATE_TIMEアイテムを文字列として参照するかわりに、次の例のDeliveryMessageなど、リソース・バンドルでアイテムを参照するベスト・プラクティスに従うことができます。

     ${rb('DeliveryMessage','time',pizza.value.deliveryTime.value?time.xs?string['hh:mm a'])}
     

     DeliveryMessageリソース・バンドル・メッセージの場合、値は{time}パラメータを介してレンダリングされます。

     Your pizza will be delivered at {time}.