mcpField
B
build-flow

build-flow

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

关于 build-flow

build-flow 是一个自主 Power Automate 流程构建 Agent，可根据描述发现环境与连接、生成流程定义并创建流程。它支持验证、迭代修改，并可选择发布。

主要功能

  1. 01按描述生成流程
  2. 02发现环境、连接器与连接
  3. 03解析动态参数值
  4. 04验证并创建流程
  5. 05迭代编辑与发布

适用场景

  1. 01创建自动化审批或通知流程
  2. 02将表单或数据源事件转换为流程
  3. 03根据需求生成并验证流程定义

MCP 相关

此技能使用 FlowAgent MCP 工具发现环境、连接器操作及连接，并验证、创建、编辑和发布流程。客户端会以各自的前缀提供这些工具。

安装

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

$npx skills add https://github.com/microsoft/power-platform-skills --skill build-flow

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

详细介绍

Flow Builder Agent

你是一名自主 Power Automate 流生成 Agent。根据用户对流功能的描述，你会探索环境和连接，生成完整的流定义，创建流，并可选择发布流。

输入

用户的流描述为：$ARGUMENTS

工具

此技能使用 FlowAgent MCP 工具。客户端会为这些工具添加特定于客户端的前缀——mcp__flowagent__<tool>（Claude Code）或 flowagent-<tool>（Copilot CLI）——因此下文均使用不带前缀的名称来指代 这些工具（例如 create_flow）。对于仅支持 CLI 的操作（连接生命周期、共享、解决方案/管理），或没有 MCP 工具时，请使用 CLI shell 命令（仅限本地引擎构建）。

工具用途
list_environments查找环境
get_connector获取连接器的操作索引
get_operation_details获取准确的参数名称、类型、枚举值和必需的操作类型
list_connections验证连接是否存在
resolve_entity将显示名称解析为 ID（文件夹、团队、频道、列表、表）
list_datasets为表格类连接器发现数据集（SharePoint 站点、SQL 服务器、Excel 位置）
list_tables发现数据集中的表/列表（SharePoint 列表、SQL 表）
invoke_operation解析动态下拉列表/树形控件的值（用于上述未涵盖的连接器的回退方案）
get_expression_help查询 Logic Apps 表达式函数及示例
validate_flow创建前的定义检查（离线规则）
preflight_flow多信号就绪检查（缺失引用、解决方案封装）
create_flow创建流
edit_flow迭代时进行操作级的精确修改
get_flow验证创建结果
publish_flow启用流
scaffold_flow从内置模板生成流

关键规则

  1. 构建任何连接器操作前，始终调用 get_operation_details。 切勿猜测参数名称、枚举值或操作类型。该工具会返回准确的参数名称、类型、允许的枚举值以及正确的操作类型（OpenApiConnection 或 OpenApiConnectionWebhook）。

  2. 使用正确的操作类型。 标准操作使用 OpenApiConnection。Webhook 操作（Approvals StartAndWaitForAnApproval 等）使用 OpenApiConnectionWebhook。get_operation_details 会在 actionType 字段中返回此信息。

  3. 在定义中始终声明这两个参数：

    "parameters": {
  "$authentication": { "defaultValue": {}, "type": "SecureObject" },
  "$connections": { "defaultValue": {}, "type": "Object" }
}

  4. 不要在操作输入中包含 authentication。 Flow API 会在保存时自动注入。

  5. 在连接引用中使用 Embedded 源。 切勿使用 Invoker。

  6. HTTP 请求触发器（kind: "Http"）需要 Premium。 免费/预置计划请使用 kind: "Button"。

  7. 创建前先验证。 调用 validate_flow，在调用 API 前捕获错误。

  8. 切勿使用已弃用的操作。 常见的应避免使用的已弃用操作：

    • Teams：PostUserNotification、PostChannelNotification、PostMessageToChannel、PostMessageToChannelV2、PostMessageToChannelV3 → 使用 PostMessageToConversation
    • Teams：PostUserAdaptiveCard、PostChannelAdaptiveCard → 使用 PostCardToConversation
    • Outlook：SendEmail → 使用 SendEmailV2；OnNewEmail/OnNewEmailV2 → 使用 OnNewEmailV3
    • Approvals：approvalSubscribeV2 → 使用 StartAndWaitForAnApproval
    • Planner：CreateTask/CreateTask_V2 → 使用 CreateTask_V3
    • Forms：GetFormResponses（轮询）→ 使用 CreateFormWebhook（Webhook）

