SuperAPI AI 工具集

automation-pilot-dynamic-expressions

编程与开发

查看项目

更新于 11-07 04:07

技能介绍

用途

该技能面向 SAP Automation Pilot 中的动态表达式工作:编写一个 $(...) 表达式或 responseBodyTransformer 管道,使其在所处位置上正确,并基于有代表性的、非敏感的数据进行推理与验证。它同时用于解释表达式行为和调试失败结果。

主要能力

  • 按表达式所处位置(命令值、输出值、HTTP responseBodyTransformer 或其他字段)确定包装语法:$() 替换、多替换命令值或裸 responseBodyTransformer。
  • 确认表达式必须产出的值及其类型,并梳理该位置可用的数据:父输入、元数据、更早执行器的别名、输出与实际序列化形式。
  • 构建最小代表性 JSON 夹具,保留相关路径与类型,用假值替换凭证、令牌、个人数据和生产负载。
  • 使用文档化的 Automation Pilot 元素及其确切拼写编写最小表达式,覆盖转换与序列化(toObject、toArray、toNumber、fromXml、toMinifiedJsonString 及编码与哈希)、字符串、集合、对象与安全、时间与标识符、数学与控制流等分组。
  • 手工追踪表达式对夹具的预期序列化输出,并与期望值做语义比对,覆盖引擎行为和作用于限制带来的相关边界情况。
  • 交付时给出确切表达式、预期位置、夹具形状、预期结果类型以及代表性用例和边界用例的预测结果。

使用方式

技能按四个步骤推进:第一步建立表达式上下文(位置、值类型、可用数据、夹具);第二步编写最小表达式,仅使用文档化元素与确切拼写,避免不必要的转换;第三步手工追踪,预测序列化输出并检查边界情况,依据证据修正而非套用标准 jq 行为;第四步交接,提供足够上下文使调用方能在不改变语义的前提下插入表达式。除非用户同时要求命令相关工作,否则不部署或执行命令。

适用场景

适用于需要在 Automation Pilot 中编写非平凡表达式、诊断表达式产生意外或空结果、解释表达式在特定位置的行为,以及为表达式失败做聚焦复现与修正的场景。表达式插入、完整定义校验与部署由 Command Authoring 负责;失败运行的证据收集由 Execution troubleshooting 负责。

限制与注意事项

Automation Pilot 使用自定义 jq 实现,增加了产品特有函数、限制与输出行为,部分地方偏离标准 jq;本地 jq 不能证明表达式在 Automation Pilot 中行为相同。表达式不能读取更晚的执行器;条件跳过的执行器可能没有输出。不得返回整个容器(如 .execution、裸 .<alias>、.<alias>.output),否则引擎会解析为静默 null,必须定位到具体字段。跨执行器边界的值以 JSON 字符串到达,需先用 toObject/toArray 解析再在内部选择。结果为空值或 null 会序列化为空输出,因此静默空结果不能证明空值处理路径有效。处理方式为报告由引擎行为产生的症状(缺数据或不可行转换导致的静默 null、多结果流造成的意外文本拼接、限制错误或作用域限制),并对照夹具诊断,而非臆造运行时状态。夹具场景的预期结果是文档化预测,而非引擎测试结果;在租户上验证时应记录服务版本和观察到的输出。其他未在资料中说明的细节暂未提供。