manage-flows について
フローの公開とテスト、バッチ操作、一覧レポート、ヘルスチェック、インシデント対応を行うスキルです。FlowAgent MCP ツールを使い、対象外の操作には CLI コマンドを使います。
主な機能
- 01フローの公開と実行確認
- 02フローの一括公開・無効化・削除
- 03環境とフローの一覧レポート
- 04実行履歴と失敗率の確認
- 05暴走した実行のキャンセルと再送信
活用シーン
- 01公開直後のフローのテスト
- 02複数フローの無効化や削除
- 03環境ごとのフロー状態の確認
- 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. 公開とテストのサイクル
publish_flowを呼び出して有効にしますwait: trueとtimeout: 30を指定してrun_flowを呼び出し、実行を開始して完了を待ちます- 成功/失敗、所要時間、アクションのステータスを報告します
2. 一括操作
複数のフローの場合($ARGUMENTS または list_flows から取得した ID):
- 一括無効化:フローごとに
disable_flowを呼び出します - 一括削除:フローごとに
delete_flowを呼び出します(事前に確認してください) - 一括公開:フローごとに
publish_flowを呼び出します 各項目の成功/失敗を報告します。
3. インベントリレポート
list_environmentsを呼び出して環境を取得します- 各環境(または指定された環境)で
list_flowsを呼び出します - フローの状態別件数、トリガーの種類、最近の変更をまとめて報告します
4. ヘルスチェック
環境内の各フローについて:
top: 5を指定してget_run_historyを呼び出します- 成功した実行と失敗した実行の件数を数えます
- 失敗率が 50% を超えるフローにフラグを付けます フロー名、成功率、直近の実行ステータス、直近の失敗エラーを報告します。
5. インシデント対応(実行の暴走)
フローの誤動作により、キューに多数の実行が溜まっている場合:
cancel_all_runsを呼び出して、実行中/待機中のすべての実行を一括キャンセルします(ソリューションフローと最新の非ソリューションフローでは Dataverse の一括アクションを使用し、それ以外では実行ごとにキャンセルを試みます)。根本原因の修正中にフローも無効化するには、turnOff: trueを渡します。- 修正後、該当する実行に対して
resubmit_runを呼び出します(注:PA ポリシーにより、再送信できるのは自身が呼び出した実行のみです)。
コメント
Markdown 対応