ファイルピッカーのユーザー入力コントロール

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:7分
  • 仮想エージェントトピックでファイルピッカーのユーザー入力コントロールを使用して、ユーザーに画像または任意タイプのファイルをアップロードするよう求めます。ユーザーが画像ファイルをアップロードすると、画像はすぐに仮想エージェントクライアントに表示されます。

    ファイルピッカーのユーザー入力コントロールのプロパティ

    ファイルピッカーでは、画像ファイルの SVG 形式を除くすべてのファイルタイプがサポートされています。画像は高解像度にすることができますが、仮想エージェントクライアントに表示される画像はアスペクト比に基づいて拡大縮小されます。画像はチャットウィンドウ内に収まるように拡大縮小されます。

    Microsoft Teams では、ペーパークリップ (添付ファイル) アイコンを使用するか、ドラッグアンドドロップを使用してファイルをアップロードできます。コピーと貼り付けは、画像ファイルに対してのみ機能します。ユーザーは、Microsoft Teams仮想エージェントのファイルピッカーのユーザー入力コントロールを使用して、ライブエージェントとのチャット中に添付ファイルを送信することで、添付ファイルを共有できます。マルチ添付ファイルは、ライブエージェントとファイルピッカーの両方のシナリオでサポートされています。

    ライブエージェントピッカーのシナリオでサポートされているものとサポートされていないものについて説明します。
    • 複数のファイルをサポートします。
    • 画像ファイルの SVG 形式はサポートしていません。
    • テキスト、ファイル、絵文字の組み合わせをサポートします。ただし、ユーザーがこれらのアイテムを送信する方法と、エージェントがこれらのアイテムを表示する方法では、注文の表示が異なる場合があります。
    • 書式設定されたテキストはサポートされていません。
    ファイルのアップロードの進行中は、ライブエージェントピッカーのシナリオでは、テキストをアップロードまたは入力することはできません。アップロードされたファイルには、ウイルススキャンと検証が実行されます。

    ファイルピッカーコントロールでサポートされているものとサポートされていないものについて説明します。

    • 複数のファイルをサポートします。
    • 画像ファイルの SVG 形式はサポートしていません。

    ファイルのアップロードの進行中は、ファイルピッカーコントロールでは、テキストをアップロードまたは入力することはできません。アップロードされたファイルには、ウイルススキャンと検証が実行されます。

    アップロードされたファイルは、レコードアクションユーティリティを使用して作成したケースにリンクできます。詳細については、「レコードアクションユーティリティ」を参照してください。

    次の表に、ファイルピッカーのプロパティの詳細をリストします。
    表 : 1. ファイルピッカーのプロパティ
    プロパティ 説明
    ノード名 トピックフローで、ファイルピッカーのユーザー入力コントロールノードを識別する名前。
    変数名 このプロンプトに対するユーザー応答を格納する変数の名前です。変数名は、Node name プロパティから自動的に作成されます。
    プロンプト ユーザーにアイテムをアップロードするように求めるプロンプトまたは質問。プロンプトには、変数を含むテキスト文字列またはテキストを返すスクリプトを使用できます。
    ユーザーにアップロードを許可 アップロードするファイルのタイプ。画像ファイルの SVG 形式を除くすべてのファイルタイプがサポートされています。
    詳細
    確認メッセージ
    入力完了確認

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

    デフォルト値の確認

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

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

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

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

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

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

    さまざまなクライアントインターフェイスでのファイルピッカーコントロールの使用

    画像を選択する処理は、仮想エージェントクライアントインターフェイスによって異なります。次の手順を使用して、選択したクライアントインターフェイスで画像を選択します。

    以下の表では、さまざまなクライアントインターフェイスでのファイルピッカーコントロールの詳細について説明します。
    表 : 2. さまざまなクライアントインターフェイスでのファイルピッカーコントロール
    プラットフォーム 画像またはファイルを選択する手順
    Web UI
    1. [画像をアップロードするには、ここをクリックしてください。] または [ファイルをアップロードするにはここをクリックしてください。] を選択します。
    2. ローカルコンピュータからファイルを選択します。すべてのファイルタイプがサポートされています。

    Slack

    1. 緑色の [+] アイコンを選択します。
    2. [自分のコンピュータ] を選択します。
    3. ローカルコンピュータから画像ファイルを選択します。

      すべてのファイルタイプがサポートされています。

    Microsoft Teams

    1. ローカル コンピュータで、画像ファイルをコピーします。
    2. Microsoft Teams のテキスト入力フィールドに画像ファイルを貼り付けます。

    Workplace

    1. 職場の画像アイコン (職場の画像アイコン) を選択します。
    2. ローカルコンピュータから画像ファイルを選択します。

      すべてのファイルタイプがサポートされています。

    ServiceNow モバイル

    1. [画像をアップロード] をタッチします。
    2. モバイルデバイスの写真ライブラリーから画像ファイルを選択します。
    注:
    [ファイルをアップロード] ボタンは、[すべてのファイルタイプ] ファイルピッカーのプロパティを有効にした場合にのみ使用できます。

    ファイルピッカーのユーザー入力コントロールの例

    注:
    仮想エージェントデザイナーコントロールは、他のチャネルでは表示や機能が異なる場合があります。
    ファイルピッカーのプロパティ ファイルピッカーのプロンプト
    図 : 1. ファイルピッカーのユーザー入力コントロールの基本プロパティ
    基本プロパティには、ノード名、プロンプト、ファイルタイプ ([イメージ] または [すべてのファイルタイプ]) が含まれます。
    図 : 2. Web UI ファイルピッカーのプロンプト (画像)
    チャットウィンドウで、「画像をアップロードしてください (Please upload your image)」というプロンプトが表示されます。ボタンには、「画像をアップロードするにはここをクリックしてください」と表示されます。
    図 : 3. ServiceNow モバイル ファイルピッカープロンプト
    「ケースの詳細な説明のファイルをアップロードしてください (Please upload a file for the detailed description of the case)」というプロンプトが表示されます。[画像をアップロード]、[写真を撮る]、または [ファイルをアップロード] の 3 つのオプションがあります。

    チャネルサポート

    次の表に、ファイルピッカーユーザー入力コントロールのチャネルサポートの詳細を示します。
    表 : 3. ファイルピッカーのユーザー入力コントロールのチャネルサポート
    チャネル サポート 制約
    Web UI サポート対象 なし
    モバイル UI サポート対象

    ユーザーに表示される、アプリがカメラまたはファイルシステムにアクセスするための許可を求めるプロンプト (まだ許可していない場合)。

    プロンプトでは、「モバイルがカメラへのアクセスの許可を求めています ( "Mobile" Would Like to Access the Camera.)」と表示されます。選択肢は「許可しない (Don't Allow)」と「OK」です。

    Now Assist パネル サポート対象 なし
    Microsoft Teams サポート対象 なし
    Slack サポート対象 なし
    Workplace サポート対象 なし
    Facebook Messenger サポート対象
    サポートされているファイル形式は、JPG、PNG、BMP、MP4 です。ファイルタイプに応じた次のようなファイルサイズの上限があります。
    • 画像の場合、サイズ上限は 10 MB です。
    • ビデオの場合、サイズ上限は 200 MB です。
    SMS Twilio 部分サポート 画像ファイルのみ
    LINE サポート対象
    サポートされているファイル形式は、JPG、PNG、BMP、MP4 です。ファイルタイプに応じた次のようなファイルサイズの上限があります。
    • 画像の場合、サイズ上限は 10 MB です。
    • ビデオの場合、サイズ上限は 200 MB です。
    WhatsApp サポート対象 なし
    Apple Messages for Business サポート対象 なし
    Alexa (音声アシスト機能) サポート対象外 適用外