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

完了

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

たとえば、イベントの連絡先コパイロットでは、営業プロジェクト チームのメンバーを Dataverse for Teams テーブルから取得できます。 このチームに変更があった場合、コパイロットを編集する代わりに、テーブルを更新できます。

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

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

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

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

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

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

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

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

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

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

    名前 メール アドレス
    Joseph Price JosephP@contoso.com
    Nathan Rigby NathanR@contoso.com
    Amber Rodriguez AmberR@contoso.com
    Monica Thomson MonicaT@contoso.com
  5. 完了したら、チームの Microsoft Copilot Studio に戻ります。

手順 2 - アクション ステップを含むコパイロット トピックを作成する

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

  1. Teams 用 Microsoft Copilot Studio で、リボンからコパイロット タブを選択してから、Event Contacts コパイロットを検索/選択して開きます。

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

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

  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!

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

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

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

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

    Power Virtual Agents フロー テンプレート - このテンプレートには、コパイロットに情報を送受信する手順のみが含まれています。

    Teams チャネルにメッセージを送信する - Teams メッセージをコパイロットからトリガーします。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  32. トリガー フレーズのどれかを入力して、Sales Project Team チャットボットをテストします。 テスト チャットボットにより、Sales Project Team の 4 人の名前とメール アドレスの箇条書きリストが表示されます。

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

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