SuperAPI AI 工具集

ui-theme-designer-help

设计与创作

查看项目

更新于 10-16 03:52

技能介绍

用途

该技能用于为编码智能体提供面向客户的 SAP UI theme designer 帮助内容,来源为 help.sap.com 上的 BTP / Cloud Foundry 版本文档。当需要确认 UI theme designer 能做什么、不能做什么时,可使用该技能查询官方文档。

主要能力

  • 通过 help.sap.com 的 JSON HTTP API 获取 UI theme designer 文档。
  • 获取交付物元数据:将人类可读标识符解析为内部 ID,并提供可读 URL 到 loio 的扁平映射。
  • 获取单个主题的 HTML 正文,并可选获取完整的层级目录(TOC)。
  • 目录树为递归结构,节点格式为 {t: 标题, u: 文件名, c: 子节点[]},覆盖全部 80 多个主题。

使用方式

使用 curl -s 调用所有 API 端点,使用 jq 解析 JSON 响应。

  1. 获取交付物元数据,得到 deliverable_id 和 buildNo:

curl -s "https://help.sap.com/http.svc/deliverableMetadata?product_url=btp&deliverable_url=ui-theme-designer&version=LATEST" | jq '{id: .data.deliverable.id, buildNo: .data.deliverable.buildNo, filePath: .data.filePath}'

该接口返回 data.deliverable.id(deliverable_id)、data.deliverable.buildNo 以及 data.filePath(落地页文件路径)。

  1. 带 deliverableInfo=1 获取落地页,得到完整目录树:

curl -s "https://help.sap.com/http.svc/pagecontent?deliverableInfo=1&deliverable_id={id}&buildNo={buildNo}&file_path={filePath}" | jq '.data.deliverable.fullToc'

  1. 从目录中找出标题与用户问题最匹配的主题;若不确定,选取 2–3 个候选。

  2. 对每个候选主题获取页面内容并去除 HTML 标签:

curl -s "https://help.sap.com/http.svc/pagecontent?deliverable_id={id}&buildNo={buildNo}&file_path={loio}.html" | jq -r '.data.body' | sed 's/<[^>]*>//g' | tr -s '\n'

页面内容接口返回 data.body(HTML)。若附加参数 deliverableInfo=1,还会返回 data.deliverable.fullToc。

  1. 基于检索到的内容作答。

适用场景

  • 需要查询 SAP UI theme designer 官方帮助文档时。
  • 需要确认 UI theme designer 的功能边界(能做什么、不能做什么)时。
  • 需要从 80 多个主题中定位特定主题内容时。

限制

  • 文档来源限定为 help.sap.com 的 BTP / Cloud Foundry 版本。
  • 依赖 help.sap.com 的 JSON HTTP API 可用性。
  • 其他版本、其他产品或其他平台的文档暂未提供。