ユーザーアクティビティの追加
ユーザーアクティビティは、エージェントのワークフロー内で入力を収集し、結果を表示するための1つまたは複数のチャットベースの対話で構成されます。 ミッドフロー・インタラクションをサポートしており、ユーザーはチャット・インターフェイスで直接情報を見たり、返答したりすることができる。 例えば、リクエストの承認、リストからの選択、フォローアップ質問への回答、問題の報告などです。
エージェント型ワークフローにユーザーアクティビティを追加する：
ワークフロービルダーで、「フロー項目を追加」をクリック
します。フローノードから、 「ユーザーアクティビティ」 をクリックしてコネクタライン上にドラッグします。
ユーザーアクティビティの追加方法に関するサンプル動画については、「 動画 」セクションの「 watsonx Orchestrate でユーザーアクティビティを使用したエージェント型ワークフローの構築」をご覧ください。
相互作用の追加
インタラクションを使用して、チャット内またはフォーム内でユーザーから情報を収集したり、ユーザーに情報を表示したりできます。 インタラクションは、複数ターンにわたるユーザーアクティビティ内やフォーム内に表示されることがあります。 選択するインタラクションの種類によって、ユーザーに表示されるUIウィジェットが決まります。
利用可能なインタラクションの種類
以下の表は、すべてのインタラクションタイプ、それらがサポートする操作、およびユーザーに表示されるUIウィジェットをまとめたものです。
対話タイプ |
説明 |
フェーズが |
UIウィジェット |
|---|---|---|---|
ブール選択 |
はい」または「いいえ」の回答を集める |
多回転と形状 |
複数選択：丸薬（ボタン）；形式：チェックボックスまたはラジオボタン |
単一選択 |
リストから1つの選択肢を選択する |
多回転と形状 |
ドロップダウンリストまたはテーブル |
複数選択 |
複数選択を収集する |
フォーム |
ドロップダウンリストまたはテーブル |
テキスト |
テキスト入力を収集する |
多回転と形状 |
テキスト・フィールド |
数値 |
数値入力を収集する |
多回転と形状 |
数値フィールド |
日付 |
日付入力を収集する |
多回転と形状 |
日付ピッカー |
日付範囲 |
開始日と終了日を収集する |
フォーム |
日付範囲ピッカー |
ファイルのアップロード |
1つ以上のファイルを収集する |
多回転と形状 |
ファイルアップロードコントロール |
リスト（入力） |
複数のユーザー入力値を収集する |
フォーム |
表 |
リスト（出力） |
値のリストを表示する |
多回転と形状 |
箇条書きリストまたは表 |
メッセージ |
テキストメッセージを表示する |
多回転と形状 |
プレーンテキスト、マークダウン、またはHTML |
ファイルのダウンロード |
ダウンロード可能なファイルを表示する |
多回転と形状 |
ダウンロード・リンク |
フィールド |
フォームに単一の値を表示する |
フォーム |
フィールド |
この概要は、複数ターンにわたる対話やフォーム全体にわたる対話タイプの統一的な見解を提供し、各タイプに対して表示されるUIウィジェットを理解するのに役立ちます。
フォームにアップロードされたファイルは削除されず、現時点では一定期間経過後に自動的に削除する仕組みはありません。 API経由でもUI経由でも、以前にアップロードされたファイルには一切アクセスできません。 ファイル自体へのアクセスにも署名の有効期限が設定されており、これにより URL のダウンロードが長期にわたって利用可能になることを防いでいます。
マルチターン型のやり取りを追加する
ユーザーアクティビティにマルチターンインタラクションを追加するには：
ユーザーアクティビティ内のコネクタラインをクリックしてください。
ユーザーから情報を収集するには「ユーザーから収集」を選択してください。 以下のインタラクションタイプから選択できます：
ブール値選択、 日付、 ファイルアップロード、 数値、 単一選択、 テキスト。
ユーザーに情報を表示するには「ユーザーに提示」を選択してください。 以下のインタラクションタイプから選択できます：
ファイルダウンロード、 リスト、 メッセージ。
メッセージのやり取りにおいて、中括弧をプレーンテキストとして表示したい場合は、二重中括弧でエスケープしてください。 たとえば、 {{customer_id}} は出力メッセージで {customer_id} と表示され、二重中括弧内のテキストは変数ではなくプレーンテキストとして扱われます。
フォームベースのインタラクションを追加する
フォームはマルチターン対話と同じ対話タイプをサポートします。 また、複数選択やリスト入力など、フォームでのみ利用可能なインタラクションタイプも含まれています。 フォームフィールドの設定中に 「ユーザーから収集」 または 「ユーザーに提示」 を選択することで、これらのインタラクションを追加できます。
各フィールドタイプの設定方法の詳細な手順については、フォームのドキュメント内の 「ユーザーからの収集」 および 「ユーザーへの表示」 のセクションを参照してください。
フィールド間の相互作用に加え、フォームでは、ユーザーの入力に基づいてフィールドの動作を制御する動的ルールがサポートされています。 動的ルールを使用すると、ユーザーがフォームに入力するにつれて、フィールドの表示・非表示を切り替えたり、フィールドラベルを変更したり、フィールドの値を動的に設定したりすることができます。 動的ルールおよび動的フォームの動作に関する詳細については、 「動的フォーム」 を参照してください。
インタラクションの編集
ユーザーアクティビティのインタラクションを編集するには
インタラクションをクリックする。
名前の上にカーソルを合わせ、「編集」をクリックしてください
。新しい名前を入力し、Enterキーを押してください。
やり取りの削除
ユーザーアクティビティ内のインタラクションを削除するには
インタラクションをクリックする。
「削除」を選択してください
。
このノードのタイトルは、チャット内でユーザーに表示されます。
インタラクション用の変数の設定
ユーザー 操作からの収集に関する変数を設定するには：
シングルチョイスインタラクションノードを設定し、ユーザーから単一選択の入力を収集します。
変数をクリックし、ユーザーから単一
選択の入力を受け取る変数を選択します。 カスタム選択肢を作成するには、式をクリック
し、ユーザーが選択できる選択肢を返す Python 式を入力します。
ユーザー との対話に表示する変数を設定するには：
テキスト対話ノードを設定して、チャットにテキストを表示します。
出力メッセージに表示するテキストを入力します。 メッセージに変数の値を含めたい場合は、「変数」をクリック
し、リストから変数を選択してください。
リストインタラクションノードを設定して、チャットにリストを表示します。
Select source フィールドをクリックする。
変数をクリック
し、チャットに表示する値のリストを提供する変数を選択してください。 カスタムリストを作成するには、式をクリック し、リストを生成する Python 式を入力します。
ファイルダウンロードインタラクションノードを設定して、チャット内でダウンロード可能なファイルを表示します。
Select source フィールドをクリックする。
変数をクリックしてください
。ダウンロードするファイルを提供する変数を選択してください。
ユーザー活動のフォーム
ユーザーアクティビティ内のフォームを使用すると、会話の1ターン内で複数の情報を収集・提示できます。 例えば、フライトを予約するエージェント的なワークフローでは、フォームが旅行の日付、目的地、クラスの好み、その他の詳細を収集することができる。 チャットは、ユーザーの入力に基づいて利用可能なフライトのリストを表示することができます。
フォームの追加
エージェント型ワークフローのユーザーアクティビティにフォームを追加する：
ユーザーアクティビティ内のコネクタラインをクリックしてください。
フォームを追加を選択してください。 フォームを追加するダイアログが表示されます。
をクリック
し、フォームの名前を入力してください。 デフォルトでは、フォームの一般設定において、ユーザー向けのチャットに表示される指示を追加するために使用される「 指示 」トグルスイッチはオフに設定されています。 ユーザーに指示を提供したい場合は、スイッチをオンに設定してください。プライマリアクションセクションでは、 フォームのプライマリアクションボタンを設定できます。
プライマリアクションボタンは、フォームを完了するための主要なユーザーアクションを表します。 デフォルトでは、主要なアクションは 「送信 」であり、必要に応じて名前を変更できます。
追加アクションセクションでは、フォームにアクションボタンを追加できます。
複数の完了アクションを設定するには、 [追加アクション] フィールドの [アクションを追加] ボタンを選択してください。 追加アクションの名前を入力できる入力フィールドが表示されます。
追加のアクションボタンはそれぞれ、ワークフロー内に独立した分岐を作成します。これらは既存の主要アクション分岐と並んで、アクション名でラベル付けされた別々のパスとしてフォーム下に表示されます。
追加アクション分岐ごとにフロー項目を追加し、そのアクションのワークフローロジックを定義できます。
フォームには最大3つの追加アクションボタンを追加できます。 複数の追加アクションが定義されている場合、ボタンはフォーム上の 「アクション 」ドロップダウンにグループ化されます。
キャンセルセクションでは、フォームのキャンセルボタンを設定できます。
キャンセルボタンの名前を変更するテキストを入力できます。
フォームからキャンセルボタンを削除するには、トグルスイッチをオフに設定してください。
「追加」 フィールドまたは「追加」アイコンにカーソルを
合わせ、 [ユーザーから収集] または [ユーザーに提示] を選択して、フォームにフィールド（ユーザー操作の種類）を追加します。
ユーザーから情報を収集するためのフィールドを追加したり、チャット内でユーザーに情報を表示したり、ユーザーの入力に応じてフィールドの動作を制御する動的なルールを定義したりすることができます。 詳細については、 「ユーザーからの入力収集 」、 「ユーザーへの提示」、および「 動的フォーム」 を参照してください。
ユーザーから入力を受け取る
フォームでユーザーから情報を収集するには、以下のいずれかのフィールドを追加します：
ブール値
ブーリアンオプションは、ユーザーがチャットでブーリアンオプションを指定できるようにします。 フォームにブーリアンフィールドを追加して、ユーザが指定したデータを下流ノードに渡すことができます。 フォームにブーリアン・フィールドを追加する：
フォームのダイアログで、 「フィールドの追加」 をクリックするか、[追加] アイコン
をクリックします。ユーザーから収集を選択
Booleanを選択する。
一般 > ラベルで、チャットでユーザーに表示されるこのフィールドのテキストを入力します。
外観 > 表示方法で、ブーリアンフィールドがチャットでどのように表示されるかを選択します。
ラジオボタンの Trueラベルと Falseラベルオプションでは、ブーリアンオプションのためにチャットでユーザーに表示されるテキストを変更することができます。
ビヘイビアでは、変数、式、オートマッピングのオプションを使って、ブーリアン・フィールドの初期値を指定することができる。 初期値はチャットのデフォルト値として使用され、ユーザーが素早くフォームを完了するのに役立ちます。 ユーザーはこの値を受け入れるか、変更することができる。
trueまたはfalseの初期値を指定したい場合は、オートマッピングを終了して値を指定する。
フォームにブーリアン・フィールドが追加されました。 次の例は、チャットでの表示方法を示しています。
日付/時刻
フォームに日付と時刻のフィールドを追加して、日付、時刻、またはその両方を収集することができます。 このフィールドは、開始日、終了日、期限日、またはリマインダーの日時の選択といったワークフローのシナリオに対応しています。 ユーザーがチャットで選択した値は取得され、エージェントワークフローで使用されます。
フォームに日付と時刻のフィールドを追加するには：
フォームのダイアログで、 「フィールドの追加」 をクリックするか、[追加] アイコン
をクリックします。ユーザーから収集を選択
日付と時刻を選択してください。
[ 全般 ] > [ラベル] で、チャット画面にユーザーに表示されるテキストを入力します。
「 複数日付 」スイッチをオンにすると、ユーザーが複数の日付を選択できるようになります。 そうでない場合は、スイッチをオフにしてください。 「 複数日付 」オプションは、入力タイプが「 日付」 の場合にのみ利用可能です。
チャットでこのフィールドの選択を必須にするには、 必須スイッチをオンに設定します。 そうでない場合は、スイッチをオフにしてください。
「 入力タイプ 」で、収集したい入力の種類を選択してください。 ユーザーが入力する必要がある値に応じて、 「日付」、 「時刻 」、または 「日付と時刻 」を選択できます。
[Behavior ] で、 [Initial value ] スイッチをオンにして、日付または時刻フィールドのデフォルト値を定義します。 すべての入力型について、変数や式を使用して初期値を設定できます。 入力タイプが「 Date」 の場合は、自動マッピングを使用することもできます。 ユーザーはチャット内で初期値を受け入れるか、変更することができます。
[Behavior ] で、[ Input range ] スイッチをオンにして、日付、時刻、または日付と時刻のフィールドの有効範囲を定義します。 「開始」および「終了」のフィールドは、選択した入力タイプに応じて変化します。 すべての入力型において、変数または式を使用して開始値と終了値を定義できます。 入力タイプが「 Date」 の場合は、自動マッピングを使用することもできます。
日付/時刻範囲
フォームに日付と時間の範囲指定フィールドを追加することで、ユーザーがチャット内で開始日時と終了日時を指定できるようになります。 範囲のタイプは、日付または時刻のいずれかです。 ユーザーが指定したこれらの値は、休暇申請やスケジュール管理、あるいは特定の範囲を必要とするあらゆるワークフローにおいて、エージェント型ワークフローで使用することができます。
フォームに日付と時刻の範囲を入力するフィールドを追加するには：
フォームのダイアログで、 「フィールドの追加」 をクリックするか、[追加] アイコン
をクリックします。ユーザーから収集を選択
日付と時間の範囲を選択してください。
[ 全般 ] > [ラベル] で、チャット画面にユーザーに表示されるテキストを入力します。
チャットでこのフィールドの選択を必須にするには、 必須スイッチをオンに設定します。 そうでない場合は、スイッチをオフにしてください。
「範囲」 タイプで、ユーザーが入力する必要がある範囲を選択してください。 ユーザーが指定する必要がある値に応じて、 「日付 」または「 時刻 」を選択できます。
「 外観」 で、チャット画面にユーザーに表示される開始フィールドと終了フィールドのラベルを入力します。 使用可能なラベルフィールドは、選択した範囲の種類によって異なります。
[Behavior] で、[ Initial value ] スイッチをオンに設定すると、日付または時刻のデフォルトの開始値と終了値を定義できます。 field.You では、すべての範囲タイプについて、変数または式を使用して開始値と終了値を設定できます。 範囲の型が「 日付」 の場合は、自動マッピングを使用することもできます。 ユーザーはチャット内で初期値を受け入れるか、変更することができます。
「 日付範囲の制限 」または「 時間範囲の制限 」スイッチをオンにして、日付または時間フィールドの有効範囲を定義します。 「開始」および「終了」のフィールドは、選択した範囲の種類に応じて変わります。 どちらの範囲タイプでも、変数または式を使用して開始値と終了値を定義できます。 範囲の型が「 日付」 の場合は、自動マッピングを使用することもできます。
フォームに日付と時間の範囲指定フィールドが追加されました。 次の例は、チャット内で日付範囲フィールドがどのように表示されるかを示しています。
ファイルのアップロード
フォームにファイルアップロードフィールドを追加できます。 このフィールドは、ドキュメント処理、コラボレーション、要約の生成など、ユーザーがチャットでファイルをアップロードできるエージェント型ワークフローに便利です。
フォームにファイルアップロードフィールドを追加する：
フォームのダイアログで、 「フィールドの追加」 をクリックするか、[追加] アイコン
をクリックします。ユーザーから収集を選択
ファイルアップロードを選択します。
一般 > ラベルで、チャットでユーザーに表示されるこのフィールドのテキストを入力します。
複数のファイルのアップロードを許可するには、 Allow multiple files スイッチをオンに設定します。 チャットでこのフィールド選択を必須にするには、 必須スイッチをオンに設定します。
外観 > 使い方 」では、ユーザーがファイルをアップロードする際に役立つ使い方を入力するか、「 使い方を生成 」をクリックして「 動作 」で選択したファイルサイズとファイルタイプに基づいて使い方を自動生成することができます。
ボタンラベルオプションでは、ファイルアップロードフィールドのラベルを指定できます。
Behaviorでは、ユーザーがアップロードできるサポートされているファイルタイプと最大ファイルサイズ制限を指定できます。
「複数のファイルを許可する」 スイッチがオンになっている場合、ファイルのアップロード制限を設定できます。 ファイルのアップロード制限を設定するには、 「ファイルのアップロード制限 」スイッチをオンにし、ファイルの最小数と最大数を入力してください。
ファイルアップロードフィールドがフォームに追加されました。 次の例は、チャットでの表示方法を示しています。
リスト
ユーザーから情報のリストを収集する必要がある場合、フォームにリストフィールドを追加できます。 リスト項目は、文字列や日付などのプリミティブデータ型、またはフライト詳細などのオブジェクトデータ型のいずれかです。
フォームにリストフィールドを追加するには：
フォームのダイアログで、 「フィールドの追加」 をクリックするか、[追加] アイコン
をクリックします。ユーザーから収集を選択
リストを選択する。
一般 > ラベルで、チャットでユーザーに表示されるこのフィールドのテキストを入力します。
ソース変数では、変数または式を使用してリストのソースを指定できます。
ソース変数としてオブジェクトのリストを指定した場合、データをテーブル形式で表示することを選択できます。 [表示] セクションで、 [要素の編集] をクリックし、リストの要素がユーザーにどのように表示されるかを設定します。 「要素を編集」 をクリックすると、要素を管理できる専用のダイアログが開きます。
「 要素の編集 」では、以下の操作が可能です：
要素の順序を変更する ： をドラッグして
表示順序を変更します。表示設定 ： 表示アイコンをクリックして、個々の要素を非表示にします。
ラベルの編集 ： 「要素ラベル 」列のテキストを変更して、各要素がユーザーにどのように表示されるかをカスタマイズします。
ラベルを整理 ： [ラベルを整理] をクリックすると、すべてのラベルの書式が自動的に整えられます。
ラベルのリセット ： 「ラベルのリセット」 をクリックすると、すべてのラベルがソース変数の元の値に戻ります。
[動作] セクションでは、ユーザーがリストとどのようにやり取りできるかを設定できます。
ユーザーがリストに項目を追加できるようにするには、 「追加を許可」 スイッチをオンに設定してください。 ユーザーがリストから項目を削除できるようにするには、 [削除を許可] スイッチをオンに設定してください。
複数選択
チャットのリストから複数のオプションを収集するために、フォームにマルチチョイスフィールドを追加することができます。 ユーザーが指定したオプションは、エージェントワークフローによって使用される。 このフィールドは、レポートの複数の部門、タスクの複数のカテゴリなど、ユーザーがチャットで複数のオプションを選択できるエージェント型ワークフローに便利です。
フォームに複数選択肢フィールドを追加するには：
フォームのダイアログで、 「フィールドの追加」 をクリックするか、[追加] アイコン
をクリックします。ユーザーから収集を選択
マルチを選択。
一般 > ラベルで、チャットでユーザーに表示されるこのフィールドのテキストを入力します。
チャットでこのフィールドの選択を必須にするには、 必須スイッチをオンに設定します。 そうでない場合は、スイッチをオフにしてください。
「ソース変数」 では、変数または式を使用して、リストのソースを指定できます。
データを定義するオブジェクトのリストであるソース変数を指定した場合、そのデータをドロップダウンリストとして表示するか、表として表示するかを選択できます。 表示形式を選択するには、 「外観 」 ＞「表示形式」で、 「ドロップダウン 」または「 表」 を選択します。
「 ドロップダウン 」オプションを選択した場合は、変数または式を使用して、 リスト内の各リスト項目の表示名を設定します。
「 テーブル 」オプションを選択した場合は、 「列の編集」 をクリックして、ユーザーへの列の表示方法を設定してください。 「 列の編集」 をクリックすると、要素を管理できる専用のダイアログが開きます。
「 要素の編集 」では、以下の操作が可能です：
要素の順序を変更する ： をドラッグして
表示順序を変更します。表示設定 ： 表示アイコンをクリックして、個々の要素を非表示にします。
ラベルの編集 ： 「要素ラベル 」列のテキストを変更して、各要素がユーザーにどのように表示されるかをカスタマイズします。
ラベルを整理 ： [ラベルを整理] をクリックすると、すべてのラベルの書式が自動的に整えられます。
ラベルのリセット ： 「ラベルのリセット」 をクリックすると、すべてのラベルがソース変数の元の値に戻ります。
プレースホルダー・テキスト・オプションでは、ドロップダウンリストが空のときにユーザーに表示されるテキストを指定することもできます。
ビヘイビアでは、変数、式、オートマッピングオプションを使ってリストの初期値を指定できる。 初期値はチャットのデフォルト値として使用され、ユーザーが素早くフォームを完了するのに役立ちます。 ユーザーはこの値を受け入れるか、変更することができる。 また、次のように指定することもできます
初期値として使用する特定の値を指定したい場合は、オートマッピングを終了して値を入力する。
リスト内でユーザーが選択できる項目の数を制限するには、 「選択数制限 」オプションを使用して、選択可能な最小数と最大数を指定します。 たとえば、ユーザーが最低2つ、最高5つの項目を選択しなければならない場合、選択の制限を指定します。
フォームに複数選択フィールドが追加されました。 次の例は、チャットでの表示方法を示しています。
数値
チャットでユーザーから数値入力を収集するために、フォームに数値フィールドを追加することができます。 数値入力は、その後、エージェントのワークフローによって使用される。 例えば、ユーザーはチケットID、アイテムの数量、日数などをチャットで指定することができます。
フォームに数字フィールドを追加するには
フォームのダイアログで、 「フィールドの追加」 をクリックするか、[追加] アイコン
をクリックします。ユーザーから収集を選択
番号を選択してください。
一般 > ラベルで、チャットでユーザーに表示されるこのフィールドのテキストを入力します。
チャットでこのフィールドの選択を必須にするには、 必須スイッチをオンに設定します。 そうでない場合は、スイッチをオフにしてください。
Input type（入力タイプ ）で、数値の整数型か10進数型を指定する。
外観では、数字フィールドのヘルパーテキストを追加できます。 ヘルパー テキストを追加するには、 ヘルパー テキストスイッチをオンに設定します。 そうでない場合は、スイッチをオフにしてください。
ビヘイビアでは、変数、式、オートマッピングオプションを使って数値の初期値を指定できる。 初期値を追加するには、 初期値スイッチをオンに設定する。 そうでない場合は、スイッチをオフにしてください。 初期値はチャットのデフォルト値として使用され、ユーザーが素早くフォームを完了するのに役立ちます。 ユーザーはこの値を受け入れるか、変更することができる。
初期値として使用する特定の値を指定したい場合は、オートマッピングを終了して値を入力する。
また、数値フィールドに範囲を指定することもできます。例えば、ユーザーは10～20の間の数値を選ぶことができます。 範囲を追加するには、 入力範囲スイッチをオンに設定する。 そうでない場合は、スイッチをオフにしてください。 変数、式、オートマッピングオプションを使用して、範囲の最小値と最大値を指定できます。 最小値または最大値として使用する特定の値を指定するには、オートマッピングを終了して値を入力する。
これでフォームに数字フィールドが追加されました。 次の例は、チャットでの表示方法を示しています。
単一選択
チャットのリストからオプションを収集するために、フォームに単一選択フィールドを追加することができます。 ユーザが指定したオプションは、エージェントワークフローによって使用される。 このフィールドは、ユーザーが部署、組織などのチャットで単一のオプションを選択できるエージェントワークフローに便利です。
フォームに単一選択肢フィールドを追加するには
フォームのダイアログで、 「フィールドの追加」 をクリックするか、[追加] アイコン
をクリックします。ユーザーから収集を選択
シングルを選択。
一般 > ラベルで、チャットでユーザーに表示されるこのフィールドのテキストを入力します。
チャットでこのフィールドの選択を必須にするには、 必須スイッチをオンに設定します。 そうでない場合は、スイッチをオフにしてください。
「ソース変数」 では、変数または式を使用して、リストのソースを指定できます。
データを定義するオブジェクトのリストであるソース変数を指定した場合、そのデータをドロップダウンリストとして表示するか、表として表示するかを選択できます。 表示形式を選択するには、 「外観 」 ＞「表示形式」で、 「ドロップダウン 」または「 表」 を選択します。
この ドロップダウン オプションを選択する場合は、変数または式を使用して 各リスト項目の表示名を設定する 、各リスト項目の名前を で指定してください。
「 テーブル 」オプションを選択した場合は、 「列の編集」 をクリックして、ユーザーへの列の表示方法を設定してください。 「 列の編集」 をクリックすると、要素を管理できる専用のダイアログが開きます。
「 要素の編集 」では、以下の操作が可能です：
要素の順序を変更する ： をドラッグして
表示順序を変更します。表示設定 ： 表示アイコンをクリックして、個々の要素を非表示にします。
ラベルの編集 ： 「要素ラベル 」列のテキストを変更して、各要素がユーザーにどのように表示されるかをカスタマイズします。
ラベルを整理 ： [ラベルを整理] をクリックすると、すべてのラベルの書式が自動的に整えられます。
ラベルのリセット ： 「ラベルのリセット」 をクリックすると、すべてのラベルがソース変数の元の値に戻ります。
プレースホルダー・テキスト・オプションでは、ドロップダウンリストが空のときにユーザーに表示されるテキストを指定することもできます。
外観では、リストが空のときにチャットでユーザーに表示されるプレースホルダーテキストを追加できます。
ビヘイビアでは、変数、式、オートマッピングオプションを使ってリストの初期値を指定できる。 初期値はチャットのデフォルト値として使用され、ユーザーが素早くフォームを完了するのに役立ちます。 ユーザーはこの値を受け入れるか、変更することができる。
初期値として使用する特定の値を指定したい場合は、オートマッピングを終了して値を入力する。
これでフォームに選択肢フィールドが1つ追加されました。 次の例は、チャットでの表示方法を示しています。
テキスト
チャットのユーザーからテキストデータを収集するために、フォームにテキストフィールドを追加することができます。 そして、ユーザが指定したテキストは、エージェントのワークフローによって使用される。 例えば、ユーザーはコメントやフィードバックに対する返答、問題やタスクの説明などをチャットで入力することができる。
フォームにテキスト・フィールドを追加するには
フォームのダイアログで、 「フィールドの追加」 をクリックするか、[追加] アイコン
をクリックします。ユーザーから収集を選択
テキストを選択する。
一般 > ラベルで、チャットでユーザーに表示されるこのフィールドのテキストを入力します。
チャットでこのフィールドの選択を必須にするには、 必須スイッチをオンに設定します。 そうでない場合は、スイッチをオフにしてください。
入力タイプでは、テキストのタイプを単一行または複数行のいずれかに指定できます。
外観では、テキスト・フィールドにプレースホルダー・テキストとヘルパー・テキストを追加できます。 プレースホルダー テキストを追加するには、 プレースホルダー テキストスイッチをオンに設定し、ヘルパー テキストを追加するには、 ヘルパー テキストスイッチをオンに設定します。 そうでない場合は、スイッチをオフにしてください。
ビヘイビアでは、変数、式、オートマッピングオプションを使って、テキストフィールドの初期値を指定することができます。 初期値はチャットのデフォルト値として使用され、ユーザーが素早くフォームを完了するのに役立ちます。 ユーザーはこの値を受け入れるか、変更することができる。
特定の初期値を指定したい場合は、オートマッピングを終了して値を入力する。
許可される形式を定義するために、正規表現（regex）を指定できます。 正規表現を指定するには、 Regex検証スイッチをオンにし、正規表現を指定します。 このフォームの入力欄には、指定したパターンに一致するテキストのみ入力できます。 「 正規表現のエラーメッセージ」 では、検証時のエラーメッセージを指定できます。
エージェント型ワークフローにおけるデータのマッピングの詳細については、 データのマッピングを参照してください。
これでフォームにテキストフィールドが追加されました。 次の例は、チャットでの表示方法を示しています。
ユーザーに提示する
フォームでユーザーに情報を表示するには、以下のデータタイプのいずれかを使用できます：
フィールド
チャットでユーザーにデータを表示するために、フォームにフィールドを追加することができます。
フォームにフィールドを追加するには
フォームのダイアログで、 「フィールドの追加」 をクリックするか、[追加] アイコン
をクリックします。ユーザーにプレゼントを選択する。
フィールドを選択する。
一般 > ラベルで、チャットでユーザーに表示されるフィールドのテキストを入力します。
一般 > ソースでは、変数または式を使用してデータのソースを指定できます。
リスト
エージェントのワークフローで複数の情報を表示するために、フォームにリストを追加することができます。 例えば、チャットの優先順位、ステータス、その他の情報を整理してユーザーに表示することができます。
フォームにリストを追加するには
フォームのダイアログで、 「フィールドの追加」 をクリックするか、[追加] アイコン
をクリックします。ユーザーにプレゼントを選択する。
リストを選択する。
一般 > 選択リストのソースを選択 で、変数または式を使用してリストのソースを指定します。
データを定義するソース変数を配列オブジェクトとして指定した場合、データを表として表示することを選択できます。 列」 リストに表示する列をカスタマイズすることができます。
選択した列ラベルを編集するには、 列ラベルの編集をクリックし、各項目のラベルを指定します。 また、「 ラベルを整頓 」をクリックすると、ラベルが自動的にフォーマットされます。
メッセージ
エージェント型ワークフローで情報を表示するために、フォームにメッセージを追加することができます。 例えば、エージェントのワークフローの結果をチャットに表示することで、ユーザーの理解を助けることができます。
メッセージ内で中括弧をプレーンテキストとして表示したい場合は、二重中括弧でエスケープしてください。 たとえば、 {{customer_id}} は出力メッセージで {customer_id} と表示され、二重中括弧内のテキストは変数ではなくプレーンテキストとして扱われます。
フォームにメッセージを追加するには
フォームのダイアログで、 「フィールドの追加」 をクリックするか、[追加] アイコン
をクリックします。ユーザーにプレゼントを選択する。
「メッセージ」を選択します。
[一般] > [出力メッセージ] に、メッセージを入力します。 メッセージの中で変数を使うこともできる。
FILE
エージェントのワークフローで生成されたファイルをユーザーがダウンロードできるように、フォームにファイルフィールドを追加できます。 例えば、ユーザーはチャットの中でレポートやその他のファイルをダウンロードすることができます。
フォームにファイルダウンロードフィールドを追加する：
フォームのダイアログで、 「フィールドの追加」 をクリックするか、[追加] アイコン
をクリックします。ユーザーにプレゼントを選択する。
ファイルのダウンロードを選択します。
一般 > ラベルで、チャットでユーザーに表示されるこのフィールドのテキストを入力します。
一般 > ソース・ファイルでは、変数または式を使用してソース・ファイルを指定できます。
エージェント型ワークフローは、特定のビジネス目的または目標を達成するために設計された、一連のリンクされたアクティビティとコントロールを定義する。 エージェント型ワークフローについて詳しくはこちら。
動的フォーム
動的フォームを使用すれば、フィールドを複製したり個別のフォームを作成したりすることなく、1つのフォームで複数のユースケースに対応できます。 ユーザーがフォームを操作すると、入力欄は動的に反応し、ユーザーの入力に応じて動作が変わります。 すべての項目を一括して表示するのではなく、ユーザーが選択を行うたびにフォームが更新され、関連する項目、ラベル、および値のみが表示されるようになっています。
動的な挙動は、動的ルールを使用して定義されます。 動的ルールはワークフロービルダー上で視覚的に設定でき、スクリプトや独自のロジックは必要ありません。 ルールはフォーム内で適用され、あるフィールドが他のフィールドの動作にどのように影響するかを決定します。 動的フォームは、場所、カテゴリ、役割、または以前の回答など、ユーザーの入力に基づいてデータ収集内容を適応させます。
1つのフォームには、複数の動的ルールを含めることができます。 1つのフィールドに対して複数のルールが適用されることがあり、各ルールは個別に評価されます。 動的ルールは下流のフィールドにのみ適用されます。 制御フィールドは、トリガーフィールドの後に配置する必要があります。 この順序付けにより、予測可能な動作が保証され、循環依存関係が回避されます。
動的ルールは、フォーム定義内のフィールド間に挿入でき、動的ラベル、表示設定、段階的選択など、さまざまなルールタイプを制御するように設定できます。 ルールの動作は、ルールのプロパティを通じて設定されます。
動的フォームでは、以下のルールタイプがサポートされています：
動的ラベル
動的ラベル規則は、条件付きフィールドに表示されるラベルテキストを制御します。 これらのルールにより、同じフィールドでもユーザーの入力に応じて異なるラベルテキストを表示できるようになり、1つのフォーム内で状況に応じた用語の使用が可能になります。
動的ラベルルールでは、同じフィールドに対して複数のルールを設定でき、各ルールには複数の条件を含めることができます。 条件が満たされると、ルールで定義されたラベルが適用されます。 条件が満たされない場合のために、別のラベルを定義することもできます。
表示設定
表示設定ルールは、トリガーフィールドの値に基づいて、条件付きフィールドを表示するか非表示にするかを制御します。 これらのルールは、関連するフィールドのみを表示することで、フォームの複雑さを軽減するために使用されます。
可視性ルールは、1つ以上の条件を評価し、条件付きフィールドの可視性状態を決定します。 1つのルール内で条件を組み合わせることができるため、複数の入力シナリオに対する表示動作を定義できます。 表示設定は、フィールドが表示されるかどうかのみに影響し、フィールドのラベルや値を変更することはありません。
段階的選択
プログレッシブ・セレクト・ルールは、条件付きフィールドのドロップダウン値がどのように設定されるかを制御します。 これらのルールは、トリガーフィールドの値が変更された際にツールを実行することで、動的に値を取得します。
条件を使用する代わりに、プログレッシブ・セレクト・ルールは、選択されたツールの出力に依存します。 このツールはワークフロービルダーで設定され、ドロップダウンフィールドに表示される値を提供します。 トリガーフィールドが変更されると、ツールが再実行され、利用可能なオプションが更新されます。
フォームに動的ルールを追加する
フォームに動的ルールを追加するには：
フォームのダイアログで、 「フィールドの追加」 をクリックするか、[追加] アイコン
をクリックします。「動的ルール」 を選択します。
ルールタイプを選択してください：
動的ラベル
表示設定
段階的選択
ルールプロパティで：
名前を入力してください。
イベントトリガー フィールドを選択してください。
1つ以上の条件付きフィールドを選択してください。
フォームに動的ルールが追加されます。 ルールは作成されましたが、まだ動作は定義されていません。
各動的ルールは、以下のプロパティで構成されています：
イベント・トリガー
イベントトリガーは、値が変更された際にルールが評価されるフィールドを指定します。 選択したイベントトリガーフィールドの値が変更されると、ルールが実行され、その動作が選択した条件付きフィールドに適用されます。
ルールが追加され、設定されると、その関係性がトリガーフィールドに反映されます。 トリガーフィールドのプロパティには、「イベントトリガー」セクションがあり、そのフィールドによってトリガーされるすべてのルールが一覧表示されます。
「イベントトリガー」 に一覧表示されている各項目について、どの条件フィールドが影響を受けるかを確認でき、 「ルールを編集」 を選択すると、ルール設定画面を直接開くことができます。
この機能により、フォーム上で動的ルールを開かなくても、トリガーフィールドからルールの動作を確認・変更することができます。
条件付きフィールド
条件付きフィールドとは、動的なルールによって動作が制御される下流のフィールドのことです。 これらのフィールドは、フォーム内のイベントトリガーの後に表示されるフィールド一覧から選択されます。 「条件付きフィールド」でフィールドを選択すると、そのルールによって制御できるフィールドが特定されます。 条件付きフィールドを選択しても、それだけでは動作が定義されるわけではなく、そのフィールドがルールに適用されるかどうかが決まるだけです。
選択された条件付きフィールド
「選択された条件フィールド」リストには、現在そのルールに関連付けられているフィールドが表示されます。 このリストの各フィールドは、ルールが適用できる条件付きフィールドを表しています。 選択した各条件フィールドについて、 「ルールを追加 」オプションが利用可能です。 「ルールを追加」を選択すると、そのルール専用の設定ウィンドウが開き、ラベルの変更、表示設定、値のソース設定など、そのフィールドの動作を定義できます。
動的ラベルと表示ルールの設定
動的なラベルと表示設定は、同じ手順で設定します。 どちらのルールタイプも、トリガーフィールドの値が変更された際に条件付きフィールドがどのように動作するかを決定するために条件を使用します。
フォームに動的ラベルまたは表示ルールを設定するには：
「 動的ラベル 」または「 表示設定ルール 」の動的ルールを選択してください。
ルールのプロパティで、「選択された条件フィールド」の下にある 「ルールを追加 」を選択します。
「条件」フィールドの設定では：
「If 」セクションでデフォルトの条件を設定します。
さらに条件を追加するには、 「条件を追加」 を選択してください。
ルールの処理結果を設定します：
動的なラベルルールを作成するには、 「Then 」セクションでラベルのテキストを指定してください。
表示ルールについては、「 Then 」セクションで、そのフィールドを表示するか非表示にするかを指定します。
「Else 」セクションで別の処理を指定します。
保存 をクリックします。
動的ラベルルールについては、もう一度 「ルールを追加」 を選択して、同じフィールドに対して別のルールを定義してください。
表示ルールについては、 「条件を追加」 を選択して、同じルール内に条件を追加し続けてください。
プログレッシブ・セレクト・ルールの設定
フォームにプログレッシブ・セレクト・ルールを設定するには：
プログレッシブ・セレクト・ルール用の動的ルールを選択してください。
「プログレッシブ選択」ルールで、「選択された条件付きフィールド」の下にある 「ルールを追加 」を選択します。
「条件」フィールドの設定で、 「ツールを選択」 をクリックし、表示されたリストからツールを選択します。
必要に応じて、ツールの入力設定を行ってください。
保存 をクリックします。