入力パラメーターと出力パラメーターとして変数を使用して、エージェント フローと Copilot Studio エージェントの間で情報を渡します。
重要
エージェントは、1 回のアクションでフローから 1 MB までのデータしか受信できません。 ただし、エージェントが送信できる変数の数やデータ量に制限はありません。
この例では、入力 パラメーター でフローを作成し、それを出力 パラメーター としてエージェントに返します。
前提条件
- Copilot Studio の作成キャンバスから フローを作成 する方法について説明します
サポートされているパラメーター タイプ
Copilot Studio エージェントは、エージェント フローに対して次の種類の入力パラメーターと出力パラメーターをサポートします。
- 回数
- String
- ブール値
次のデータの種類はサポートされていません。
- Object
- 日
- Timestamp
- リスト [文字列]
- リスト [数字]
- リスト [ブール値]
- リスト [オブジェクト]
- リスト [日]
- リスト [タイムスタンプ]
トピックとフローを作成する
エージェントの トピック ページ に移動します。
エコー メッセージという名前の新しいトピックを作成します。
トリガー フレーズ エコーを追加してください。
質問ノードを追加し、「何か話しかけてください。応答します」というメッセージを入力してください。
特定には、ユーザーの応答全体を選択してください。
ユーザーの応答に名前を付けて保存で、変数の名前を userResponseに変更します。
[質問] ノードの下
[ノードの追加] アイコンを選択し、[ツールの追加] を選択します。[ 基本アクション ] タブで、[ 新しいエージェント フロー] を選択します。 エージェント フロー デザイナー タブが開き、エージェントによって呼び出されたエージェント フローの開始テンプレートが表示されます。 このフローには、エージェントがフローを呼び出すときとエージェントに応答するアクションの 2 つがあります。
[Save draft (ドラフトを保存)] を選択します。
フローの [ 概要 ] タブで、フローの詳細を編集し、名前を Echo パラメーターに置き換えます。 [保存] を選択します。
[ デザイナー ] タブに戻ります。
入力パラメーターをフローに追加する
エージェントがフロー フロー トリガー を呼び出すときを 選択し、[ 入力の追加] を選択します。
テキストを選択し、String_Input という名前を入力します。
出力パラメーターをフローに追加する
[ エージェントへの応答] アクションを 選択し、[ 出力の追加] を選択します。
テキストを選択し、String_Output という名前を入力します。
値は、ボックスにスラッシュ (
/) を入力し、動的コンテンツの挿入を入力して、String_Input 変数を選択します。[下書きを保存して発行] を選択します。 エージェント フローが発行されると、Copilot Studio から通知されます。
[ エージェントに戻る ] を選択して、エージェント トピック エディターに戻ります。 新しいアクション フローがトピックに追加されます。
トピックからフローを呼び出す
新しいアクション ノードを選択します。
フロー入力パラメーターを 質問 ノードから出力変数に設定する: String_Input (文字列) は userResponse 変数から値を取得します。
メッセージ ノードを追加します。
変数の挿入を選択し、String_Output を選択します。
保存を選択します。
エージェントをテストする。
