用途
该技能用于通过一个强制性的三步 MCP 流水线生成 Salesforce Flow 元数据,并返回 Flow XML。适用的场景包括:创建任意类型的 Flow(Screen、Autolaunched、Record-Triggered、Scheduled)、生成 Flow 元数据 XML、以无代码方式自动化业务流程、构建用户引导工作流或后台自动化,以及排查与 Flow 相关的部署错误。
主要能力
Salesforce Flow 是无代码自动化工具,可通过交互式屏幕收集和处理数据、执行逻辑和计算、操作记录、调用外部服务,并基于各类事件触发。Flow 类型包括 Screen Flows(用户引导)、Autolaunched Flows(后台处理)、Record-Triggered Flows(数据库事件)和 Scheduled Flows(时间驱动)。该技能可生成这些类型的 Flow 元数据 XML。
使用方式
该技能规定必须遵循一个精确的三步流水线,不允许任何例外、捷径或跳过步骤,且不得手动创建 Flow 元数据 XML,也不得使用任何其他工具、API 或方法生成 Flow 元数据。
所有三步都必须通过 MCP 工具 execute_metadata_action 调用,action 参数用于选择要运行的步骤:"fetchGroundedObjectMetadata"、"flowElementSelection" 或 "flowElementGeneration"。
第一步(必需):fetchGroundedObjectMetadata 获取与 Flow 生成请求相关的组织架构元数据。必须始终首先调用。 输入(均为必需):userPrompt(字符串,用户的自然语言请求);inflightMetadata(数组,来自本地 sfdx 项目的自定义对象/字段,若无则需要则使用空数组 [])。 输出:groundingMetadata(字符串,相关组织架构元数据,以 JSON 字符串返回,必须直接传递给第二步,无需再次序列化)。
第二步(必需):flowElementSelection 根据用户提示和接地元数据选择 Flow 元素(赋值、决策、记录操作等)及其连接。必须在第一步之后调用。 输入(均为必需):userPrompt(字符串,必须与第一步相同);groundingMetadata(字符串,必须是第一步输出的确切字符串,直接传递,不要再次序列化);operationId(字符串,首次调用使用空字符串 "")。 输出:operationId(字符串,必须传递给第三步);userOutput(字符串,后续步骤的推理,可向用户展示)。
第三步(必需):flowElementGeneration 逐元素生成 Flow 元数据。必须在第二步之后调用,并且必须在循环中反复调用,直到 isComplete 为 true。 输入(均为必需):operationId(字符串,来自第二步输出);requestSource(字符串,请求来源,使用 "A4V" 获取 XML 格式的 Flow 元数据)。 输出:isComplete(布尔值,指示 Flow 生成是否完成,必须检查);result(字符串,Flow 元素生成的结果,仅当 isComplete 为 true 时包含最终 Flow 元数据)。
必须循环直到完成,绝不要暂停或要求用户确认继续。一个 Flow 可以有任意数量的元素(10 个、15 个或更多),每次调用生成一个元素,因此可能需要多次迭代,这是正常预期。每次调用后检查 isComplete 输出和 result 字段。如果 isComplete 为 false 且未返回错误,必须使用第二步的同一 operationId 再次调用 flowElementGeneration。不要询问用户是否继续,不要暂停,不要在循环中途总结进度,一直调用直到 isComplete 为 true 或可调用操作返回错误。迭代次数没有上限。当 isComplete 为 true 时,从 result 字段提取 Flow 元数据。如果返回错误,停止循环并向用户暴露错误。
严格约束(关键):不得修改任何块内的内容、值或子节点;不得添加新节点、标签、属性或文本(不要添加缺失的标签、X/Y 坐标等);不得删除任何现有节点。
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。
当需要自定义对象时,需使用结构化的对象数组格式(包含 type、apiName、label、fields、relationships),字段对象包含 apiName、type、label,Picklist 类型包含 values,Lookup 类型包含 referenceTo。当不需要自定义对象时,使用 []。
必须的决策逻辑:首先扫描本地 sfdx 项目,查找与用户 Flow 请求相关的自定义对象和字段。如果找到相关自定义对象,必须提取并作为结构化对象数组传递;如果未找到相关自定义对象,必须传递空数组 [](不是字符串 "[]")。绝不要传递文本描述、指令或字符串表示。数据类型必须是数组,不是字符串。只包含与正在生成的 Flow 相关的对象和字段。
强制增强规则
userPrompt 为必需。如果用户请求单个 Flow,按原样使用用户的提示。如果用户请求多个 Flow,必须拆分请求,为每个单独的 Flow 编写单独的、聚焦的 userPrompt,每个 userPrompt 只能描述一个 Flow,不要将整个多 Flow 请求作为单个 userPrompt 传递。
inflightMetadata 为必需,始终使用数组数据类型。
多 Flow 处理
在调用任何流水线步骤之前,先检查用户请求是否包含多个 Flow。如果包含,必须拆分为单独的单 Flow 提示。每个 Flow 拥有自己的三步流水线,其 userPrompt 只描述该单个 Flow。绝不将多 Flow 请求作为单个 userPrompt 字段传递,绝不将多个 Flow 描述合并到一个 userPrompt 中。
当用户请求多个 Flow 时,必须:将请求拆分为单独的各 Flow 描述;为每个 Flow 运行单独的三步流水线,userPrompt 只描述该单个 Flow;按顺序一个接一个地执行所有流水线,绝不并行;不要只生成第一个 Flow 就停止,不要等待用户要求继续,不要总结后就停止,继续直到每个请求的 Flow 都已完全生成。
如果有 N 个 Flow 要生成,必须有 N 个单独的三步流水线,并且所有 N 个流水线都必须执行。在开始下一个 Flow 的流水线之前,必须完全完成当前 Flow 的三步流水线(包括循环第三步直到 isComplete 为 true 或返回错误)。不要跨 Flow 交错或并行化流水线,一切都按顺序执行,绝不并行。完成一个 Flow 的流水线后,立即开始下一个 Flow 的流水线,不要暂停、总结或等待用户确认。对于每个 Flow,必须扫描本地 sfdx 项目以填充该 Flow 提示特定的自定义对象/字段。每个 Flow 流水线必须有自己的 inflightMetadata,仅包含该特定 Flow 相关的对象/字段。
示例工具调用
示例 1:仅标准对象(无自定义对象) 第一步 fetchGroundedObjectMetadata:userPrompt 为"创建一个名为 Daily_Good_Morning 的计划触发 Flow,每天上午 6:00 运行并向运行用户发送包含早安问候的邮件",inflightMetadata 为 []。 第二步 flowElementSelection:传入相同 userPrompt、第一步的 groundingMetadata 字符串(直接传递,不要再次序列化)、operationId 为空字符串 ""。 第三步 flowElementGeneration:传入第二步的 operationId 和 requestSource 为 "A4V",循环调用直到 isComplete 为 true 或返回错误。
示例 2:使用本地 sfdx 项目的自定义对象 第一步:userPrompt 为"创建一个 Flow,在 Customer Request 被分配时更新其状态",inflightMetadata 包含 CustomerRequest__c 对象及其 Status__c(Picklist,值为 New、In Progress、Completed)和 AssignedTo__c(Lookup,referenceTo 为 User)字段。 第二步和第三步同示例 1。
强制最佳实践
始终遵循三步流水线:fetchGroundedObjectMetadata → flowElementSelection → flowElementGeneration。这是生成 Flow 元数据的唯一方式,没有替代方案。不要在此流水线之外手动创建 Flow 元数据 XML、JSON 或任何其他格式。不要试图通过跳过或组合步骤来"优化",每一步都是原子且必需的。绝不跳过流水线中的任何步骤,所有 3 步都是必需的。绝不在未调用所有 3 步的情况下生成 Flow 元数据。绝不在任何情况下偏离此流水线,即使你认为自己知道 Flow 结构。对于单个 Flow 请求,必须将用户提示用作 userPrompt。对于多个 Flow 请求,必须为每个 Flow 按顺序运行单独的三步流水线,并执行所有流水线,不要只生成第一个 Flow 就停止。必须将 Flow 需求放在 userPrompt 中,而不是 inflightMetadata 中。inflightMetadata 仅用于本地项目的自定义对象/字段元数据,没有例外。
适用场景与限制
适用场景:需要在 Salesforce 组织中创建或生成各类 Flow 的无代码自动化需求;需要生成符合规范的 Flow 元数据 XML。 限制:必须通过指定的 MCP 工具和精确的三步流水线执行;不得手动创建元数据;不得修改、添加或删除生成块内的节点;多 Flow 必须串行处理;未提供关于收费、价格或平台兼容性的其他信息。