用途
该技能用于管理 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 前必须获取并展示当前参数、展示完整差异和最终载荷,并需用户在同一轮次中明确确认。
- 具体收费、价格、平台支持范围等信息暂未提供。