リスト変数を使用すると、外部データを使用して顧客向けの動的な回答リストを作成でき、ファイル変数を使用すると、ユーザーは所定のファイルをアップロードすることができます。
一般的な変数の管理方法については、こちらを参照してください。
-リスト変数
リスト変数には３つの異なるタイプがあります。
・文字列リスト
・JSON
・JSONリスト
すべてのタイプのリスト変数を利用するには、JSONに関する基本的な知識が必要となります。
＜STEP１．リスト変数を作成＞
Alliダッシュボードにログインして、文字列型変数の作成を開始します。
変数の作成方法は以下の２パターンがあります。
- [設定]メニューから変数を作成する
[設定]> [変数]> [カスタム]に移動し、[+追加]をクリックします。
2. チャットフロー編集で変数を作成する
チャット編集画面でノードに新しい変数を追加します。[応答内容を以下で保存する]直下のドロップダウンメニューから[新しい変数を作成]をクリックします。
変数追加画面の[タイプ]選択にて“文字列リスト”、“JSON”、“JSONリスト”から選択します。 変数の名前と説明も入力して保存します。
3. チャット編集内＠変数リストメニューから作成する
＜STEP 2． JSON形式でデータポイントを準備する＞
使用する変数に応じて、適切な形式でリストを準備します。
以下に例を示します。
{
"STR_LIST_VAR" : ["TypeA", "TypeB", "TypeNew"],
"JSON_VAR":{"empno":1, "name":"Chris", "email":"Chris@allganize.ai"},
"JSON_LIST_VAR":[
{"empno":1, "name":"James", "email":"James@allganize.ai"},
{"empno":2, "name":"Peter", "email":"Peter@allganize.ai"}
]
}
キーが変数の名前と一致することを確認してください。 上記の例では、STR_LIST_VAR、JSON_VAR、JSON_LIST_VARが各変数の名前である必要があります。
＜STEP３．チャットフローを設計する＞
【外部データ連携】ノードを使用して、設定したデータポイントからデータを取得します。 リスト変数を使用する前に、外部データ連携ノード（設定の参照はこちら）および会話応答ノードを配置する必要があります。
【会話・質問応答】ノードで、[応答の追加]に☑を入れ、[+動的応答オプションの追加]をクリック後、🖊をクリックし、[動的応答オプションの編集]にて、使用する変数を選択します。
JSONまたはJSONリストを使用している場合は、DisplayパスとバリューパスをJSON形式で入力する必要があります。
Displayパスは、チャットフローで顧客に表示されるオプション用であり、バリューパスは、顧客がオプションを選択したときに返される値用です。
＜STEP４．リストの表示を確認＞
PREVIEWを使用して、リストが意図したとおりに表示されるかどうかを確認できます。
-ファイル変数
File変数の使用は非常に簡単です。
＜STEP１.ファイル変数の作成＞
変数タイプとして[ファイル]を選択する以外は、上記のリスト変数のSTEP１と同じ内容です。
＜STEP２.チャットフローの設計＞
【会話・質問応答】ノードまたは【入力フォーム】ノードでFile変数を使用できます。
【会話・質問応答】ノードで、[応答追加]をオンにして、応答種別として[ファイル]を選択し、[応答の保存先]としてファイル変数を選択します。
【入力フォーム】ノードで、フィールドの変数の１つとして[ファイル]変数を選択します。
＜STEP３.動作確認＞
設定した内容の動作を確認します。
【会話・質問応答】ノードの場合、ユーザーは[クリップ]アイコンをクリックしてファイルをアップロードできます。
【入力フォーム】ノードの場合、[ファイルを添付]をクリックし、該当ファイルをアップロードすることができます。
Dashboardのユーザーリスト内でもアップロードされたファイルが表示・確認できます。
