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

完了

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

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

ステップ 1 - Dataverse for Teams テーブルを作成する

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

  1. 営業プロジェクト チーム という名前のチャットボットと同じチームに新しい Dataverse for Teams テーブルを作成します。 使用する列およびデータ型は次のとおりです。

    データ型
    名前 テキスト
    メール アドレス メール
  2. 4 つの連絡先ごとに新しい行を追加します。

    各連絡先の行を含む営業プロジェクト チームのスクリーンショット。

  3. 完了したら、テーブルを閉じます。

ステップ 2 - アクションを追加する

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

  1. イベント連絡 チャットボットを編集のために Power Virtual Agents で開きます。

  2. 新しいトピックを作成します。

    名前 - 営業プロジェクト チーム

    トリガー フレーズ - 営業プロジェクト チーム、営業プロジェクト情報、営業チーム情報、営業プロジェクト メンバー、営業プロジェクト情報

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

  3. トピックの保存 を選択し、作成キャンバスに移動 を選択します。

  4. メッセージ ノードで、営業プロジェクト チームを検索する と入力します。

  5. 保存 を選択して、この時点でボットを保存します。 Power Automate フローが作成されたら、Power Automate エディターに切り替えます。 チャットボットに保存されていない変更は失われる可能性があります。

  6. メッセージ ノードの後に新しいノードを追加し、アクションの呼び出し > フローの作成 を選択します。

    フローの作成が選択されたアクションの呼び出しポップアップ メッセージのスクリーンショット。

    3 つのテンプレートから選択できます。 各テンプレートを使うと、トリガーされた場合に情報をフローに渡すことができます。 フローが完了したら、情報をチャットボットに返すことができます。

    Power Virtual Agents フロー テンプレート - このテンプレートには、情報を受け取って送信するステップのみが含まれます。

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

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

    使用可能な 3 つのテンプレートのスクリーンショット。

  7. Power Virtual Agents フロー テンプレート を選択します。

  8. 新しいフローのタイトルは Power Virtual Agents フロー テンプレート です。 フローのタイトルを選択し、営業チーム メンバーを取得 に名前を変更します。

    「営業チーム メンバーの取得」と変更されたタイトルのスクリーンショット。

  9. チャットボットに返す情報を格納するために変数を作成します。 新しいステップの挿入 を選択し、アクションの追加 を選択します。

    [アクション追加] 機能のスクリーンショット。

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

  11. 名前ContactInfo と入力し、型として 文字列 を選択します。

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

    [行を一覧表示] が選択された Dataverse コネクタの検索のスクリーンショット。

  13. ドロップダウン リストから、営業プロジェクト チーム テーブルを選択します。

    行を一覧表示 アクションにより、すべてのテーブル行が配列に取り込まれます。 配列は、一度に複数の値を保持できる変数のタイプです。 配列のデータを処理するには、1 行ずつ ContactInfo 変数にデータを追加する必要があります。

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

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

  16. 以前の手順から出力を選択 フィールドで、テキスト ボックスを選択し、行を一覧表示 セクションにある を選択します。 アクションの追加 を選択して続行します。

    値が選択された [以前の手順から出力を選択] ボックスのスクリーンショット。

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

  18. 名前 に対して、先ほどフローで作成した変数の ContactInfo を選択します。

  19. 各人物の名前とメールを記載した箇条書きリストを作成します。 Power Automate では、テキストの書式設定に Markdown 構文を使用します。 Markdown で箇条書きリストを指定するには、行頭にアスタリスク文字 * を使用する必要があります。 Markdown について詳しくは、このモジュールの最後にある「まとめ」セクションを参照してください。

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

    1. アスタリスク * を入力し、その後にスペースを追加します。
    2. 動的コンテンツの 行を一覧表示名前 を選択し、その後にスペースを追加します。
    3. 動的コンテンツの 行を一覧表示 で、メール アドレス を選択します。
    4. Shift + Enter キーを押して新しい行を開始します。

    ステップが完了した値テキスト ボックスのスクリーンショット。

  20. Power Virtual Agents に値を返す を選択し、+ 出力の追加 をクリックします。

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

  22. タイトルの入力 テキスト ボックスに、情報の受け取りに使用する変数名である ContactData を入力します。

  23. 値を入力して応答してください フィールドには、フローで使用している変数を指定する必要があります。 テキスト ボックスをクリックし、変数 セクションで ContactInfo を選択します。

    [ContactInfo] が選択された [値を入力して応答してください] フィールドのスクリーンショット。

  24. 保存 を選択してフローの編集を完了します。 Power Automate により、問題を探すための フロー チェッカー が実行されます。 「...OData フィルター クエリ...」に関する警告が表示される場合がありますが、これは無視してかまいません。 閉じる を選択し、チャットボット エディターに戻ります。

  25. メッセージ ノードの後にある ノードの追加 アイコンを選択し、アクションの呼び出し を選択します。

  26. 作成したフローが一覧に表示されます。 営業チーム メンバーの取得 を選択します。

  27. アクション ノードの後に メッセージ ノードを追加します。

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

    [ContactData] オプションが選択されているスクリーンショット。

  29. 保存 を選択します。 ボットのテスト ペインが表示されていない場合は、ボットのテスト メニュー オプションを選択します。

トリガー フレーズのどれかを入力して、チャットボットをテストします。

テスト ボット メニュー ウィンドウのスクリーンショット。

ユーザーのニーズに応じて、Dataverse for Teams にある単一のレコードを検索できる詳細なフローがあります。 たとえば、特定の人物の連絡先情報を職務に基づいて取得する場合などに使用できます。 このモジュールでは扱っていませんが、Dataverse の [行を一覧表示] では、チャットボットでのユーザーの選択に基づいて OData フィルターを使用できます。 OData クエリの詳細については、このモジュールの最後にある「まとめ」セクションを参照してください。