テキストユーザー入力コントロール

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:9分
  • 仮想エージェントトピックのテキストユーザー入力コントロールは、ユーザーにテキスト文字列の入力を求めます。

    LLM トピックディスカバリー用のテキストユーザー入力コントロールのプロパティ

    プロパティ 説明
    ノード名

    トピックフローでノードを識別する名前です。

    変数名

    このプロンプトに対するユーザー応答を格納する変数の名前です。変数名は、ノード名プロパティから自動的に作成されます。

    自動スロット入力を許可

    このノードの値を、トピックディスカバリー中に他のノードによって自動的に設定できるようにする場合に切り替えます。この切り替えを有効にすると、[詳細な説明] フィールドが、動的なデータピルピッカーとスクリプトオプションから静的テキストフィールドに変わります。

    詳細な説明

    ユーザーからの必要な情報の説明。[ スロットの自動入力を許可 (Allow automatic slot filling )] トグルがオフになっている場合は、[データピルピッカー] アイコン を選択して条件を定義するか、[エディターを開く] アイコン を選択してスクリプトを入力し、動的な詳細説明を作成できます。[自動スロット入力を許可 (Allow automatic slot filling)] トグルが有効になっている場合は、静的な説明のみを入力できます。

    入力形式
    ユーザーが特定のテキストアイテムを入力したときに検証されるテキスト形式。ユーザーが予期した形式を入力しなかった場合、形式が無効であることを示すエラーメッセージが表示され、テキストを再入力するようにユーザーに求めます。検証するテキストアイテムの形式を選択します。
    • テキスト:任意のテキスト文字列 (検証なし)。
    • メール:メールプレフィックス (ユーザー名)、@ 記号、およびドメインで構成される形式。
    • IP アドレス (IPV4、IPV6):インターネットプロトコルバージョン 4 またはバージョン 6 のデータ通信配信形式。
    • 電話番号 (E.164):国際的に認められた標準電話番号形式。
    • URL:Web アドレス形式。
    • カスタム:カスタムテキスト形式の検証ルールを提供するスクリプト。スクリプトには、想定される形式が入力されない場合に表示される関連エラーメッセージを含める必要があります。
    電話と IP アドレスの形式の例については、「E.164 電話番号形式」および「IP アドレスフィールドタイプ」を参照してください。
    詳細
    ユーザープロンプトの実行

    切り替えて、大規模言語モデル (LLM) が生成するメッセージの代わりに、ユーザーに表示するカスタムメッセージのフィールドを開きます。分かりやすい言葉でカスタムメッセージを作成したり、スクリプトを入力したり、データピルピッカーを使用して条件を定義したりすることができます。

    妥当性検証

    ユーザー入力を検証するスクリプトを追加します。たとえば、ユーザーが有効なメールアドレスを入力したかどうかを確認します。

    LLM に対する追加指示

    データ形式、制限、またはユーザー応答のデフォルト値の追加など、LLM への詳細な指示。分かりやすい言葉で追加の指示を作成したり、スクリプトを入力したり、データピルピッカーを使用して条件を定義したりすることができます。

    このノードを非表示またはスキップ
    次の場合、このノードを条件付きで使用します: 会話でこのノードを表示するための条件を指定するノーコード条件ステートメントまたはローコードスクリプト。条件は true と評価される必要があります。
    次の場合、ユーザーにこのノードのスキップを許可

    会話でユーザーにこのノードをスキップさせるための条件を指定するノーコード条件ステートメントまたはローコードスクリプト。条件は true と評価される必要があります。このフィールドは、条件ビルダーまたはスクリプトのいずれかを使用して設定できます。

    LLM トピックディスカバリー用のテキストユーザー入力コントロールの例

    表 : 1. LLM トピック入力コントロールのプロパティ
    入力プロパティ 入力プロンプト

    すべての基本的なテキストユーザー入力フィールドは公開されています。いずれかの詳細オプションを選択して、個別に開くように切り替えます。

    図 : 1. Web UI テキストユーザー入力プロンプト
    入力プロンプトを表示している Web クライアント。「最初のサービスカタログアイテムを提供してください (Could you please provide your first service catalog item?)」というテキストが表示されます。

    NLUトピックディスカバリー用のテキストユーザー入力コントロールのプロパティ

    プロパティ 説明
    ノード名

    トピックフローでノードを識別する名前です。

    変数名

    このプロンプトに対するユーザー応答を格納する変数の名前です。変数名は、ノード名プロパティから自動的に作成されます。

    プロンプト

    ユーザーへのプロンプトまたは質問。プロンプトは、テキスト文字列またはテキストを返すスクリプトのいずれかです。この値は、デフォルト値が指定されていない場合にのみ使用されます。例:[名前は何ですか (What's your name?)]

    入力形式
    ユーザーが特定のテキストアイテムを入力したときに検証されるテキスト形式。ユーザーが予期した形式を入力しなかった場合、形式が無効であることを示すエラーメッセージが表示され、テキストを再入力するようにユーザーに求めます。検証するテキストアイテムの形式を選択します。
    • テキスト:任意のテキスト文字列 (検証なし)。
    • メール:メールプレフィックス (ユーザー名)、@ 記号、およびドメインで構成される形式。
    • IP アドレス (IPV4、IPV6):インターネットプロトコルバージョン 4 またはバージョン 6 のデータ通信配信形式。
    • 電話番号 (E.164):国際的に認められた標準電話番号形式。
    • URL:Web アドレス形式。
    • カスタム:カスタムテキスト形式の検証ルールを提供するスクリプト。スクリプトには、想定される形式が入力されない場合に表示される関連エラーメッセージを含める必要があります。
    電話と IP アドレスの形式の例については、「E.164 電話番号形式」および「IP アドレスフィールドタイプ」を参照してください。
    NLU エンティティ

    NLU エンティティをノードに関連付けるオプション。NLU エンティティがこのノードの入力変数に関連付けられている場合、仮想エージェント はユーザーの発言に基づいて指定された値をスロットに入力できます。トピックインテントに関連付けられているエンティティのリストからエンティティを選択します。

    ノードのエンティティを指定すると、[認識されたエンティティの確認をユーザーに要求しない] トグルスイッチが表示されます。有効にすると、ユーザーは抽出されたエンティティの確認を求められません。

    詳細
    この入力の安全性を確保
    有効化

    入力コントロールを暗号化する切り替えスイッチ。有効にすると、ユーザー入力がマスクされ、チャットウィンドウに一連のドットとして表示されます。

    ハッシュ関数

    [[この入力の安全性を確保] が有効になっている場合に表示]

    標準の WS-Security 標準に基づくメソッドダイジェストアルゴリズム。次のいずれかを選択します。
    • SHA-256 (小文字)
    • SHA-1 (小文字)
    WS-Security 標準の詳細については、「WS-Security プロパティ」を参照してください。
    暗号化ソルト

    [[この入力の安全性を確保] が有効になっている場合に表示]

    データをハッシュする一方向関数への追加入力として使用されるランダムデータ。

    デフォルト値
    ユーザー入力の値を事前定義

    質問またはプロンプトに対するユーザー応答の事前定義済みの値です。[デフォルト値の確認] フィールドで定義された応答では、ユーザーにデフォルト値の確認を求めます。ユーザーが「 no」で応答した場合、値は null になります。デフォルト値は、テキスト文字列またはテキストを返すスクリプトのいずれかです。たとえば、ドット連結を使用している場合、デフォルト値は Script Variables > Last username になります。または、スクリプトを使用している場合、デフォルト値は {{vaScripts.lastUsername}} になります。

    確認メッセージ
    入力完了確認

    ノードのインタラクションが完了したときにユーザーに表示されるボット応答。メッセージは、テキスト文字列またはテキストを返すスクリプトのいずれかです。たとえば、ドット連結を使用している場合は、次のようになります。Thanks, (Input Variables > Username)! または、スクリプトを使用している場合、確認応答は次のようになります。Thanks, {{vaInputs.username}}!

    デフォルト値の確認

    [デフォルト値 (Default value)]フィールドの値が正しいことを検証するようにユーザーに求めるメッセージ。このメッセージは、 [プロンプト (Prompt)] フィールドの値の代わりに使用されます。テキスト文字列またはテキストを返すスクリプトのいずれかが含まれる可能性があります。たとえば、ドット連結を使用している場合は、次のようになります。Are you (Input Variables > Username)? またはスクリプトを使用している場合、確認メッセージは次のようになり ます。Are you {{vaScripts.lastUsername}}?

    会話の切り替え
    ユーザーが件名を変更できるようにするにはオンにします

    このノードの NLU 予測を有効にするオプション。有効にすると、使用している入力コントロールのタイプに関係なく、ユーザーはテキストを入力して質問に回答できます。仮想エージェント はこの発言を使用して別の既存のインテントを照合し、ユーザーがトピックを切り替えられるようにします。

    このノードを非表示またはスキップ
    次の場合、このノードを条件付きで表示します:

    会話でこのノードを表示するための条件を指定するノーコード条件ステートメントまたはローコードスクリプト。条件は true と評価される必要があります。

    次の場合、ユーザーにこのノードのスキップを許可

    会話でユーザーにこのノードをスキップさせるための条件を指定するノーコード条件ステートメントまたはローコードスクリプト。条件は true と評価される必要があります。このフィールドは、条件ビルダーまたはスクリプトのいずれかを使用して設定できます。

    再プロンプトをスキップ

    会話でユーザーが再プロンプトをスキップできるようにするための条件を指定するノーコード条件ステートメントまたはローコードスクリプト。トピックループバックまたはダイアログアクションで先行するノードに再度アクセスすると、仮想エージェントはこのノードをバイパスし、元の値を自動的に保持します。

    チャネルサポート

    注:
    仮想エージェントデザイナーコントロールは、他のチャネルでは表示や機能が異なる場合があります。
    表 : 2. テキストユーザー入力コントロールのチャネルサポート
    チャネル LLM サポート NLU/キーワードのサポート 制約
    Web UI サポート対象外 サポート対象 なし。
    Mobile UI サポート対象外 サポート対象 なし。
    Now Assist パネル サポート対象外 サポート対象 なし。
    Microsoft Teams サポート対象 サポート対象 なし。
    Google Chat サポート対象 サポート対象 なし。
    Slack サポート対象外 サポート対象 Slack ユーザーは、以前に会話に入力したテキストを編集できます。ただし、 仮想エージェント 最初に入力されたメッセージを処理します。ユーザーがSlack ケースを更新するコメントなどのテキスト入力を編集した場合、 仮想エージェント 編集された更新は評価されません。
    Workplace サポート対象外 サポート対象 なし。
    Facebook Messenger サポート対象外 サポート対象 最大文字数は 5,000 文字です。
    SMS Twilio サポート対象外 サポート対象 なし。
    LINE サポート対象外 サポート対象 最大文字数は 5,000 文字です。
    WhatsApp (Twilio を利用) サポート対象 サポート対象 なし。
    WhatsApp サポート対象外 サポート対象 最大文字数は 4,096 文字です。
    Apple Messages for Business サポート対象外 サポート対象 なし。
    Alexa (音声アシスト機能) サポート対象外 サポート対象 スクリーンデバイスの場合、文字数制限が適用される場合があります。詳細については、 Alexa開発者向けドキュメントを参照してください。