Dataverse for Teams データを取り込むアクションを呼び出す

  • 9 分

アクションを呼び出す ノードを使用すると、エージェントが Power Automate フローと対話できます。 これらのフローを使用して、自動プロセスをトリガーしたり、Dataverse for Teams データや Microsoft Lists などのデータ ソースに接続したりすることができます。

たとえば、Event Contacts エージェントでは、Dataverse for Teams テーブルから Sales Project チームのメンバーを提供することができます。 このチームに変更があった場合、エージェントを編集するのではなく、テーブルを更新することができます。

手順 1 - Dataverse for Teams テーブルを作成する

Dataverse for Teams テーブルを作成するには、次の手順に従います。

  1. エージェントと同じチームに新しい Dataverse for Teams テーブルを作成します。 テーブルを作成する場合は、Teams 用 Power Apps を使用する必要があることに注意してください。 Teams 用 Power Apps でビルド タブを選択し、チームを選択します。

  2. [チーム名] 用に作成されたアイテム の下で すべて表示 を選択し、チームのソリューション一覧を表示します。 チームのソリューション一覧には、選択したチーム用の Dataverse for Teams に組み込まれているすべてのアプリ、エージェント、クラウド フロー、テーブルなどが含まれます。 Event Contacts エージェントを作成したのと同じチームを選択した場合は、そのエージェントがソリューション一覧に表示されます。

  3. 上部のチームのソリューション リボンから、新規>テーブル を選択します。

新しいメニューおよびテーブルが選択されている、[ビルド] タブのスクリーンショット。

新しいテーブルに Sales Project Team という名前を付け、保存を選択します。 使用する列およびデータ型は次のとおりです。

列 データ型
名前 テキスト
メール アドレス メールアドレス

次の手順に進む前に、メール アドレス列をテーブルに追加する必要があります。

  1. 4 つの連絡先ごとに新しい行を追加します。

    名前 メール アドレス
    Joseph Price JosephP@contoso.com
    Nathan Rigby NathanR@contoso.com
    Amber Rodriguez AmberR@contoso.com
    Monica Thomson MonicaT@contoso.com

  2. 完了したら、Teams 用 Microsoft Copilot Studio に戻ります。

手順 2 - アクション ステップを含むエージェント トピックを作成する

アクションを追加するには、次の手順に従います。

  1. Teams 用 Microsoft Copilot Studio で、リボンから エージェント タブを選択してから、Event Contacts エージェントを検索/選択して開きます。

  2. トピック の一覧に移動します。

  3. トピック リボンから 新しいトピック>空白から を選択して、新しいトピックを作成します。 トピックに名前を付けるには、リボンから詳細を選択します。 名前フィールドに "Sales Project Team" と入力します。

  4. トリガー フレーズを選択し、次の各項目を入力したら、+ をクリックします。

    sales project team

    sales project info

    sales team info

    sales project members

    sales project info

  5. メッセージ ノード内の作成キャンバスで、次のように入力します。

    Let me look up the Sales Project Team!

