トピックへのノードレス NLU エンティティの入力変数としての追加

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:4分
  • NLU が仮想エージェントで有効になっている場合、ノードレス NLU エンティティを入力変数としてトピックに追加できます。これらの変数は、NLU サービスプロバイダー予測からスロット入力するか、トピックのスコープ外で指定できます。

    始める前に

    必要なロール:virtual_agent_admin または admin

    このタスクについて

    カスタムコントロールがユーザーに日付の入力を求め、ユーザーが最初の発言で日付について言及した場合、ユーザーに再度プロンプトを表示することなくその日付をキャプチャできます。スロット入力されていないときにユーザーにプロンプトを表示するには、入力コントロールを使用します。

    NLU エンティティの詳細については、「エンティティ」を参照してください。システムエンティティの詳細については、「NLU システムエンティティ」を参照してください。

    手順

    1. 移動先 すべて > 対話型インターフェース > 仮想エージェント > デザイナー.
    2. トピックを開き、[フロー] タブを表示します。
    3. [変数 (Variables)] サイドバーで、[入力] プラスアイコンをクリックします。
    4. フォームのフィールドに入力します。
      表 : 1. [入力変数を追加] ダイアログボックス
      フィールド 説明
      入力タイプ 入力のデータタイプ。ダイアログボックスのフィールドは選択した内容に応じて変わります。
      • 文字列:英数字テキスト。[入力形式] フィールドが表示されます。データのタイプに応じて、プレーンテキストまたは準拠ルールを選択します。
      • True/False:ブール値。「はい」または「いいえ」のいずれかです。
      • 日時:日付、時刻、またはその両方。[入力形式] フィールドが表示されます。
      • 静的選択:定義されたユーザーの選択項目。[表示名] フィールドと [格納する値] フィールドのペアが表示されます。
      • ダイナミック選択肢:テーブルレコードの選択肢。[選択肢の入力方法][テーブル]、および [フィルターの選択肢] フィールドが表示されます。値は、条件付きまたはスクリプト化のいずれかです。

      詳細については、「仮想エージェント トピックの入力データタイプ」を参照してください。

      名前 エンティティの変数の名前。

      変数名は、トピックのスコープ内で一意である必要があります。ドット連結で使用すると、名前が変数として表示されます。

      NLU エンティティ ノードに関連付けられた NLU エンティティ。

      これは、モデルにインポートするビルド済みの仮想エージェントエンティティ、システムエンティティ (期間、時間、または資金など)、または作成したカスタムエンティティなどが考えられます。

      文字列データタイプのプロパティ
      入力形式

      ユーザーが特定のテキストアイテムを入力したときに検証されるテキスト形式。ユーザーが予期した形式を入力しなかった場合、形式が無効であることを示すエラーメッセージが表示され、テキストを再入力するようにユーザーに求めます。

      検証するテキストアイテムの形式を選択します。
      • テキスト:任意のテキスト文字列 (検証なし)
      • メール:メールプレフィックス (ユーザー名)、@ 記号、およびドメインで構成される形式。
      • IP アドレス (IPV4、IPV6):インターネットプロトコルバージョン 4 またはバージョン 6 のデータ通信配信形式。
      • 電話番号 (E.164):国際的に認められた標準電話番号形式。
      • URL:Web アドレス形式
      • カスタム:カスタムテキスト形式のテキスト検証ルールと、想定される形式が入力されていない場合に表示される関連エラーメッセージを提供するスクリプト。
      注:
      電話と IP アドレスの形式の例については、「E.164 電話番号形式」および「IP アドレスフィールドタイプ」を参照してください。
      日付/時刻データタイプのプロパティ
      入力形式 表示される日時コントロールのタイプ。次のいずれかの形式を選択します。
      • [日付]:ユーザーが日付を選択するための月ごとのカレンダーのみが表示されます。
      • [日付と時刻] - 月ごとのカレンダーと時間ピッカーを表示します。
      • [時刻] - ユーザーが時刻 (時および分) を選択するための時間ピッカーのみを表示します。
      静的選択データタイプのプロパティ
      選択肢

      [静的選択データタイプの場合]

      次のように 2 つ以上の選択肢を入力します。
      • 表示名:その選択肢に対してユーザーに表示される短いフレーズまたはテキスト。
      • 格納する値:対応する選択肢が選択されたときに変数に格納される文字列。
      ダイナミック選択肢データタイプのプロパティ
      選択肢の入力方法 使用するダイナミック変数のタイプ。次のオプションのいずれかを選択します。
      • レコード:選択したテーブルのレコードを返します。これらのオプションの値は、GlideRecord オブジェクトです。
      • スクリプト:オプションのアレイを返す式です。
      テーブル

      [レコード値のみ]

      [レコード] を選択肢の入力方法として選択した場合、検索するテーブルを選択します。
      フィルターの選択肢

      [レコード値のみ]

      次のいずれかを選択します。
      • 条件ビルダー:テーブルからレコードのサブセットを選択するために使用するフィルターを作成します。
      • スクリプト:表示するオプションの列挙リスト (選択リスト) を定義します。名前の値のペアは文字列オブジェクトとして格納されます。
    5. [保存] をクリックします。

      NLU エンティティは、[変数] サイドバーにトピック入力変数と一緒に表示されます。

      NLU エンティティは、[変数 (Variables)] サイドバーに入力変数と一緒に表示されます。ビューアイコンの横にコピーアイコンが表示されます。

      注:

      スロット入力された値を削除して、ユーザーに再度プロンプトを表示できます (初期入力値からバインド解除します)。詳細については、「仮想エージェント スクリプト」で「vaInputs.myvar.unbindEntity();」メソッド についてお読みください。