mcpField
M
manage-flows

manage-flows

github.com/microsoft開発1.1k153 回インストール今日更新
リポジトリ

manage-flows について

フローの公開とテスト、バッチ操作、一覧レポート、ヘルスチェック、インシデント対応を行うスキルです。FlowAgent MCP ツールを使い、対象外の操作には CLI コマンドを使います。

主な機能

  1. 01フローの公開と実行確認
  2. 02フローの一括公開・無効化・削除
  3. 03環境とフローの一覧レポート
  4. 04実行履歴と失敗率の確認
  5. 05暴走した実行のキャンセルと再送信

活用シーン

  1. 01公開直後のフローのテスト
  2. 02複数フローの無効化や削除
  3. 03環境ごとのフロー状態の確認
  4. 04繰り返す失敗や待機中の実行の調査

MCP 対応

公開、実行、一覧取得、履歴確認などに FlowAgent MCP ツールを使います。MCP ツールがない場合や CLI 専用操作には CLI シェルコマンドを使います。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/microsoft/power-platform-skills --skill manage-flows

インストール後、Claude Code で/manage-flowsを入力して読み込まれたか確認します。

詳細

フローライフサイクルマネージャー

フローのライフサイクル操作(公開とテスト、一括操作、インベントリレポート)を行う自律型エージェントです。

ツール

このスキルではFlowAgent MCP ツールを使用します。ツールは名前のみで指定します(クライアントによって、Claude Code では mcp__flowagent__<tool>、Copilot CLI では flowagent-<tool> として表示されます)。CLI のみで実行できる操作(接続のライフサイクル、共有、ソリューション/管理者操作)や、MCP ツールがない場合は、CLI シェルコマンド(ローカルエンジンのビルドのみ)を使用してください。

機能

1. 公開とテストのサイクル
  1. publish_flow を呼び出して有効にします
  2. wait: true と timeout: 30 を指定して run_flow を呼び出し、実行を開始して完了を待ちます
  3. 成功/失敗、所要時間、アクションのステータスを報告します
2. 一括操作

複数のフローの場合($ARGUMENTS または list_flows から取得した ID):

  • 一括無効化:フローごとに disable_flow を呼び出します
  • 一括削除:フローごとに delete_flow を呼び出します(事前に確認してください)
  • 一括公開:フローごとに publish_flow を呼び出します 各項目の成功/失敗を報告します。
3. インベントリレポート
  1. list_environments を呼び出して環境を取得します
  2. 各環境(または指定された環境)で list_flows を呼び出します
  3. フローの状態別件数、トリガーの種類、最近の変更をまとめて報告します
4. ヘルスチェック

環境内の各フローについて:

  1. top: 5 を指定して get_run_history を呼び出します
  2. 成功した実行と失敗した実行の件数を数えます
  3. 失敗率が 50% を超えるフローにフラグを付けます フロー名、成功率、直近の実行ステータス、直近の失敗エラーを報告します。
5. インシデント対応(実行の暴走)

フローの誤動作により、キューに多数の実行が溜まっている場合:

  1. cancel_all_runs を呼び出して、実行中/待機中のすべての実行を一括キャンセルします(ソリューションフローと最新の非ソリューションフローでは Dataverse の一括アクションを使用し、それ以外では実行ごとにキャンセルを試みます)。根本原因の修正中にフローも無効化するには、turnOff: true を渡します。
  2. 修正後、該当する実行に対して resubmit_run を呼び出します(注:PA ポリシーにより、再送信できるのは自身が呼び出した実行のみです)。

コメント