グローバル変数の操作

1. 変数を作成する または 変数パネルを使用して 既存の変数を開きます。

2. 変数プロパティ パネルで、グローバル (どのトピックでもアクセス可能) を選択します。

   変数名には接頭辞 が与えられ、トピック レベルの変数と区別することができます。 たとえば、変数 は、 として表示されます。

3. トピックを保存します。

1. 必要な変数を選択します。

2. 変数プロパティ パネルの 使用状況 で、ボット (任意のトピックがアクセス可能) を選択します。

3. 変数名には、トピックレベルの変数と区別するために接頭辞 が付きます。 たとえば、変数 は のとして表示されます。

メッセージ ノードまたは 質問 ノードでメッセージを作成しているとき、{x} アイコンを選択すると、トピックで使用可能な変数が表示されます。 グローバル変数は、すべてのトピック変数と一緒にカスタム タブ内に表示されます。 変数はアルファベット順に一覧表示されます。

メッセージ ノードまたは 質問 ノードでメッセージを作成しているとき、{x} アイコンを選択すると、トピックで使用可能な変数が表示されます。 変数はアルファベット順に表示され、グローバル変数はすべて で始まるため、一緒に表示されます。

条件ノード、フロー アクション ノード、スキル ノードを使用すると、グローバル変数も使用できます。

1. 作成キャンバスまたは変数パネルで、必要なグローバル変数を選択します。

2. 変数プロパティパネルの参照セクションで、すべての参照を表示するを選択します。

3. その他 タブに切り替え、変数が使用されているトピックを選択して、そのトピックとノードに直接移動します。

オーサリング キャンバスで目的の変数を選択します。 変数プロパティ パネルが表示されます。

• グローバル変数が作成されたノードに直接移動するには、ソースに移動: を選択します。

• この変数を使用するトピックに移動するには、使用者 セクションで目的のトピックを選択します。

既定では、グローバル変数の値はセッションが終了するまで持続します。 変数値のクリア ノードはグローバル変数の値をリセットし、会話をリセット システム トピックで使用されます。 リダイレクトによってそのトピックがトリガーされたとき (またはユーザーが "やり直し" などのフレーズを入力したとき)、すべてのグローバル変数がリセットされます。

グローバル変数はどのトピックからもアクセス可能で、その値はセッション全体を通じて持続します。

この値は、エージェント ユーザーが Start Over トピックにリダイレクトされたとき、またはユーザがこのトピックを直接トリガしたとき (たとえば 「Start over」 と入力したとき) にのみクリアされます。 この場合、すべてのグローバル変数はリセットされ、値を持ちません。

グローバル変数の初期化

グローバル変数が初期化される前にトリガーされた場合、エージェントは、元のトピックに戻る前に、グローバル変数が最初に定義されたトピックの一部を自動的にトリガーします。 この動作により、エージェントは会話を中断することなく、すべての変数を入力することができます。

たとえば、顧客がグローバル変数 が使用されている 「予約 」トピックで会話を開始します。 ただし、 変数は、「ようこそ」トピックで最初に定義されています。

会話が「予約設定」トピックのポイントに到達し、 が参照されたとき、エージェントは が最初に定義されている質問ノードにシームレスに移行します。

顧客が質問に回答すると、エージェントは「予約の予約」トピックを再開します。

Power Automate フローまたはスキルを使用してアクションを実装するときのグローバル変数の動作

場合によっては、フローやスキルを使って変数を初期化したり入力したりすることもあるでしょう。

しかし、ユーザーがエージェントと対話するとき、変数は会話の早い時点で入力されるかもしれませんし、すでに外部で変数を設定している場合も考えられます。

このような状況でも、フローやスキルは実行され、変数に格納されていたものを上書きして新しい値を代入します。

エージェントが何らかのコンテキストで会話を開始するようにするには、グローバル変数を使用して、外部ソースからその値を設定します。 利用しているサイトがユーザーのサインインを要求しているとします。 ユーザーの名前をグローバル変数に格納してエージェントに渡すと、エージェントは顧客が最初の質問を入力する前に名前で挨拶できます。 もう 1 つのシナリオ例として、Dynamics 365 Customer Serviceからエージェントにコンテキストを渡すことで、顧客が何を達成したいのかを知って会話を開始できます。

望ましくないレイテンシーを防ぐために、エージェントが値を待機できる時間を指定できます。 また、外部ソースがタイムリーに応答できない場合に使用する既定値を設定することもできます。

1. 外部ソースから設定するすべての変数の構成を保持する専用のトピックを作成します。 たとえば、このトピックに "コンテキスト変数の設定" という名前を付けることができます。 このトピックは他の目的には役立たないため、トリガー フレーズを設定する必要はありません。

2. 専用トピックに 変数値の設定 ノードを追加します。

3. 変数の設定 で、変数ピッカーを開いて、新規変数の作成 を選択します。

4. 新しい変数の既定の名前を選択します。 変数プロパティ パネルが表示されます。

5. デフォルト名を、外部システムから渡される変数の名前と 完全に 一致する名前に置き換えます。

6. 使用 で、グローバル (任意のトピックがアクセス可能) を選択して、外部ソースは値を設定できます。

7. 参照 で、右上隅にある 3 つのドット (⋮) を選択し、空の場合はこのノードから値を取得する を選択します。

8. (オプション)タイムアウト遅延をミリ秒単位で設定します。 この値は、エージェントが外部ソースによって変数が設定されるのを待機できる時間を決定します。タイムアウトすると、変数値の設定 ノードで設定したデフォルト値で続行します。 この設定は、変数が実行時間の長いプロセスまたは非同期プロセスに依存するシナリオに関連しますが、エージェントは優れたユーザーエクスペリエンスを確保するために最大レイテンシーを尊重する必要があります。

   Customer Service 用オムニチャネルからの変数の場合、最大待機時間として 10 秒 (10,000 ミリ秒) の値を推奨します。