名前およびトリガー フレーズを示した設定のスクリーンショット。

  1. ここで、リボンから保存ボタンを選択して、トピックを保存します。 この時点で保存していない変更は、Power Automate に切り替えてフローを作成すると失われる可能性があります。

  2. メッセージ ノードの後に新しいノードを追加し、アクションを呼び出す > フローの作成を選択します。 Copilot Studio では、終了する前にトピックを保存するように促すオプション ボックスが表示される場合があります。 すでに保存している場合は、終了を選択します。 この操作により、Copilot Studio の中で Power Automate スタジオが開きます。

    いくつかの一般的なテンプレートが用意されており、その中から直接選ぶことができます。 各テンプレートを使うと、フローがトリガーされた場合、情報をそのフローに渡すことができます。 フローが完了すると、情報がエージェントに返されます。 さらに多くのテンプレート オプションを表示するには、その他のテンプレートを表示 を選択します。 主なものは、次のとおりです。

    Copilot Studio フロー テンプレート - このテンプレートには、エージェントに対して情報の送受信を行うステップのみが含まれています。

    Teams チャネルにメッセージを送信する - Teams メッセージをエージェントからトリガーします。

    Teams チャネルにアダプティブ カードを送信する - Teams チャネルに情報を提供するアダプティブ カードをトリガーします。

  3. Copilot Studioフロー テンプレートを選択します。 同じように、トリガーは Copilot Studio になります。その下に、Copilot Studio に値を返すという 1 つのステップがあります。

  4. フローの名前を Get Sales Team Members に変更します。

  5. エージェントに返す情報を格納するために変数を作成します。 トリガーと値を返すステップの間にある矢印までカーソルを移動し、その領域にカーソルを移動したときに表示される 新しいステップの挿入 アイコンを選択した後、アクションの追加 を選択します。

  6. 検索ボックスに "変数" と入力し、アクションで変数を初期化するを選択します。

  7. 名前に "varContactInfo" と入力し、型として文字列を選択します。 値はそのままにします。

  8. ここで、Teams から Dataverse のデータにアクセスするステップが必要になります。 新しい変数を初期化するステップで新しいステップの挿入アイコンを選択し、アクションの追加を選択します。 Microsoft Dataverse コネクタを検索し、トリガーとして行の一覧表示を選択します。

  9. テーブル名には、ドロップダウンから、Sales Project Team テーブルを選択します。 (入力欄に「sales」と入力すると一覧をすばやく絞り込むことができます。)

    行の一覧表示アクションにより、すべてのテーブル行が配列に取り込まれます。 配列はテーブルです。 文字列変数にデータを追加するには、テーブルの各行を調べて、varContactInfo 変数にデータの各行を追加する必要があります。 そのようにして、このデータが Microsoft Copilot Studio に戻されます。

  10. 行の一覧表示の後にある新しいステップの挿入アイコンを選択します。 アクションの追加を選択します。

  11. 検索ボックスにコントロールと入力し、アクションで個々に適用を選択します。

  12. 前の手順の出力の選択フィールドで、動的コンテンツを選択して追加します。 次に、Dataverse 行の一覧表示アクションの下で値を選択します。

  13. 個々に適用手順内でアクションの追加を選択して続行します。

  14. 選択と操作検索ボックスに変数と入力してから、アクションで文字列変数に追加を選択します。

  15. 配列変数に追加手順で、名前に varContactInfo を選択します。

  16. 値で、各ユーザーの名前とメールを含む複数行の箇条書きリストを (文字列データとして) 作成します。 Power Automate では、テキストの書式設定に Markdown 構文を使用します。 Markdown で箇条書きリストを指定するには、行頭にアスタリスク文字 * を使用します。 (Markdown について詳しくは、このモジュールの最後にある「概要」セクションを参照してください。)

    値テキスト ボックスで次の操作を行います。

    1. アスタリスク * を入力し、その後にスペースを追加します。

    2. 動的なコンテンツの行を一覧にするで名前を選択し、その後にスペースを追加します。

    3. 動的なコンテンツの行の一覧表示で、メール アドレスを選択します。

    4. Enter を押して、新しい行を開始します。

      このステップは完了です。

  17. フローの最後にある Microsoft Copilot Studio に値を返す手順を選択してから、+ 出力の追加を選択します。

  18. テキストを入力タイプとして選択します。

  19. タイトルの入力テキスト ボックスに ContactData と入力します。

  20. 値を入力して応答してくださいフィールドで入力フィールドを選択してから、変数セクションで varContactInfo を選択します。

    これで、フローは次の図のようになります。

    Get Sales Team Members フローのスクリーンショット。

  21. Power Automate リボンから保存を選択して、フローの編集を終了します。 Power Automate により、問題を探すためのフロー チェッカーが自動的に実行されます。 「...OData フィルター クエリ...」に関する警告が表示される場合がありますが、これは無視してかまいません。 OData フィルターを使用すると、行の一覧表示 ステップにより取得されるデータを制限できますが、データ ソースには数行しか含まれていないため、フィルターは不要です。 閉じる を選択し、Power Automate を終了してエージェント エディターに戻ります。

  22. エージェント エディターに戻り、アクション ステップを調べます。 前の手順で作成したフローが表示されます。Get Sales Team Members がアクションとして表示され、作成した ContactData 文字列変数が出力として一覧表示されます。

  23. アクション ノードの後にメッセージを表示する手順を追加します。

  24. テキスト ボックス内をクリックすると、メニューが表示されます。 変数 {X} の挿入で ContactData を選択します。

  25. トピック編集リボンから [保存] を選択し、トピックが保存されるまで待ちます。 [ボットのテスト] ペインが表示されていない場合は、[チャットボットをテストする] メニュー オプションを選択します。

  26. チャットボットのテスト パネルの最上部で、トピック間の追跡オプションがオンに切り替わっていることを確認します。

  27. トリガー フレーズのいずれかを入力して、Sales Project Team エージェントをテストします。 テスト エージェントにより、Sales Project Team の 4 人の名前とメール アドレスの箇条書きリストが表示されます。

Sales Project Team トピックのスクリーンショット。

お疲れさまでした。 ここでは、統合された Power Automate フローを通じて、エージェントがデータ テーブルの情報にアクセスするための方法を作成しました。