用途
该技能用于为编码智能体提供面向客户的 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 响应。
- 获取交付物元数据,得到 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(落地页文件路径)。
- 带 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'
-
从目录中找出标题与用户问题最匹配的主题;若不确定,选取 2–3 个候选。
-
对每个候选主题获取页面内容并去除 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。
- 基于检索到的内容作答。
适用场景
- 需要查询 SAP UI theme designer 官方帮助文档时。
- 需要确认 UI theme designer 的功能边界(能做什么、不能做什么)时。
- 需要从 80 多个主题中定位特定主题内容时。
限制
- 文档来源限定为 help.sap.com 的 BTP / Cloud Foundry 版本。
- 依赖 help.sap.com 的 JSON HTTP API 可用性。
- 其他版本、其他产品或其他平台的文档暂未提供。