9. 変数値を設定 ノードで、タイムアウトに達した場合に使用するデフォルト値を入力します。 実行時には、エージェントは同じデータ型の値を期待します。 この既定値を空の文字列にする場合は、空の文字列を表す数式を使用してください。

   外部ソースから設定するグローバル変数の構成のスクリーンショット。

10. 外部システムから取得すると予想されるその他の値については、変数値の設定 ノードをさらに専用トピックに追加し、同じ方法で必要なグローバル変数を設定します。

設定が完了すると、エージェントのテストの準備が整います。 エージェントが呼び出されると、すべての変数が入力されるのを無期限に待つのではなく、渡される変数に依存しないメッセージの送信をすぐに開始できます。 エージェントが外部で設定されている変数にアクセスしようとすると、値が到着するかタイムアウトが発生するまで一時停止します。 詳細は エージェントを最適化してレイテンシーを最小化する をご覧ください。

外部ソースから初期化するグローバル変数を設定できます。 このアクションにより、エージェントはいくつかのコンテキストで会話を始めることができます。

たとえば、顧客があなたの Web サイトからエージェント チャットを表示し、サイトはすでに顧客の名前を知っています。 会話を開始する前にエージェントにユーザー名を知らせれば、エージェントはユーザーに再度名前を尋ねる必要なく、よりインテリジェントな会話を行うことができます。

1. 必要なグローバル変数を選択します。

2. 変数プロパティパネルで、外部ソースが値を設定できるを選択します。

エージェントを単純な Web ページに埋め込む場合、変数とその定義をエージェントの URL に追加することができます。 または、もう少し制御したい場合は、 コード ブロックを使用して、プログラムで変数を呼び出します。

URL のクエリ文字列の変数名は、 接頭辞なしで、グローバル変数の名前と一致している必要があります。 たとえば、グローバル変数 は、クエリでは として参照されます。

この後の例では、基本的な変数宣言を使用します。 実運用シナリオでは、クエリのパラメーターや変数定義として、すでにユーザー名を格納している別の変数を渡すかもしれません (たとえば、サインイン スクリプトからユーザー名を取得している場合など)。

クエリ文字列パラメーター として の形式で、エージェントの URL に変数とその定義を追加します。

例:

• という名前のグローバル変数があります。
• エージェントのURL は です。
• Web サイトでエージェントの会話を開始するときにユーザー名を渡すには、 クエリ文字列を次のようにアタッチします: 。

パラメーター名は、大文字と小文字を区別しません。 はこの例でも有効です。

単純な Web ページにエージェントを埋め込むだけであれば、変数とその定義を追加することができますし、プログラム的に変数を呼び出して使用するために コード ブロックを使用することもできます。

ここで説明する例では、変数に対して簡単な宣言が行われています。 実運用シナリオでは、クエリのパラメーターや変数定義として、すでにユーザー名を格納している別の変数を渡すかもしれません (たとえば、サインイン スクリプトからユーザー名を取得している場合など)。

1. クエリ文字列パラメーター としてエージェントの URL に変数とその定義を追加します ( の形式)。例を次に示します:

   • という名前のグローバル変数があります。
   • エージェントのURL は です。
   • Web サイトでエージェントの会話を開始するときにユーザー名を渡すには、 クエリ文字列を としてアタッチします。

2. パラメーター名は、大文字と小文字を区別しません。 つまり、 はこの例でも使えるということです。

1. 次のように、エージェントがあるページの「 」セクションで、接頭辞「 」を除いた変数名と定義「 」を入れて変数を定義します。 複数の変数はコンマ () で区切ります。

      const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
        if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
          dispatch({
             type: "WEB_CHAT/SEND_EVENT",
             payload: {
               name: "pvaSetContext",
               value: {
                  "variableName1": "variableDefinition1",
                  "variableName2": "variableDefinition2"
               }
             },
           });
         }
           return next(action);
       });
   

2. セクションで、エージェントを埋め込む際に を呼び出します。たとえば、以下の例では、 は が呼び出される直前に呼び出されます (をエージェントの ID に置き換える必要があります):

   const BOT_ID = "12345-5678";
   const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;
   
   fetch(theURL)
       .then(response => response.json())
       .then(conversationInfo => {
           window.WebChat.renderWebChat(
               {
                   directLine: window.WebChat.createDirectLine({
                       token: conversationInfo.token,
                   }),
                   store,
                   styleOptions
               },
               document.getElementById('webchat')
           );
       })
       .catch(err => console.error("An error occurred: " + err));
   

1. 次のように、エージェントがあるページの「 」セクションで、接頭辞「 」を除いた変数名と定義「 」を入れて変数を定義します。 複数の変数はコンマ で区切ります。

      const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
        if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
          dispatch({
             type: "WEB_CHAT/SEND_EVENT",
             payload: {
               name: "pvaSetContext",
               value: {
                  "variableName1": "variableDefinition1",
                  "variableName2": "variableDefinition2"
               }
             },
           });
         }
           return next(action);
       });
   

2. セクションで、エージェントを埋め込む際に を呼び出します。たとえば、以下の例では、 は が呼び出される直前に呼び出されます ( をご利用の ID に置き換える必要があります):

   const BOT_ID = "12345-5678";
   const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;
   
   fetch(theURL)
       .then(response => response.json())
       .then(conversationInfo => {
           window.WebChat.renderWebChat(
               {
                   directLine: window.WebChat.createDirectLine({
                       token: conversationInfo.token,
                   }),
                   store,
                   styleOptions
               },
               document.getElementById('webchat')
           );
       })
       .catch(err => console.error("An error occurred: " + err));