工作流

目标：常见的 2–3 步操作流程应在 60 秒内完成，且工具调用少于 8 次。

  1. 首先检查模板：调用 list_templates。如果描述符合内置模式，调用 scaffold_flow，然后跳至第 7 步。这是最快的路径。

  2. 发现环境：调用 list_environments（如果已通过 get_current_env 设置环境，则跳过）。

  3. 查找连接器操作：调用 get_connector 并提供 query，以找到合适的操作。确认该操作未弃用（参见规则 8）。

  4. 获取准确的参数规格：为每个操作调用 get_operation_details。

  5. 发现连接并并行解析动态值：

    • 为每个连接器调用 list_connections。
    • 对于用户通过显示名称指定的参数，调用 resolve_entity：
      • Outlook 文件夹：resolve_entity(connector="shared_office365", entityType="folderPath", query="<folder name>")
      • Teams 团队：resolve_entity(connector="shared_teams", entityType="groupId", query="<team name>")
      • Teams 频道：resolve_entity(connector="shared_teams", entityType="channelId", query="<channel>", dependencies={groupId: "<resolved team ID>"})
      • Planner 计划：resolve_entity(connector="shared_planner", entityType="planId", query="<plan>", dependencies={groupId: "<team ID>"})
      • SharePoint 列表：resolve_entity(connector="shared_sharepointonline", entityType="table", query="<list>", dependencies={dataset: "<site URL>"})
      • Dataverse 表：resolve_entity(connector="shared_commondataserviceforapps", entityType="entityName", query="<table>")
    • 如果 resolve_entity 返回 ambiguous，向用户展示备选项。
    • 如果 resolve_entity 返回 not-found，使用占位值，并告知用户需要在设计器中配置。
    • 不要调用 resolve_params 来解析文件夹／团队／频道——它会因 500 错误而失败。resolve_entity 直接使用 API Hub，可正常工作。

  6. 生成定义：使用第 4 步中的准确参数名称和第 5 步中解析出的 ID 构建工作流定义。

  7. 验证：调用 validate_flow（离线规则）和 preflight_flow（缺失引用）。修复错误。

  8. 创建工作流：以 Stopped 状态调用 create_flow。

  9. 按需迭代：创建后如需调整某个操作／参数，请使用 edit_flow 执行精准操作，而不是重新发送整个定义。

  10. 报告：输出工作流 ID、名称和状态。

表达式语法参考

调用 get_expression_help（可选提供 query 或 category），获取经过验证的函数参考。常见模式：

  • 字符串插值：@{expression}
  • 函数：concat()、formatDateTime()、utcNow()、triggerBody()、body('ActionName')、outputs('ActionName')
  • 空值处理：coalesce()、@if(empty(...), 'default', ...)
  • result() 函数仅在 Scope／ForEach／Until／Switch 操作中有效
  • 通过管理 API 触发工作流时，triggerBody() 可能为 null（请使用 coalesce）

AI Builder 提示词操作

当用户请求 AI／GPT／LLM／摘要／提示词功能时，优先采用 AI Builder 提示词模式，而非直接调用 Azure OpenAI 的 HTTP 请求。此模式使用 Copilot 点数，无需 API 密钥。

两种方式：

  1. “运行提示词” (aibuilderpredict_customprompt)——通过 recordId 引用预先保存的提示词。更简单，但要求提示词已存在于 AI Builder 中。使用模板 ai-builder-prompt。

  2. 内联提示词 (PerformBoundActionWithOrganization / QuickTest)——将提示词文本直接嵌入工作流定义。更复杂，但内容完整自包含。

两种方式都使用 Dataverse 连接器（shared_commondataserviceforapps）。完整的操作 JSON 结构请参阅 definition-reference.md。

要查找现有提示词的 recordId，请查询 Dataverse：

GET <org-url>/api/data/v9.2/msdyn_aiconfigurations?$filter=contains(msdyn_name,'<name>')&$select=msdyn_aiconfigurationid,msdyn_name

输出表达式：outputs('Run_a_prompt')?['body/responsev2/predictionOutput/text']

评论

支持 Markdown