ボットのコンテキスト変数を構成する

この記事では、Azure と Copilot Studio ボットのコンテキスト変数と、Customer Service 用オムニチャネル でそれらを構成する方法を一覧で説明します。 コンテキスト変数の作成方法を理解するには、コンテキスト変数を管理する を参照してください。

Azure ボットで使用するコンテキスト変数

次の表は、Customer Service 用オムニチャネルで Azure ボットを構成する際に使用できるコンテキスト変数のリストです。

Copilot Studio ボットで使用するコンテキスト変数

次の表は、Customer Service 用オムニチャネルで Copilot Studio ボットを構成する 際に使用できるコンテキスト変数のリストです。

Copilot Studio ボットのコンテキスト変数を構成する

あなたの Copilot Studio ボットがオムニチャネルからコンテキスト変数を読み取るには、次の手順を実行します。

1. トピック ページで、トピックの追加 と 空欄から を選択します。

2. トピック の名前 (たとえば、"コンテキスト変数の設定") を入力して保存します。

3. 新規ノードをトピックに追加して、変数管理 > 変数値の設定 を選択します

4. 新規ノードで、変数の設定 で 新しい変数の作成 を選択します。

5. 新しい変数名をクリックして、変数プロパティ ペインを開きます。 パネルで、変数名 を設定して、オムニチャネル コンテキスト変数の名前と正確に一致させます (大文字と小文字が区別されます)。

6. 参照 セクションで、省略記号 ( ...) を選択し、空の場合はこのノードから値を取得 を選択します。 Copilot Studio ボットは実行時にこのノードから変数値を取得します。

7. 使用 セクションで、グローバル (どのようなトピックでもアクセスできる) と 外部ソースが値を設定 を選択します。 Copilot Studio はオムニチャネルからデータを受け入れます。 変数プロパティ ペインを閉じます。

8. ノードで、ボットが期待するデータ型と一致する値を 設定する値 に入力します。 たとえば、ボットが文字列を期待している場合は、Text("") を設定します。 Copilot Studio は、会話でデータが届かない場合は、ここで設定した値にフォールバックします。

   

9. 変更を保存して公開します。

会話中、オムニチャネル コンテキスト変数のデータが Copilot Studio 変数に設定され、ボットのロジックで使用できるようになります。

ボットは会話中にオムニチャネル コンテキスト変数を設定することもできます。 Copilot Studio ロジックからオムニチャネル変数を設定するには、ボットが正しい変数名を使用していることを確認し、変数管理ノードの "終了値" プロパティに値を設定します。 Copilot Studio エージェントへの転送中に変数をオムニチャネルに渡します。 これは、ボットが会話をエージェントにエスカレートするときに、会話をケースにリンクするためによく使用されます。 このデータからオムニチャネルのレコードをリンクする方法の詳細については、顧客とケースを会話にリンクする を参照してください

Copilot Studio で作成されるグローバル変数は、会話がエスカレーションされる際に Customer Service 用オムニチャネルに渡すことができます。 完全なリストについては、ハンドオフ時に利用可能なコンテキスト変数を参照してください。

JSON オブジェクトを解析してレコード ID を抽出する

次の詳細を確認してください。

• msdyn_contact_msdyn_ocliveworkitem_Customer などのCustomer Service 用オムニチャネルのコンテキスト変数。
• スキーマの詳細

サンプル スキーマの詳細のコピーは次のとおりです:

        Schema: 
        {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "RecordId": {
                        "type": "string"
                    },
                    "PrimaryDisplayValue": {
                        "type": "string"
                    }
                },
                "required": [
                    "RecordId",
                    "PrimaryDisplayValue"
                ]
            }
        }

PrimaryDisplayValue には Dataverse エンティティの属性の値が含まれています。 エンティティ属性のマッピングは次のとおりです。

• サポート案件 : サポート案件のタイトル
• 連絡先 : 氏名
• 取引先企業名 : 名前

コンテキスト レコードの例は次のとおりです。

{
    "msdyn_contact_msdyn_ocliveworkitem_Customer": [
        {
            "RecordId": "<GUID>",
            "PrimaryDisplayValue": "<FullName>"
        }
    ],
    "msdyn_liveworkitemid": "<GUID>"
}

参照

Copilot Studio ボットの統合
Azure ボットの統合
ボットを構成して、会話のエスカレーションと終了をさせる
ライブ チャット リファレンス