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

[アーティクル]
07/03/2024

重要

Power Virtual Agents 機能は、生成 AI への多大な投資と Microsoft Copilot 全体の統合の強化により、現在 Microsoft Copilot Studio の一部となっています。

ドキュメントやトレーニングコンテンツが更新される際、一部の記事やスクリーンショットで Power Virtual Agents に言及することがあります。

注意

機能の可用性情報は次のとおりです。

Dynamics 365 Contact Center - 埋め込み	Dynamics 365 Contact Center - スタンドアロン	Dynamics 365 Customer Service
いいえ	可	可

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

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

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

コンテキスト変数の種類	コンテキスト変数の名前	プロパティ	Azure でマッピングする方法
会話前調査	Customer Service 用オムニチャネルには、オムニチャネルで作成した会話前アンケートの質問名を使用します。	システムは、会話前のアンケートの回答をコンテキスト変数として保存します。	次の情報を使用して、Customer Service 用オムニチャネルの質問名を Azure の変数タイプにマッピングします。単一ライン: 文字列複数行: 文字列オプションセット: 文字列ユーザーの同意: ブール値
カスタムコンテキスト	Customer Service 用オムニチャネルで作成した変数名を使用するか、setContextProvider API を使用して渡します。	作成したカスタムコンテキスト変数は、ライブチャット SDK を通してパスできます。	ユーザーの応答を JSON としてマッピングし、Customer Service 用オムニチャネルでは、カスタムコンテキスト変数を使用します。
会話	msdyn_ConversationId	進行中の会話の会話 ID を含むコンテキスト変数を使用し、Microsoft Dataverse のレコードをフェッチして操作を行うことができます。	文字列: 文字列
取引先担当者	msdyn_contact_msdyn_ocliveworkitem_Customer	会話にリンクされている顧客 (連絡先) レコードのレコード ID を含むこのコンテキスト変数を使用します。	JSON を解析してレコード ID を抽出する
アカウント	msdyn_account_msdyn_ocliveworkitem_Customer	会話にリンクされている取引先企業レコードのレコード ID を含むこのコンテキスト変数を使用します。	JSON を解析してレコード ID を抽出する
ケース	msdyn_incident_msdyn_ocliveworkitem	会話にリンクされているサポート案件レコードのレコード ID を含むこのコンテキスト変数を使用します。	JSON を解析してレコード ID を抽出する

Note

Azure または Copilot Studio ボットのフローを作成する際は、コンテキスト変数名を定義どおりに使用します。また、大文字と小文字が区別されるため、コンテキスト変数に値を渡すときは、完全一致を使用してください。不一致がある場合、レコードは自動的に識別されません。詳細情報: レコードを自動的に識別する

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

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

重要

メッセージング変数と音声変数を使用できるようにするには、拡張ソリューションがインストールされていることを確認します。

コンテキスト変数の種類	コンテキスト変数の名前	プロパティ	Copilot Studio でマッピングする方法
会話前調査	Customer Service 用オムニチャネルには、オムニチャネルで作成した会話前アンケートの質問名を使用します。	システムは、会話前のアンケートの回答をコンテキスト変数として保存します。	次の情報を使用して、Copilot Studio で変数タイプで Customer Service 用オムニチャネルの質問名をマッピングします。単一ライン: ユーザーの応答全体複数ライン: ユーザーの応答全体オプションセット: ユーザーの全体的な応答ユーザーの同意: ブール値
カスタムコンテキスト	Customer Service 用オムニチャネルで作成した変数名を使用するか、setContextProvider API を使用して渡します。	作成したカスタムコンテキスト変数は、ライブチャット SDK を通してパスできます。	次の情報を使用して、Customer Service 用オムニチャネルのカスタムコンテキスト変数を Copilot Studio の変数タイプにマッピングします。文字列: ユーザーの応答全体ブール値: ブール値数、浮動小数点: 数
会話	msdyn_ConversationId	進行中の会話の会話 ID を含むコンテキスト変数を使用し、Microsoft Dataverse のレコードをフェッチして操作を行うことができます。	文字列: ユーザーの応答全体。
メッセージング変数と音声変数	msdyn_CustomerType	会話にリンクされている取引先企業または取引先担当者レコードの顧客タイプを含むこのコンテキスト変数を使用します。	Customer Service 用オムニチャネルの拡張ソリューション変数を選択します。
	msdyn_CustomerName	会話にリンクされている取引先企業または取引先担当者レコードの顧客名を含むこのコンテキスト変数を使用します。	Customer Service 用オムニチャネルの拡張ソリューション変数を選択します。
	msdyn_CustomerId	会話にリンクされている取引先企業または取引先担当者レコードの顧客 ID を含むこのコンテキスト変数を使用します。	Customer Service 用オムニチャネルの拡張ソリューション変数を選択します。
	msdyn_CaseId	会話にリンクされているサポート案件レコードの ID を含むこのコンテキスト変数を使用します。	Customer Service 用オムニチャネルの拡張ソリューション変数を選択します。
	msdyn_CaseTitle	会話にリンクされているサポート案件レコードのタイトルを含むこのコンテキスト変数を使用します。	Customer Service 用オムニチャネルの拡張ソリューション変数を選択します。
音声のみの変数	顧客の電話番号	このコンテキスト変数は、テレフォニー活動で提供される顧客の電話番号に使用します。	Customer Service 用オムニチャネルの拡張ソリューション変数を選択します。
	OrganizationPhoneNumber	このコンテキスト変数は、テレフォニー活動で提供される組織の電話番号に使用します。	Customer Service 用オムニチャネルの拡張ソリューション変数を選択します。
拡張子のメソッド名	va_SurveyConsent	このダイアログを使用して、会話中に顧客がアンケートへの参加に同意したかどうかを判断します。	このメソッドを使用して、会話の詳細をCustomer Service 用オムニチャネルにエスカレーションします。
	va_CustomerLocale	このダイアログでは、現在ボットと会話しているユーザーを、別の言語で会話できる別のボットに転送します。	入力変数を選択し、正しいロケールコードを使用してコードを設定します。

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

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

トピック ページで、トピックの追加 と 空欄から を選択します。
トピックの名前 (たとえば、"コンテキスト変数の設定") を入力して保存します。
新規ノードをトピックに追加して、変数管理 > 変数値の設定 を選択します
新規ノードで、変数の設定 で 新しい変数の作成 を選択します。
新しい変数名をクリックして、変数プロパティ ペインを開きます。パネルで、変数名 を設定して、オムニチャネルコンテキスト変数の名前と正確に一致させます (大文字と小文字が区別されます)。
参照セクションで、省略記号 ( ...) を選択し、空の場合はこのノードから値を取得 を選択します。 Copilot Studio ボットは実行時にこのノードから変数値を取得します。
使用セクションで、グローバル (どのようなトピックでもアクセスできる) と 外部ソースが値を設定 を選択します。 Copilot Studio はオムニチャネルからデータを受け入れます。 変数プロパティ ペインを閉じます。
ノードで、ボットが期待するデータ型と一致する値を 設定する値 に入力します。たとえば、ボットが文字列を期待している場合は、Text("") を設定します。 Copilot Studio は、会話でデータが届かない場合は、ここで設定した値にフォールバックします。
変更を保存して公開します。

会話中、オムニチャネルコンテキスト変数のデータが 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 ボットの統合
 ボットを構成して、会話のエスカレーションと終了をさせる
 ライブチャットリファレンス

次の方法で共有

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

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

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

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

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

参照

フィードバック

その他のリソース