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

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む7読むのに数分
  • 仮想エージェントトピック内のテキストユーザー入力コントロールは、ユーザーにテキスト文字列の入力を求めます。

    LLM トピック検出のテキストユーザー入力コントロールプロパティ

    プロパティ 説明
    ノード名 トピックフローでこのテキストユーザー入力コントロールノードを識別する名前です。
    詳細な説明

    ユーザーが必要とする 1 つの情報。たとえば、 必要なサービスカタログアイテムをユーザーに尋ねます。

    詳細
    LLM に対する追加指示

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

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

    LLM トピック検出のテキストユーザー入力コントロールの例

    表 : 1. LLM トピック入力コントロールのプロパティ
    入力プロパティ 入力プロンプト
    図 : 1. テキスト入力コントロールの基本プロパティ
    テキストユーザー入力プロパティには、ノード名と詳細な説明が含まれます。
    図 : 2. LLM に対する追加指示
    [LLM の追加の説明] で、分かりやすい言葉で指示を入力するか、スクリプトフィールドを使用するか、データピルピッカーで条件を定義します。
    図 : 3. 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 エンティティがこのノードの入力変数に関連付けられている場合、仮想エージェントはユーザーの発言に基づいて指定された値をスロットに入力できます。トピックインテントに関連付けられているエンティティのリストからエンティティを選択します。

    ノードのエンティティを指定すると、[認識されたエンティティの確認をユーザーに依頼しない (Do not ask users to confirm recognized entity)] トグルスイッチが表示されます。有効にすると、ユーザーは抽出されたエンティティの確認を求められません。

    詳細
    この入力の安全性を確保
    有効化 テキストボットユーザーの入力を暗号化する切り替えスイッチ。有効にすると、ユーザー入力がマスクされ、チャットウィンドウに一連のドットとして表示されます。
    ハッシュ関数

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

    標準の 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 を有効にしてトピックを切り替える

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

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

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

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

    会話でユーザーにこのノードをスキップさせるための条件を指定するノーコード条件ステートメントまたはローコードスクリプト。

    NLU トピック検出のテキストユーザー入力コントロールの例

    入力プロパティ 入力プロンプト
    図 : 4. テキスト入力コントロールの基本プロパティ
    テキストユーザー入力プロパティには、ノード名、プロンプト、入力形式、オプションの NLU エンティティが含まれます。
    図 : 5. この入力の安全性を確保 (詳細プロパティ)
    [この入力の安全性を確保] で、トグルスイッチをスライドさせて機能を有効にします。[ハッシュ関数 (Hash function)] フィールドと [暗号化ソルト (Encryption salt)] フィールドが表示されます。
    図 : 6. Web UI テキストユーザー入力プロンプト
    入力プロンプトが Web クライアントに表示されます。「探している内容の簡単な説明を入力してください (Please enter a short description of what you're looking for.)」というテキストが表示されます。
    図 : 7. [この入力の安全性を確保 (Make this input secure)] 切り替えスイッチが有効になっている、モバイルアプリのユーザー入力プロンプト
    モバイルアプリの安全なユーザー入力では、パスワードの代わりにドットが表示されます。

    チャネルサポート

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