SuperAPI AI 工具集

generating-flow

编程与开发

查看项目

更新于 10-16 15:24

技能介绍

用途

generating-flow 用于生成 Salesforce Flow 元数据。当用户提出创建、构建或生成 Flow 的需求时(包括 Screen Flow 等类型),可使用该技能。其目标是通过运行必需的三步 MCP 流水线(fetchGroundedObjectMetadata → flowElementSelection → flowElementGeneration)并返回 Flow XML。

主要能力

可创建任意类型的 Flow,包括 Screen Flow(用户引导)、Autolaunched Flow(后台处理)、Record-Triggered Flow(数据库事件触发)和 Scheduled Flow(基于时间触发)。

通过声明式逻辑与分支自动化复杂业务流程;通过 Screen Flow 引导用户完成多步数据采集与决策工作流;对 Salesforce 记录自动执行 CRUD 操作;通过 Autolaunched Flow 执行后台处理与集成;通过 Record-Triggered Flow 实时响应记录变更;通过 Scheduled Flow 安排周期性任务与批量操作;创建可由管理员无需代码即可修改的可复用自动化。

使用方式

所有三步流水线必须通过 MCP 工具 execute_metadata_action 调用,action 参数选择要运行的步骤(fetchGroundedObjectMetadata、flowElementSelection 或 flowElementGeneration)。必须按顺序调用全部步骤,没有任何替代方法。

第一步(必需):fetchGroundedObjectMetadata 获取与流生成请求相关的组织架构元数据。输入:userPrompt(字符串,必需,用户的自然语言请求)、inflightMetadata(数组,必需,来自本地 sfdx 项目的自定义对象/字段,无则用空数组 [])。输出 groundingMetadata(字符串,直接传给第二步,无需再次序列化)。

第二步(必需):flowElementSelection 根据用户提示和 groundingMetadata 选择流元素(赋值、决策、记录操作等)及其连接。输入:userPrompt(字符串,必需,须与第一步相同)、groundingMetadata(字符串,必需,必须为第一步输出的原字符串,直接传入,不要再次序列化)、operationId(字符串,必需,首次调用用空字符串 "")。输出 operationId(传给第三步)和 userOutput(后续步骤推理,可展示给用户)。

第三步(必需):flowElementGeneration 逐元素生成流元数据,必须在第二步后调用,并循环调用直到 isComplete 为 true。输入:operationId(字符串,必需,来自第二步输出)、requestSource(字符串,必需,使用 "A4V" 获得 XML 格式的流元数据)。输出 isComplete(布尔值,须检查)和 result(仅当 isComplete 为 true 时包含最终流元数据)。

必须循环直到完成,绝不暂停或询问用户是否继续。一个流可包含任意数量元素(10、15 或更多),每次调用生成一个元素,需要多次迭代是正常预期。每次调用后用同一 operationId 继续调用,直到 isComplete 为 true 或返回错误。无最大迭代次数限制。当 isComplete 为 true 时从 result 字段提取流元数据;若返回错误,停止循环并向用户呈现错误。

inflightMetadata 格式

数据类型为数组(非字符串)。命名约定必须严格遵守:对象 API 名用 apiName(不用 objectApiName、name、objectName);字段 API 名用 apiName(不用 fieldApiName、name、fieldName);字段类型用 type(不用 fieldType、dataType);查找目标用 referenceTo(不用 relatedTo、lookupTo、reference)。

支持的字段类型:Text、Textarea、Number、Picklist、Lookup、Email、Phone、URL、Date、Datetime、Boolean、Checkbox、Currency、Percent。

无自定义对象时使用 [](空数组,而非字符串 "[]")。有相关自定义对象时,需从本地 sfdx 项目扫描并提取相关对象和字段,以结构化对象数组传入。

适用场景

创建各类 Flow(Screen、Autolaunched、Record-Triggered、Scheduled);生成 Flow 元数据 XML;无代码自动化业务流程;构建用户引导的工作流或后台自动化;排查与 Flow 相关的部署错误。

限制与强制约束

必须遵循精确的三步流水线,不得手工创建流元数据 XML,或不通过该流水线生成流元数据。不得使用任何其他工具、API 或方法生成流元数据。任何偏离都会产生无效或损坏的元数据。对流水线返回的 XML 有严格约束:不得修改任何块内的内容、值或子节点;不得添加新节点、标签、属性或文本(包括缺失的 label、X/Y 坐标等);不得删除任何现有节点。

唯一例外:当用户明确要求修复已生成 Flow XML 的验证或部署错误时,允许进行针对性的手工编辑以解决这些错误。

对于多流请求,必须先检查请求是否包含多个流,若有则拆分为多个单流提示,每个流拥有自己的三步流水线和仅描述该流自己的 userPrompt。绝不将多流请求作为单个 userPrompt 传入。所有流水线必须顺序执行(一个接一个),绝不并行。完成当前流的三步流水线(包括循环第三步直到 isComplete 为 true 或返回错误)后,才能开始下一个流的流水线。不得交叉或并行。完成一个流的流水线后立即开始下一个,不得暂停、总结或等待用户确认。若需生成 N 个流,则必须有 N 个独立的三步流水线且全部执行。每个流流水线的 inflightMetadata 只能包含与该流相关的对象/字段。