[この記事はプレリリース ドキュメントであり、変更されることがあります。]
モデル駆動型アプリのフォームにエージェントの応答コンポーネントを追加することで、Microsoft Copilot Studio トピックを直接呼び出し、ユーザーに応答を表示できます。 このコンポーネントは 、エージェント API executeEvent 上に構築され、新しいカスタム コンポーネントを必要としないことで使用を簡略化します。 アプリ、ページ、レコードの暗黙のコンテキストは Copilot Studio で利用可能です。
このコンポーネントは、Copilot Studio からの以下の回答をサポートします:
- Markdown
- アダプティブ カード
- Image
- Video
重要
- これはプレビュー機能です。
- プレビュー機能は運用環境での使用を想定しておらず、機能が制限されている可能性があります。 これらの機能は、追加の使用条件の対象となり、正式リリース前に利用可能です。お客様は早期にアクセスし、フィードバックを提供することができます。
前提条件
モデル駆動型アプリで有効な キャンバスやモデル駆動型アプリで、ユーザーが AI を活用したチャット エクスペリエンスを使用したデータ分析の有効化 の環境設定が必要です。 詳細: Copilot 環境設定
フォームにエージェント応答コンポーネントを追加する
フォーム デザイナーで、コマンド バーの コンポーネント を選択します。
コンポーネント ペインで、人工知能を展開する
エージェントの応答をフォーム キャンバスにドラッグします。
エージェント応答の追加 ダイアログで、静的値ボックスに Copilot Studio のトピックからイベント名を入力します。 詳細情報: Copilot Studio でトピックのイベント名を検索する
注意
テーブル列にバインド オプションは、このコンポーネントではサポートされていません。
コマンド バーで、保存して公開するを選択します。
モデル駆動型アプリでフォームを開き、コンポーネントをテストします。
注意
ライブ プレビューはまだサポートされていないため、フォーム デザイナーのプレビューに "エージェントの応答は、アプリを再生したときにのみ使用できます" という警告メッセージが表示されます。
Copilot Studio のトピックのイベント名を検索する
Copilot Studio でトピックを開き、トリガー ノードを見つけます。
トリガー タイプがカスタム クライアント イベントの発生、またはイベントの受信であることを確認します。
トリガー ノードで、編集を選択します。
イベント アクティビティ プロパティ ペインで、エージェント応答コンポーネントから渡されるイベント名プロパティの文字列値をコピーします。 詳細情報: トピックで使用するトリガーの変更
アプリのコンテキストへのアクセス
エージェント応答コンポーネントが Copilot Studio トピックを呼び出す際、変数のセットを通してアプリのコンテキストを渡します。 以下は、Copilot Studio グローバル変数として使用できるコンテキスト変数です。
| 変数 | プロパティ |
|---|---|
Global.PA__Copilot_Model_PageContext.pageContext.id.guid |
メイン フォームのテーブル レコードの ID |
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName |
メイン ページのテーブルの論理名 |
Global.PA__Copilot_Model_PageContext.pageContext.pageName |
メイン ページの名前 |
Global.PA__Copilot_Model_PageContext.pageContext.pageType |
メイン ページの種類 |
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName |
モデル駆動型アプリの一意の名前 |
アクセシビリティ
Copilot Studio の応答がアダプティブ カードである場合、アクセシブルなエクスペリエンスをするために、以下のベスト プラクティスが守られていることを確認してください。
制限事項
エージェント応答コンポーネントのプロパティは現在サポートされていません。
- ラべル
- ラベルの非表示
- 携帯電話で非表示にする
- Lock
- 読み取り専用
- コンポーネントの幅
- コンポーネントの高さ
- テーブル列にバインドする
エージェント応答コンポーネントでは、追加のコンテキストを Copilot Studio に渡すことはできません。 エージェント API executeEvent を使用してカスタム コンポーネントを作成し、より多くのコンテキストの渡しをサポートします。
エージェント応答コンポーネントでは、読み取り専用アダプティブ カードのみがサポートされます。 エージェント API executeEvent を使用してカスタム コンポーネントを作成し、クライアント側のロジックをサポートします。
エージェント応答コンポーネントは、モバイルまたはタブレットではサポートされていません。