SuperAPI AI 工具集

adp-controller-extension

前端与建站

查看项目

更新于 10-29 13:58

技能介绍

用途

该技能用于在 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 停止。

使用方式

前置条件:

  1. @sap-ux/fiori-mcp-server 作为 MCP 服务器运行,提供 run_rta_workflow_step 等工具;安装说明见 https://www.npmjs.com/package/@sap-ux/fiori-mcp-server。
  2. 用户提供适配编辑器 URL。
  3. 服务端可启动基于 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(资料中仅给出引用路径,具体内容暂未提供)。