用途
该技能用于调试和排查 SAP Automation Pilot 执行失败问题。当执行失败、需要调查错误、检查执行健康状况(通过/失败)或分析错误模式时使用。它专注于故障排查,而非正常操作。
主要能力
- 快速诊断:通过 API 获取最近执行摘要、最近失败执行、最近成功执行。
- 调查特定执行:获取指定执行的详情和日志。
- 错误模式参考:识别常见错误并提供根因和修复方案,包括:
- 参数缺失但已提供(已知问题,建议避免必需输入参数或硬编码值)
- 认证配置缺失(需提供用户密码或客户端证书,或使用其他 SMTP 服务器/ANS)
- 敏感输入键默认值限制(移除 defaultValue,使用 defaultValueFromInput)
- 命令未找到或 404(检查命令 ID、发布状态)
- 执行卡在 RUNNING(等待延迟/轮询,或中止执行)
- HTTP 执行器返回意外状态(401/403、404、429、500/502/503、超时等)
- 表达式求值错误(添加空值检查)
- 调试工作流:分步指导获取执行状态、日志、输入,匹配错误模式,验证命令定义。
使用方式
通过 curl 命令调用 SAP Automation Pilot API,需设置环境变量 AUTOPI_USERNAME、AUTOPI_PASSWORD、AUTOPI_HOSTNAME。示例:
# 最近10次执行摘要
curl -s -u "$AUTOPI_USERNAME:$AUTOPI_PASSWORD" \
"https://$AUTOPI_HOSTNAME/api/v1/executions?limit=10"
# 最近5次失败执行
curl -s -u "$AUTOPI_USERNAME:$AUTOPI_PASSWORD" \
"https://$AUTOPI_HOSTNAME/api/v1/executions?status=FAILED&limit=5"
# 调查特定执行
EXEC_ID="your-execution-id"
curl -s -u "$AUTOPI_USERNAME:$AUTOPI_PASSWORD" \
"https://$AUTOPI_HOSTNAME/api/v1/executions/$EXEC_ID"
curl -s -u "$AUTOPI_USERNAME:$AUTOPI_PASSWORD" \
"https://$AUTOPI_HOSTNAME/api/v1/executions/$EXEC_ID/logs"
调试工作流步骤:
- 获取执行状态和错误详情
- 检查执行日志
- 检查使用的输入
- 匹配错误模式
- 验证命令定义
适用场景
- SAP Automation Pilot 执行失败时排查原因
- 检查执行健康状况(通过/失败)
- 分析错误模式并应用修复
- 调查特定执行的详情和日志
限制
- 仅用于故障排查,不适用于正常操作。
- 需要有效的 SAP Automation Pilot 凭据和主机名。
- 部分错误模式可能与环境或权限相关,修复方案需根据实际情况调整。
- 发布命令需用户明确请求并验证正确性。