ノードレス NLU エンティティを入力変数としてトピックに追加する

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

    始める前に

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

    このタスクについて

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

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

    手順

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

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

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

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

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

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

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

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

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

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

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

      [レコード値のみ]

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

      [レコード値のみ]

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

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

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

      注:

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