用途 该技能面向 SAP Automation Pilot 中标签的选择、校验与解读。标签在 API 中以扁平的字符串到字符串映射表示,可附加到命令内、输入、执行和计划执行上,无值标签用空字符串表示,例如 {"team": "sre", "feature:logs": ""}。
标签分类与归属 标签分三类:普通标签(无前缀,用户可写,用于分组、过滤和选择的自由元数据);特性标签(前缀 feature:,用户可从受支持注册表中写入,用于启用可选产品行为);服务标签(前缀 autopi:,平台管理,描述生命周期、来源、状态和血缘)。应使用规范的小写前缀;服务前缀匹配不区分大小写,因此大小写变体不能绕过限制。不得在用户编写的载荷中创建、更新或复制 autopi: 标签,Automation Pilot 在触发时会剥离来源服务标签,并为新执行打上新服务标签。
特性标签 Automation Pilot 按固定允许列表校验特性标签,以下特性适用于命令、执行和计划执行:feature:priority 取 high、medium 或 low,当执行超出数量限制时优先删除低优先级执行;feature:autoAbort 取 1 到 168 的整数小时,失败执行在该时段内未修改则被中止;feature:retentionPolicy 取 archive 或 delete,默认归档已完成的执行;feature:retentionPeriod 取整数小时,archive 为 1-672,delete 为 0-672,删除时 0 表示完成即删除,默认保留期为 28 天;feature:logs 取空字符串,用于捕获详细执行器日志,须在执行开始前启用,完成后保留 72 小时。命令会将适用的特性标签传递给执行;计划可覆盖其触发执行继承的命令特性,直接触发也可同样覆盖。对可能需要排查的运行,应在触发前添加 feature:logs。
普通标签与校验规则 普通标签承载用户自定义元数据,如 environment、team、workflow、instance。校验规则:键必填,长度 1-128 字符,不能为空白且不能包含 =;值可选,最多 256 字符,无值用 "";键和值可使用 ASCII 字母、数字、空格及 _ . : / = + - @ 等字符,键的 = 限制仍适用。Automation Pilot 保留 autopi: 和 feature: 前缀,特性标签必须匹配允许列表。普通标签可驱动 API 过滤和自定义 UI 列,应选择稳定的键和值。
继承与优先级 命令标签可视为默认值。直接执行以命令的普通和特性标签为起点,Automation Pilot 添加触发请求中的标签并替换同键的命令标签;计划执行以命令标签为起点,添加计划标签并替换同键命令标签;子执行接收调用方提供的标签,并由平台添加描述父级和执行血缘的服务标签。平台不会从来源复制服务标签,而是为每个新执行创建 autopi: 标签。标签应放在命令上(适用于每次运行)、计划上(适用于该周期运行)或触发请求中(仅一次运行)。更新时应保留现有计划标签,除非用户要求删除或替换。
常见服务标签 服务标签用于解读和过滤返回资源,用户不编写。常见示例:autopi:scheduledExecution 记录触发该执行的计划执行 ID;autopi:userAgent 记录技术用户通过 API 触发时的 HTTP User-Agent(截断至 256 字符);autopi:mcpServerId 和 autopi:mcpToolName 记录 MCP 工具调用触发时的服务器 ID 和工具名;autopi:statusListenerOf 记录状态变化触发本执行的源执行 ID;autopi:childExecutionOf 记录由 TriggerExecution 或 ParallelForEach 创建的子执行的父执行 ID;autopi:parentExecutorPath 记录父级中创建子执行执行器的完整路径,如 parentAlias.childAlias.triggerStep。可使用执行列表的标签过滤,按继承的普通标签、特性标签或平台打的服务标签限定历史或分析范围。
限制 不得在标签中放入凭据或其他机密。特性标签须匹配允许列表,日志只能在执行开始前启用。以上为技能文档所述事实,具体 API 调用细节和平台其他能力暂未提供。