次の方法で共有

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

  • [アーティクル]

重要

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

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

この記事では、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 ボットがオムニチャネルからコンテキスト変数を読み取るには、次の手順を実行します。

  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 ボットの統合
ボットを構成して、会話のエスカレーションと終了をさせる
ライブ チャット リファレンス