カスタム コパイロット (プレビュー) によるアクションを使用する
1 つ以上のアクションを追加することで、コパイロットの機能を拡張できます。 アクションは、コパイロットが 生成アクション を使用してユーザーに自動的に応答するために使用されます。また、トピック 内から明示的に呼び出すこともできます。
[この記事はプレリリース ドキュメントであり、変更されることがあります。]
コア アクションの種類
生成モード をオンにすると、コパイロットは実行時にユーザーに応答するために最も適切なアクションまたはトピックを自動的に選択できます。
クラシック モードでは、コパイロットはトピックを使用してのみユーザーに応答できます。 ただし、トピック内からアクションを明示的に呼び出すようにコパイロットを設計することもできます。
アクションは、次のいずれかのコア アクション タイプに基づいています。
- 事前構築されたコネクタ アクション
- ユーザー定義コネクタとアクション
- Power Automate クラウド フロー
- AI Builder プロンプト
- Bot Framework スキル
重要
Copilot Studio で作成した会話型アクション をカスタム コパイロットを使ったアクションとして使用することはできません。
各コア アクションにはその目的を説明する追加情報があり、コパイロットは生成 AI を使用して質問を生成できます。 これらの質問は、アクションを実行するために必要な入力を行うために必要です。 したがって、フローの入力など、必要なすべての入力を収集するために質問ノードを手動で作成する必要はありません。 入力は実行時に処理されます。
アクションは、アクションの結果を使用して、ユーザーのクエリに対するコンテキスト応答を生成できます。 あるいは、アクションに対する応答を明示的に作成することもできます。
ヒント
アクションから生成された質問を使用する場合は、会話の一部が AI によって生成されることをユーザーに通知します。
たとえば、会話開始システム トピック に追加のメッセージを追加します。 このトピックにより、新しい会話が開始されたときにユーザーに表示されるメッセージが決まります。
アクションの追加
左側のナビゲーション ペインで、リストからコパイロットを選択して、コパイロット を選択してカスタムコパイロットを開きます。
アクション を選択して、コパイロットのアクションを表示します。
+ アクションの追加 を選択します。
アクションを選択 (プレビュー) ウィザードで、使用するアクションを検索して選択します。
表示される既定のリストには、環境内で使用できる Power Automate フローとカスタム コネクタがあります。 このリストには、一般的に使用される事前構築済みコネクタとコパイロットに登録されている Bot Framework スキルが含まれています。
重要
ダイナミックプロンプトや、Dataverse API、必須 認証 に基づいたもののような AI プラグインから作成されたいくつかのアクション。
アクションに応じて、例に示すように接続が自動的に構成されます。 あるいは、ウィザードで指示がある場合は、接続を構成する必要があります。 接続が正常に構成されたら、次へ を選択します。
確認して、必要に応じて プラグイン アクションの構成を変更 することができます。 終了 を選択して、コパイロットへアクションを追加します。
次へを選択します。
アクションを呼び出す
生成型アクション を有効にする場合、関連するユーザークエリに応じてアクションが自動的に呼び出されます。
あるいは、トピック 内から明示的にアクションを呼び出す ことができます。
アクションのテスト
アクションを呼び出す
コパイロットは、名前と説明に基づいてアクションを選択し、実行します。 専用のトレースモードを使用して、コパイロットが選択したアクションを確認し、生成型アクション ページからコパイロットがどのアクションを選択するかを見ることができます。
あるいは、トピックに追加 したら、トピック のトリガー フレーズの 1 つに似たメッセージを入力してテストできます。
このスクリーンショットでは、天気アクションがテストされているのがわかります。
あるいは、トピック にアクションを追加した場合は、適切なトリガー フレーズを使用して トピック をトリガーしてテストできます。
アクションの入力と出力の設定
アクション構成へ変更を加える
アクションを構成するには多くの方法があります。 アクション ウィザードの最後のステップである 確認して終了 では、適切なセクションの横にある 編集 をクリックして、アクションの設定を変更できます。
アクションの詳細
ここでは、アクションの モデル 表示名 や モデルの説明 など、アクションに関する詳細を設定できます。 通常、名前を説明は選択したアクションに基づいて事前に設定されています。
各入力の 表示名 および 説明 プロパティは、コパイロットが入力の目的を理解し、ユーザーに適切な質問を生成し、ユーザーの応答の正しい値を認識するのに役立ちます。 たとえば、MSN Weather コネクタの場所入力パラメータの既定の名前と説明は次のとおりです。
- 名前: 場所
- 説明: 場所検索クエリ。 都市、地域、都道府県、国、ランドマーク、郵便番号、緯度、経度を入力できます
ユーザーに場所を尋ねると、コパイロットは 天気を確認したい場所はどこですか?都市、地域、州、国、ランドマーク、または郵便番号を入力できます。 のような質問を生成します
収集する入力に応じて、特定のエンティティの種類にオプション として識別 を変更することもでき、コパイロットがユーザーの応答からの値を正確に抽出する際に便利です。
既定では、各入力は 最適なオプションで動的に入力に設定されています。 コパイロットは、ユーザーのメッセージから値を抽出するなど、利用可能なコンテキストから値を入力しようとします。 適切な値が見つからない場合は、ユーザーに値を尋ねる質問が生成されます。 ユーザーに尋ねる代わりに、入力を値で上書きできます。 上書きするには、コパイロットはこの入力をどのように入力するか? ドロップダウンを 値として設定する に変更し、値を入力します。 この値はリテラル値、既存の変数、または Power Fx 式を指定できます。
値を尋ねたり、ユーザーの回答を検証したりするときにコパイロットの動作を制御するには、入力に対して 追加の設定 を構成できます。
出力
デフォルトでは、アクションは、ユーザーのクエリとアクションの結果に基づいて、ユーザーに対するコンテキスト応答を自動的に生成するように構成されています。 たとえば、ユーザーが「ロンドンの現在の気温は何度ですか?」と尋ねた場合、GPT を使用して、「ロンドンの現在の気温は 9 ℃ です」などのコンテキストに沿った応答が生成されます。
あるいは、アクションが返す特定の応答を作成することもできます。 確認エディターと同様に、次の例に示すように、変数ピッカーを使用してアクションから出力変数への参照を挿入できます。
トピック内からアクションを呼び出す
Power Automate フローなどの他のアクション タイプを呼び出すのと同様に、トピック 内からアクションを明示的に呼び出すことができます。 ユース ケースによっては、ノードをもっと使用する、広範なトピックの一部としてフローを使用する場合があります。 または、天気の例のように、トピックに単一のアクション ノードを追加するだけで十分な場合もあります。
トピック内からアクションを呼び出すには:
Copilot Studio で、編集するコパイロット用の トピック ページ に移動します。
新しいトピックを作成し、気象を取得と名付けます。
以下のトリガー フレーズを追加します:
- 雨が降るでしょう
- 今日の予報
- 天気を見る
- 天気はどうですか
ノードの追加 (+) を選択し、アクションの呼び出し を選択します。 プラグインアクション (プレビュー) タブに切り替えて、先ほど作成したアクション 天気予報を見る を選択します。
プラグイン アクション (プレビュー) ノードが トピック に追加されました。
保存 を選びます。
トピックからアクションを呼び出すときに入力を上書きする
デフォルトでは、アクションが実行されると、コパイロットはユーザーに必要な入力を行うための質問を生成します。 ただし、ユーザーに尋ねる代わりに、1 つ以上の入力を上書きして、明示的な値を指定する場合があります。 入力 セクションの プラグイン アクションの構成 で上書きできます。 または、アクションが特定の トピック から使用される場合にのみ値をオーバーライドすることもできます。
ノード上で 値の設定 を選択し、上書きする入力を選択します。
値をタイプするか、変数を選択するか、数式を使用することで、値を入力します。
この入力が上書きされたため、コパイロット ユーザーに値を尋ねません。
AI アクション認証の有効化
AI アクションに基づいて作成された一部のアクション (動的プロンプトや Dataverse API を呼び出すその他のアクションなど) では、正しく機能するために認証が必要です。
アクションは常にエンドユーザーのコンテキストで Microsoft Copilot ランタイムに実行され、認証が有効になっていなければ実行できません。 次の 2 種類の認証方法がサポートされています:
コネクタ アクション プロパティに移動します。
エンドユーザー認証 の下で、Copilot 作成者認証 を選択します。
コパイロット テスト ペインまたは目的のチャネルでエクスペリエンスを公開してテストします。
エンドユーザーの資格情報を使用してフローアクションを使用する
フロー アクションは、エンド ユーザーの資格情報を使用するように構成できます。 サポートされているチャネルでフローを使用している場合、コパイロット ダイアログで特別な構成を行う必要はなく、エンド ユーザーは提供された体験での与えられたフローに対して 接続を管理 できます。
ライブラリ内のプラグインに基づくアクションの認証
AI プラグインに基づいて作成されたアクションが正しく機能するには認証が必要です。 これは、プロンプトに基づくアクションや Dataverse APIを呼び出すその他のアクションで最もよく見られます。 プラグインに基づいたアクションは常にエンドユーザーのコンテキストで実行され、認証が有効になっていなければ実行できません。 次の 2 種類の認証方法がサポートされています:
統合認証 (Teams および Power Apps): コパイロットを Teams チャネルに公開する場合は、この認証方法を使用できます。 この方法は、PPAPI 標準で構築されたトークンを使用する任意の Power Platform アプリに埋め込まれたコパイロットにも機能します。
手動認証 (サードパーティのコパイロット): この認証方法では、Microsoft Entra ID 接続の設定が必要です。
手動認証接続を作成するには:
Microsoft Entra ID アプリ を設定します。
Copilot Studio コパイロットに対して 手動認証 を設定します。
アプリが委任を使用して、ユーザーに代わってトークンをフェッチ できるようにします。 必要なスコープを必ず追加してください。
