mcpField
M
manage-flows

manage-flows

github.com/microsoft开发1.1k153 次安装今天更新
代码仓库

关于 manage-flows

用于管理 Flow 生命周期的技能,涵盖发布测试、批量操作、清单报告、健康检查和事件处理。它使用 FlowAgent MCP 工具;这些工具未覆盖的操作则使用 CLI 命令。

主要功能

  1. 01发布 Flow 并验证运行结果
  2. 02批量发布、停用或删除 Flow
  3. 03汇总环境与 Flow 清单
  4. 04检查运行历史和失败率
  5. 05取消失控运行并重提符合条件的运行

适用场景

  1. 01发布后立即测试 Flow
  2. 02批量停用或删除 Flow
  3. 03查看各环境中的 Flow 状态
  4. 04调查反复失败或排队中的运行

MCP 相关

使用 FlowAgent MCP 工具执行发布、运行、列表查询和历史检查等操作。仅在 MCP 工具不可用或操作仅由 CLI 支持时使用 CLI shell 命令。

安装

复制下面的命令,在终端中运行。

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

安装后在 Claude Code 中输入/manage-flows确认已加载。

详细介绍

Flow 生命周期管理器

用于管理 Flow 生命周期操作的自主 Agent:发布并测试、批量操作、清单报告。

工具

此技能使用 FlowAgent MCP 工具,以下均以裸名称引用(在 Claude Code 中,客户端会将其显示为 mcp__flowagent__<tool>;在 Copilot CLI 中,则显示为 flowagent-<tool>)。对于仅支持 CLI 的操作(连接生命周期、共享、解决方案/管理),或在没有 MCP 工具时,请使用 CLI shell 命令(仅用于本地引擎构建)。

功能

1. 发布并测试周期
  1. 调用 publish_flow 以启用
  2. 调用 run_flow,并设置 wait: true 和 timeout: 30,以触发运行并等待完成
  3. 报告:通过/失败、持续时间、操作状态
2. 批量操作

对于多个 Flow(ID 来自 $ARGUMENTS 或 list_flows):

  • 批量禁用:对每个 Flow 调用 disable_flow
  • 批量删除:对每个 Flow 调用 delete_flow(先确认)
  • 批量发布:对每个 Flow 调用 publish_flow 逐项报告成功/失败。
3. 清单报告
  1. 调用 list_environments 获取环境
  2. 对每个环境(或指定的环境)调用 list_flows
  3. 生成摘要:按状态统计 Flow 数量、触发器类型、近期修改
4. 健康检查

对于环境中的每个 Flow:

  1. 调用 get_run_history,并设置 top: 5
  2. 统计成功与失败的运行次数
  3. 标记失败率 >50% 的 Flow 报告:Flow 名称、成功率、上次运行状态、上次失败错误。
5. 事件响应(运行失控)

当 Flow 因异常触发而产生大量排队运行时:

  1. 调用 cancel_all_runs,批量取消所有正在运行/等待中的运行(对解决方案 Flow 和现代非解决方案 Flow 使用 Dataverse 批量操作;否则逐次运行回退)。传入 turnOff: true,还可在修复根本原因期间禁用该 Flow。
  2. 修复后,对受影响的运行调用 resubmit_run(注意:根据 PA 策略,只有自行调用的运行才能重新提交)。

评论

支持 Markdown