SuperAPI AI 工具集

build-flow

通用与其它

查看项目

更新于 10-16 00:31

技能介绍

用途:根据用户对流程功能的描述,自主完成 Power Automate 流程的发现、生成与创建,可选发布。

主要能力:通过 FlowAgent MCP 工具(客户端前缀如 mcp__flowagent__ 或 flowagent-)执行环境发现、连接器操作查询、参数规格获取、连接校验、实体解析、数据集与表发现、表达式帮助、流程校验与预检、创建、编辑、查询与发布,并支持从内置模板 scaffold_flow 生成。

使用方式:先调用 list_templates 检查模板,匹配则 scaffold_flow 并跳到创建;否则依次 list_environments、get_connector、get_operation_details、list_connections 与 resolve_entity(解析文件夹、团队、频道、计划、SharePoint 列表、Dataverse 表等显示名到 ID),再生成定义、validate_flow 与 preflight_flow 校验、create_flow 以 Stopped 状态创建,必要时用 edit_flow 做局部修改,最后 publish_flow 启用。构建任何连接器操作前必须先调用 get_operation_details,不得猜测参数名、枚举值或操作类型;标准操作用 OpenApiConnection,Webhook 操作(如 StartAndWaitForAnApproval)用 OpenApiConnectionWebhook。定义中需声明 $authentication 与 $connections 两个参数,动作输入中不要包含认证信息;连接引用使用 Embedded 而非 Invoker。HTTP Request 触发器(kind: Http)需 Premium,免费/种子计划用 kind: Button。避免已弃用操作,如 Teams 的 PostMessageToChannel 系列改用 PostMessageToConversation,Outlook SendEmail 改用 SendEmailV2,审批 approvalSubscribeV2 改用 StartAndWaitForAnApproval,Planner CreateTask 改用 CreateTask_V3,Forms 轮询改用 CreateFormWebhook。

适用场景:需要快速生成常见 2-3 个动作的 Power Automate 流程,目标在 60 秒内、少于 8 次工具调用完成。

限制:resolve_entity 返回 ambiguous 时需向用户展示备选,not-found 时用占位值并提示在设计器中配置;不要用 resolve_params 解析文件夹/团队/频道,会返回 500 错误。AI Builder 提示词操作优先于直接调用 Azure OpenAI,使用 Copilot 额度且无需 API 密钥。资料未提供具体收费、价格与平台支持范围。