用途
该技能用于在 SAP Fiori 适配编辑器中通过运行时适配(RTA, Runtime Authoring)对 SAP Fiori 适配项目做 UI 修改,如添加按钮、字段、列或区块,以及在页面内容上执行相应的适配操作。它不直接操作浏览器,而是通过 fiori-mcp-server 暴露的 run_rta_workflow_step MCP 工具驱动 RTA;浏览器自动化由服务端完成,技能负责编排步骤顺序以及步骤之间的 AI 决策。
主要能力
- 通过单一工具 run_rta_workflow_step 按 step 参数分发不同操作,包含:start、get_page_actions、call_page_action、press_interactive、get_overlays、get_context、call_action、save、restart、stop。
- start 启动 RTA,指定编辑器站点与 frameId(标准预览 iframe 使用 "preview")。
- get_page_actions 返回 registered(框架/应用提供的高层页面操作,如 loadData、navigateToRow、navigateToSection、navigateBack)与 interactive(可点击控件扫描结果,最多 100 个,超出时带 interactiveTruncated 标记)。
- call_page_action 执行已注册页面操作;press_interactive 对可交互控件执行真实点击。
- get_overlays 返回可编辑控件(overlay)列表,含控制 ID、类型、标签、父元素与可用 actionIds,以及顶层去重的 actionsCatalog。
- get_context 获取元素类型、父聚合、操作参数 schema、默认子聚合及聚合信息等上下文。
- call_action 执行具体 RTA 操作(如 CTX_ADDXML 片段插入、CTX_EXTEND_CONTROLLER 控制器附加),save 保存,restart 重启,stop 停止。
使用方式
前置条件:
- @sap-ux/fiori-mcp-server 作为 MCP 服务器运行,提供 run_rta_workflow_step 等工具;安装说明见 https://www.npmjs.com/package/@sap-ux/fiori-mcp-server。
- 用户提供适配编辑器 URL。
- 服务端可启动基于 Chromium 的浏览器。解析顺序:环境变量 PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH(Chromium 绝对路径)、环境变量 PLAYWRIGHT_BROWSER_CHANNEL(chrome、msedge、chrome-beta 等)、系统 Google Chrome(默认通道)、Playwright 管理的 Chromium(1–3 失败时自动回退)。若无系统 Chrome 且无环境变量覆盖,可执行
npx playwright install chromium安装(首次约下载 120 MB)。
工作流要点:
- 一次交接只开一个会话。start 只调用一次,restart 最多一次(仅在所有片段/控制器文件写入磁盘后),stop 在最后只调用一次;所有变更作为步骤 3–9 的多次迭代,最后 save 一次。不要为每个变更重新 start。
- 步骤 1:start,传 site 与 payload { site, frameId: "preview" },确认 rtaStarted 为 true;若为 false,等待 3 秒重试一次。后续每一步都传 site 与 frameId。
- 步骤 2:必要时先导航到编辑目标。若 get_overlays 已能返回用户所指控件可跳过。优先匹配 registered 中的语义操作,无匹配时再用 interactive 点击;每次调用后重新 get_page_actions,直到目标可达。若返回 needs_user_action,将 reason 告知用户并等待解决。
- 步骤 3:get_overlays 获取可编辑控件。
- 步骤 4:AI 选择目标控件。对于 SmartTable、SmartList、sap.m.Table、sap.ui.table.Table、SmartChart 等数据绑定容器,必须先确认行数据已加载(用户明确说明或观察到行级 overlay),否则应通过 loadData 等已注册操作加载数据后重新获取 overlay;该门槛无条件适用,即使只是结构性修改。
- 步骤 5:AI 选择操作。只能从所选 overlay 的 actionIds 中挑选,并读取 actionsCatalog 中的参数 schema;未检查 schema 时置信度上限为 0.65;多个同动词候选需降 0.20;低置信度时应向用户列出可选操作并询问。
- 步骤 6:get_context 获取元素上下文与参数 schema。
- 后续按上下文准备 payload、调用 call_action、save,并在结束时 stop。
工具调用边界:run_rta_workflow_step 是技能内部调度器,不应随意调用;乱序调用会返回描述性错误。
适用场景
适用于使用 SAP Fiori Elements 或 Fiori 适配项目的团队,在适配编辑器中以自动化方式完成页面 UI 适配,例如新增按钮、字段、列或区块,插入 XML 片段,附加控制器扩展,以及在 List Report / Object Page 之间导航后进行编辑。
限制
- 需要 @sap-ux/fiori-mcp-server 正常运行,否则所有工具调用无法解析。
- 需要用户提供适配编辑器 URL,并具备可启动的 Chromium 类浏览器。
- 无服务端会话,工具按 URL 定位浏览器页面,因此 site 需在每一步传递。
- 步骤 4、5、8 需要 AI 判断,涉及置信度与人工确认规则;置信度不足时应询问用户而非静默执行。
- 数据绑定容器存在数据加载硬性门槛,未加载行数据时不能继续操作选择。
- 详细 RTA 操作字段 schema 与消歧表见 references/rta-actions.md,置信度与人工介入规则见 references/hitl-gating.md(资料中仅给出引用路径,具体内容暂未提供)。