グローバル変数の使用方法

Kore.ai Botプラットフォームは、Bot内で変数を宣言および使用する方法を提供します。これらの変数を使用すると、別のタスク、ノードおよびその他のBot要素で一般的に使用される値を取得できます。このハウツーでは、Bot変数を使用できるバンキングBotでシナリオを調査します。グローバル変数をどのように使用して、APIエンドポイントをパスし、開発からテストおよび本稼働環境に移行するときに簡単に変更できるかを確認します。Bot変数とは何か、およびKore.ai Botプラットフォームでの実装方法の詳細については、こちらを参照してください。コンテンツ変数での使用ケースについては、こちらを参照してください。

例題

当社のバンキングBot には、以下の2つのタスクがあります。

1. 残高の確認、指定口座番号でサービスを呼び出し、そのアカウントの残高を確認します。
2. 残高を更新、サービスを呼び出し、指定した金額で指定口座を更新します。
3. 上記のタスクはどちらも同じサービスを呼び出し、サービスAPI エンドポイントは開発、テストおよび本稼働環境用に変更されます。
4. どちらのダイアログタスクにおけるサービス呼び出しの変更も面倒で、変更が正しく行われないとエラーになります。

この文書では、どのようにグローバル変数を使用してAPIエンドポイントを格納でき、サービス呼び出しに使用できるかを確認します。

Pre-requisites

• Botビルドナレッジ
• 以下で述べるダイアログ付きバンキングBot。
  • 残高の確認 – ユーザーに口座番号をプロンプト表示し、口座で使用できる残高を表示するダイアログタスク。
  • 口座を更新 – ユーザーに更新する必要がある口座番号、更新される金額、金額を入金または出金して口座残高を更新する必要があるかどうかをプロンプト表示するダイアログタスク。

導入

グローバル変数を宣言してAPIエンドポイントを保持すると、移行を簡単かつ迅速にする上で役立ちます。

1. バンキングBot を開きます。
2. 設定 -> 構成設定から、 グローバル変数セクションを選択します。
3. グローバル変数の追加をクリックし、対応するウィンドウを開きます。
4. 変数名と 変数値を入力します。この使用ケースでは、変数 accountURL と、サービスAPIコールエンドポイントを入力する値を呼び出します。
5. 保存します。
6. ここで、残高の確認ダイアログタスクを開きます。
7. GetAccountBalanceサービスノードを選択します。
8. リクエストの定義でリクエストの編集をクリックします。
9. リクエストURLを上で作成したグローバル変数と置き換えます。env プレフィックスに続き、パラメータが必要です。この場合は、 {{env.accountURL}}{{context.entities.AccountNumber}}
10. 残高を更新ダイアログタスクを繰り返します。
11. ここで、Botを別の環境にエクスポートおよびインポートするときには、グローバル変数の変更内容のみを心配する必要があり、変更内容は両方のダイアログタスクで有効になります。