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

  • [アーティクル]

重要

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

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

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

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

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

コンテキスト変数の種類 コンテキスト変数の名前 Description 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 ボットを構成する 際に使用できるコンテキスト変数のリストです。

重要

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

コンテキスト変数の種類 コンテキスト変数の名前 Description Copilot Studio でマッピングする方法
会話前調査 Customer Service 用オムニチャネルで作成した質問タイプを使用します。 会話前の回答のコンテキスト変数は、会話前のアンケートの質問に対する顧客の回答を格納します。 次の情報を使用して、Customer Service 用オムニチャネル の質問タイプ変数を Copilot Studio の変数タイプにマッピングします。
  • 単一ライン: ユーザーの応答全体
    • 複数ライン: ユーザーの応答全体
  • オプション セット: ユーザーの全体的な応答
  • ユーザーの同意: ブール値
カスタム コンテキスト 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. 応答に名前を付けて保存を編集し、変数のプロパティダイアログで、名前の値を、必要な Customer Service 用オムニチャネルのコンテキスト変数で更新します。 ボット (任意のトピックがアクセス可能)と外部ソースは値を設定できますが選択されていることを確認してください。 外部ソースが値を設定できるオプションは、コンテキスト変数の取得にのみ適用されます。

    トピックでコンテキスト変数を構成します。

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

実行時に、必要な情報がコンテキスト変数にキャプチャされ、構成したワークフローに基づいて後続のアクションに使用できます。 ボットがエージェントに会話をエスカレーションする際に、会話とケースを結びつけるコンテキスト変数の情報を設定することができます。 詳細情報: 顧客とサポート案件を会話にリンクする

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