フローの作成
Copilot Studio でクラウド フローを使用する方法を学習し、要求に応じて天気予報を作成する機能をエージェントに付与します。 この最初の例では、天気予報を取得するフローを作成します。 次の例では、トピックをアクションとしてフローを呼び出すように設定して、顧客が天気について尋ねた際に、エージェントが天気予報で応答することができます。
エージェントと連携するには、Power Automate のフローには以下のフローのトリガーと応答アクションが必要です。
- フロー トリガー: Copilot からフローを実行
- 対応アクション: Copilot に応答する
Copilot Studio からフローを作成すると、必要なフロー トリガーと応答アクションが自動的に追加されます。 これらのトリガーとアクションを使用するように更新することで、エージェントで使用するために既存のフローを既存のフローを修正することができます。
重要
Copilot Studio のカスタム エージェントでクラウド フローを使用するには、フローが次の条件を満たす必要があります。
- Copilot からフローを実行 トリガーを設定します。
- エージェントと同じ環境内のソリューションに配置されている。 既存のフローを ソリューションに追加 して、エージェントにアクションを追加する際に使用できるようになります。
- 100 秒のアクション制限内で、Copilot への応答 アクションを使用して 同期的に応答を返します。 タイムアウトを回避するには、フロー ロジック、クエリ、返されるデータの量を最適化して、通常の実行がこの制限を下回るようにします。 より長く実行する必要があるアクションは、Copilot に応答 アクションの後に配置して、フロー実行期間制限 (通常は 30 日間) まで実行を継続できます。
前提条件
- Copilot Studio のフローの使用を含むライセンスを持つ Copilot Studio にアクセスします。
エージェントで使用するフローを作成する
エージェントの トピック ページ に移動します。
フローを呼び出すトピックを開きます。
ノードの下にあるノードの追加アイコン
を選択し、アクションの追加を選択します。基本アクション タブで、新規 Power Automate フローを選択します。
Power Automate ポータルが新しいタブで開き、スターター フロー テンプレートが編集用に開かれます。 ポータルは、エージェントと同じ環境で自動的に開き、同じユーザー資格情報を使用します。
フローにアクションを追加します。 この例では、MSN Weather から現在の天気予報を取得するアクションを追加します。
フローの名前を選択し、「天気予報を取得する」に置き換えます。
Copilot からフローを実行するフロー トリガーを選択して、次のパラメーターを追加します。
- 市区町村 (テキスト)
- 郵便番号 (番号)
Copilot からフローを実行するフロー トリガーの下の追加アイコンを選択します。
アクションの追加で、"MSN 天気" を検索して、今日の天気予報を取得アクションを選択します。
今日の天気予報を取得 パネルの 場所 ボックスにスラッシュ (
/) を入力し、動的コンテンツの挿入を選択し、 市区町村 入力パラメーターを選択します。同じ方法で 郵便番号 入力パラメーターを追加します。
Copilot に応答 アクションで、次の出力パラメータと変数を追加します。
出力パラメーター タイプ 変数 day_summaryText 今日の概要 locationText 場所 chance_of_rain回数 日中の降水確率 
フローを保存して公開します。
Copilot Studio のトピックに戻り、トピックからフローを呼び出すの指示に従います。
フローで使用される接続を管理する
サポートされている認証済みエージェントでは、クラウド フローが生成オーケストレーション プランの一部として実行されるとき、またはトピックから呼び出されるとき、ユーザーの資格情報を使用するように構成できます。 サポートされているチャネルでフローを使用する場合、エージェントで特別な設定を行う必要はありません。 顧客は、エージェントの使用中に接続を管理することができます。
カスタマー マネージド キー (CMK) を使用した環境のクラウド フローは、生成オーケストレーション プランの一部として、またはトピックから顧客の資格情報を使用して実行することはまだできません。 CMK 環境のクラウド フローの実行専用設定が、実行専用ユーザーによって提供される ではなく、特定の接続に設定されていることを確認します。
既存のフローを変更して エージェント で使用する
エージェントで使用する別のトリガーを含むフローがある場合は、Copilot のトリガーからフローを実行し、Copilot に応答する応答アクションを使用するようにフローを変更できます。そして、それがカスタム エージェントと同じ環境のソリューション内にあることを確認します。
Power Automate ポータルに移動して、右上の環境セレクターを使用して、フローが保存される環境を選択します。
左側のナビゲーション ウィンドウで マイ フロー を選択し、変更するフローを検索します。
フローを選択し、編集を選択します。
Copilot トリガーと応答アクションを追加する
必要なフロー トリガーと応答アクションがフローにまだ含まれていない場合は、エージェントでフローを使用する前に追加する必要があります。
新しいステップを選択します。
Copilot を検索して、Copilot からフローを実行する を選択します。
新しいステップを選択します。
Copilot コネクタを選択して Copilot に応答する を選択します。 応答アクションはフロー内の複数のブランチで使用できますが、使用ごとに同じ出力を持つ必要があります。
フローを保存して公開します。
応答アクションがリアルタイムで返されるように設定されていることを確認する
エージェントで使用するフローは、リアルタイムまたは 同期的に値を返す必要があります。 バックグラウンドで、または非同期的に実行されるフローは、エージェントがフローを実行しようとしたときにエラーを引き起こす可能性があります。 フローを実行する代わりに、エージェントはこう言います。「予期しないことが発生しました。 現在調査中です。 エラー コード: 3000」。
Copilot Studio からフローを作成すると、非同期応答が既定でオフになります。 非同期応答がオンになっている既存のフローを変更した場合は、次の手順に従って設定を確認し、オフになっていることを確認します。
フローを開き、Copilot に応答する アクションを見つけます。
設定 タブを選択します。
非同期の応答 を オフ に設定してから 保存 を選択します。
フローをソリューションに追加する
環境でエージェントで使用できるようにするには、フローを同じ Power Platform 環境のソリューション に保存する必要があります。 フローがソリューション内にある場合、フローの詳細ページにソリューション タイルが表示され、フローが含まれているソリューションが一覧表示されます。 フローは、エージェントで使用するために 既定のソリューション に追加したり、次の手順を使用して別のソリューションに移動したりできます。
Power Automate に移動します。
ソリューション に移動し、既存のソリューションを選択するか、フローのソリューションを作成します。
新しいソリューションを作成する場合は、以下を実行します。
新しいソリューション を選択します。
新しいソリューションに名前を付け、公開元フィールドの CDS 既定の公開元 を選び、バージョン番号を入力します。
作成を選択します。
既存のソリューションにフローを追加する場合は、目的のソリューションを選択し、編集を選択します。
既存を追加>オートメーション>クラウド フローを選択します。
既存のフローを追加する パネルが表示されます。
フローを選択し、追加を選択します。
