SuperAPI AI 工具集

genai-hub-tabular-orchestration

数据与分析

查看项目

更新于 10-16 02:22

技能介绍

用途

该技能用于管理 SAP AI Core 的 Context Registry(TCR),将结构化数据以三层资源的形式暴露给 AI Core 场景:数据目标(Data Destination)→ 表格工件(Tabular Artifact)→ 场景配置(Scenario Configuration)。同时支持向已部署的表格 RPT 模型发送预测请求。

主要能力

数据目标(Data Destination)

存储 HDL(HANA Data Lake)端点的连接凭据。创建时系统会验证连接并安全存储凭据。支持列出、获取详情、创建、更新标签、按标签搜索和删除。删除会级联删除所有引用该目标的表格工件。

创建后需在 HDL 中注册主体模式(subject patterns):创建成功后响应会包含一个或多个 X.509 主体 DN,需将其作为授权添加到 HDL Files 服务实例配置中。此步骤需要子账户管理员或服务管理员角色,变更生效可能有 1–2 分钟延迟。

表格工件(Tabular Artifact)

将数据目标上的文件注册为可查询的虚拟表。支持 CSV、Parquet 和 Delta 格式。三种模式定义方式:

  • AUTO:由系统从文件自动推导模式,仅需 definitionType: AUTO。
  • DOCUMENT:内联提供列名和类型,推荐使用 --csn-columns col:cds.Type,...。
  • REFERENCE:指向数据目标上的 CSN 文件,通过 documentReference.path 指定。

支持列出、获取详情、创建和删除。删除为异步操作(202 Accepted),工件会转为 DELETING 状态。

场景配置(Scenario Configuration)

命名的、可复用的表格工件名称列表,供 AI Core 场景在推理时按名称引用。支持列出、获取详情、创建、更新(替换整个列表)和删除。

表格预测(predict.py)

向已部署的表格 RPT 模型(sap-rpt-1-small 或 sap-rpt-1-large)发送推理请求。模型从 TCR 读取上下文行,为查询行预测值。

使用方式

所有脚本需在技能根目录下通过 uv run scripts/<name>.py 执行。SDK 从环境变量读取凭据,禁止打印或记录凭据值。变更类脚本需要 --confirm,删除操作必须显式传入。未指定资源组时省略 --resource-group,使用 SDK 默认值。

快速开始流程:检查设置 → 列出三类资源 → 注册 HDL 数据目标 → 注册表格工件(AUTO 模式,CSV)→ 创建场景配置。

预测请求前必须确认 TCR 前置条件(数据目标 → 表格工件 → 场景配置)已就绪。rows 和 columns 在预测请求中互斥,不可同时包含。凭据或认证错误时先调用 aicore-admin-resources。

交互式构建流程包括:确认 TCR 前置条件、解析 scenarioConfigName 和 deploymentId、收集并格式化数据、构建 predictionConfig、构建 contextSelectionConfig、组装并发送。

适用场景

适用于需要将 HDL 上的结构化数据(CSV/Parquet/Delta)注册为可查询表,并通过 AI Core 场景进行表格预测的场景。典型流程为:注册数据目标 → 注册表格工件 → 创建场景配置 → 发送预测请求。

限制

  • 名称约束:数据目标和场景配置为小写字母、数字、连字符,1–127 字符,须以字母数字开头和结尾;表格工件为 1–80 字符。
  • 标签遵循 (ext|int).ai.sap.com/<suffix> 模式。
  • 预测目标列必须包含 "[PREDICT]" 占位符。
  • 表格工件删除为异步操作。
  • 主体模式注册需要子账户管理员或服务管理员角色,变更生效有 1–2 分钟延迟。
  • 执行 btp update services/instance 前必须获取并展示当前参数、展示完整差异和最终载荷,并需用户在同一轮次中明确确认。
  • 具体收费、价格、平台支持范围等信息暂未提供。