エージェントに要求に応じて天気予報を生成する機能を提供することで、Copilot Studio でエージェント フローを使用する方法について説明します。
前提条件
あなたが天気予報を取得するエージェントフローを作成した以前の例に、この例は依存しています。
まだ気象予測フローを作成していない場合は、今作成してください。
エージェントからエージェント フローを呼び出す
ここでは、エージェントにツールとして天気予報フローを追加する方法を示します。 このメソッドを使用すると、エージェント オーケストレーターは、天気予報を提供する必要があるときにフローを呼び出すことができます。
Copilot Studio の左側のナビゲーション ウィンドウで、[ エージェント ] を選択し、フローを追加するエージェントを選択します。
[ツール] ページに移動し、[ツールの追加] を選択します。
使用可能な公開済みのフロー一覧を表示するには、フロー を選択します。
先ほど作成した 天気予報の取得 フローを選択します。
[ 追加と構成] を選択します。
フローがエージェントに追加され、エージェントのツールの一覧に表示されます。 エージェントによって使用されるツールの構成ウィンドウが開きます。 このウィンドウを使用して、エージェントのツールを構成できます。
[ 名前 と 説明] に、ツールの表示名と、エージェント オーケストレーターがフローを使用するタイミングを理解するのに役立つ明確な説明を入力します。 たとえば、「指定された都市名または郵便番号で今日の天気予報を取得する」などです。
[ 入力] で、エージェントで変数値を入力する方法を選択します。
[ 完了] で、ツールの使用が完了した後にエージェントが実行する操作を選択します。
構成が完了したら、[ 保存] を選択します。
トピック内からエージェント フローを呼び出す
ここでは、トピックの アクション ノードを使用して、顧客が天気について質問したときにフローを呼び出す方法を示します。
Copilot Studio で、エージェントのトピック ページに移動します。
新しいトピックを作成し、気象を取得と名付けます。
以下のトリガー フレーズを追加:
- 雨が降るでしょう
- 今日の予測
- 気象を取得
- 天気はどうですか
トリガー ノードの下の
ノードの追加アイコンを選択して、メッセージを送信するを選択します。
メッセージ ノードで、テキスト ボックスに もちろんお手伝いします。 と入力します。
メッセージ ノードの下にある
ノードの追加アイコン を選択して、質問する を選択し、フローの最初の情報 "都市" に対する質問ノードを追加します。
質問ノード:
- 「あなたの都市は何ですか?」という質問をテキストボックスに入力します。
- 特定 で ユーザーの応答全体 を選択します。
- この応答
Var1
に関連付けられている変数の名前をメモします。 名前をそのままにすることも、"都市" などのより意味のある名前に置き換えることもできます (必要に応じて 変数の名前を変更する を参照)。
同じ方法で、フローの他の情報である郵便番号に対する別の 質問 ノードを追加します。
- 「あなたの郵便番号は何ですか?」という質問をテキストボックスに入力します。
- 識別で 番号を選択します。
- この応答
Var2
に関連付けられている変数の名前をメモします。 名前はそのままにすることも、より意味のある名前 ("ZIPcode" など) に置き換えることもできます。
質問ノードの下で、郵便番号の追加ノードアイコンを選択し、ツールの追加を選択します。その後、先ほど作成したフロー天気予報を取得を選択します。
フロー入力を質問ノードからの出力変数に設定します。 都市 (文字列) は
Var1
(または名前を変更した場合はCity
) から値を取得し、郵便番号 (数値) はVar2
から値を取得します (または名前を変更した場合はZIPcode
)。アクション ノードの下で、メッセージ ノードを追加して、フローの出力情報を使用するメッセージを入力します。 例:
「
location
の本日の天気予報:day_summary
」
「降水確率はchance_of_rain
% です"
location
、day_summary
、chance_of_rain
はフローからの出力パラメーターです。保存を選択します。
トピックで使用されるエージェント フローを管理する
フローを呼び出すアクション ノードを作成したら、ノードのメニューから次のオプションを使用してフローを管理できます。
削除 完全にノードを削除し、トピックからフローを削除します。
更新は、フローを再読み込みして、Power Automate で行った変更を取得しトピックで検証します。 トピックを保存する前に、フローの問題を修正する必要があります。
別のフローを選択または作成する場合は、アクション ノードのフローにカーソルを合わせると表示されるフローを変更アイコン を使用します。
フローとトピックをテストする
呼び出し元のフローとトピックをテストすることをお勧めします。
エージェントのテスト パネルで、トピックのトリガー フレーズの 1 つを入力して、エージェントとの会話を開始します。 エージェントから求められたら、市区町村と郵便番号を入力します。 エージェントがあなたの都市の今日の天気予報を返し、メッセージが期待どおりに表示されることを確認します。
エージェントのトラブルシューティング
トピックとフローに変更を加えた際には、常にエージェントをテストし、すべてが動作することを確認してください。 エージェントの会話中に問題が発生すると、エラー メッセージ で応答します。
フロー デザイナー タブのフロー チェッカーで、フローに関連するほとんどの問題を見つけます。 トピック チェッカー を使用して、作成キャンバスの問題を特定します。