式の作成

ステップ条件での式の使用

会話中に収集した情報に基づいて計算結果をステップの条件とする場合、ステップの条件に式を使用できます。

例えば、ある顧客が普通預金口座に200ドル持っていて、そこから150ドルを新しい当座預金口座に移したいとする。 振り替え手数料は 3 ドルです。また、この銀行は、普通預金口座の残高が 50 ドル未満の場合に手数料がかかります。 この状態を検査するステップ条件を持つステップを作成できます。 このステップ条件では、次のような式が使用されます。

${savings} - (${Step_232} + ${transfer_fee}) < 50

ここで、それぞれ以下のとおりです。

• ${savings} は、顧客の普通預金口座の合計額を保管するセッション変数を表します。

• ${Step_232} は、振り替える金額を顧客に尋ねるステップを表します。

• ${transfer_fee} は、資金の振り替えの手数料を指定するセッション変数を表します。

ステップ条件が満たされると、そのステップは、要求された送金によって普通預金口座残高が最低 $50 を下回り、手数料が発生することをユーザーに警告し、先に進む前に確認を求めます。

ステップ条件で式を使用するには、以下の手順に従います：

1. そのステップで、 「条件を追加」 をクリックします。

最も使用される可能性が高い選択肢 (通常は、前のステップで設定された変数) を使用した条件が自動的に生成されます。

1. 生成された条件の最初のセグメントをクリックしてから、スクロールダウンして「式 (Expression)」をクリックします。

2. （任意）： [ 展開] アイコンをクリックして、式エディタウィンドウを開きます。 (ウィンドウを開かずにフィールドに直接式を入力することもできるが、エディタを使えば、より長い式やより複雑な式を簡単に編集できる)

3. 使用したい式を入力する。

式を使ってセッション変数に値を代入する

セッション変数に値を割り当てる際に、文字列を結合したり数値を計算したりするには、以下の例式を使用できます

文字列の結合 ：複数の文字列またはテキスト値を結合するには、式の中で + 記号を使用します。

${session_variable_1} + " some string of text " + ${session_variable_2}

結果として得られる値は、 session_variable_1 の内容に続いて、 " some string of text " 、 session_variable_2 の値となります。

数値計算 ：他の変数に基づいて値を計算するには、式を使用します。

例えば、6％の消費税と一律33.00ドルの手数料を含む、購入金額の合計を顧客に伝えたいとします。 合計金額を計算するには、セッション変数を作成し、式を使用して値を割り当てます

(${price} * 1.06) + 3

そして、アシスタントの発言フィールドでこの変数を参照することができます。

セッション変数に値を代入するときに式を使うには、以下の手順に従います：

1. ステップの中から、Set variable values をクリックする。

2. 新しい値を設定」をクリックする。

3. ドロップダウン・リストから、値の保管場所となるセッション変数を選択します。

4. に続いて、Expressionを選択する。

5. 使いたい表現を入力する。

6. エクスプレッション・エディタを使用している場合は、Applyをクリックして変更を保存し、エディタ・ウィンドウを閉じます。

式を使ってセッション変数に初期値を割り当てることもできる。 セッション変数ウィンドウで、初期値フィールドに移動し、式を使用するをクリックする。

最初に変数を選ばずに直接式を書くこともできる：

1. ステップの中から、Set variable values をクリックする。

2. 新しい値を設定」をクリックする。

3. ドロップダウンリストから、Expressionを選択する。

4. 使いたい表現を入力する。

5. エクスプレッション・エディタを使用している場合は、Applyをクリックして変更を保存し、エディタ・ウィンドウを閉じます。

式の構文

このAIアシスタントの式言語は、Spring Expression Language（ SpEL ）をベースとしていますが、構文にはいくつかの重要な違いがあります。 SpEL, に関する詳細な背景情報については、 「Spring Expression Language」（ SpEL ） を参照してください。

{
  "name": {
    "firstname": "John",
    "lastname": "Doe"
  },
  "age": 36
}

{
  "temp_1": ${temp_1},
  "temp_2": ${temp_2},
  "avg_temp": (${temp_1} + ${temp_2}) / 2
}