入出力変数の追加

重要

Power Virtual Agents 機能は、生成 AI への多大な投資と Microsoft Copilot 全体の統合の強化により、現在 Microsoft Copilot Studio の一部となっています

ドキュメントやトレーニング コンテンツが更新される間、一部の記事やスクリーンショットで Power Virtual Agents が参照される場合があります。

変数を入力および出力パラメーターとして使用して、Power Automate フローと Microsoft Copilot Studio コパイロットの間で情報を渡します。

重要

コパイロットは、1 つのアクションでフローから最大 1 MB のデータを 受け取り ます。 ただし、コパイロットが送信できるデータの量やコパイロットが渡すことができる変数の数に制限はありません。

この例では、入力パラメーターを持つフローを作成し、出力パラメーターとしてコパイロットに返します。

前提条件

  • Copilot Studio の作成キャンバスから フローを作成 する方法について説明します

サポートされているパラメーター タイプ

コパイロットは、Power Automate フローで以下のタイプの入力と出力を使用できます:

  • 回数
  • String
  • ブール型

以下のタイプはサポートされていません:

  • Object
  • Timestamp
  • リスト [文字列]
  • リスト [数字]
  • リスト [ブール値]
  • リスト [オブジェクト]
  • リスト [日]
  • リスト [タイムスタンプ]

トピックとフローを作成する

  1. コパイロットの トピック ページ に移動します。

  2. エコー メッセージという名前の新しいトピックを作成します。

  3. トリガー フレーズ エコーを追加してください。

  4. 質問ノードを追加し、メッセージ何か話しかけてください、それをあなたに返しますを入力してください。

  5. 特定には、ユーザーの応答全体を選択してください。

  6. 応答に名前を付けて保存では、鉛筆アイコンを選択し、変数の名前を userResponse に変更します。

    質問ノードのスクリーンショット。

  7. 作成キャンバスで、ノードの追加 (+) を選択します。 アクションを呼び出すを選択し、フローを作成するを選択します。

  8. Power Automate ポータルで、フローにエコー パラメーターという名前を付けます。

フローに入力パラメーターを追加する

  1. Microsoft Copilot Studio フロー トリガーで、入力の追加を選択します。

    入力の追加が強調表示された Microsoft Copilot Studio フロー トリガーのスクリーンショット。

  2. テキストを選択し、String_Input という名前を入力します。

    フロー トリガー入力のスクリーンショット。

フローに出力パラメーターを追加する

  1. Microsoft Copilot Studio 応答アクションに値を返すで、出力の追加を選択します。

    出力の追加が強調表示されたフロー応答アクションのスクリーンショット。

  2. テキストを選択し、String_Output という名前を入力します。

    応答アクション出力のスクリーンショット。

  3. String_Outputの値として、String_Input 変数を選択します。

    出力パラメーターの値として選択された入力パラメーターのスクリーンショット。

  4. 保存 を選びます。

コパイロット トピックで変数を選択する

  1. Microsoft Copilot Studio キャンバスの作成で、ノードの追加 (+) を選択し、アクションを呼び出すを選択します。

  2. 先ほど作成したフロー エコー パラメーターを選択します。

  3. String_Input(text) の値の取得元には、userResponse を選択します。

  4. メッセージ ノードを追加します。 変数の挿入を選択し、String_Output を選択します。

    エコー パラメーター フローのアクション ノードのスクリーンショット。

  5. テスト コパイロット ペインでトピックをテストします。

    コパイロットの会話のスクリーンショット。

オプションで、入力パラメーターにリテラル値を使用する

または、アクションの入力パラメーターとして変数を使用する代わりに、値の取得元ボックスに、直接値を入力することができます。

入力パラメーターとして渡されるリテラル値のスクリーンショット。

変数を使用する