SuperAPI AI 工具集

automation-pilot-debugger

部署与运维

查看项目

更新于 10-16 04:04

技能介绍

用途

该技能用于调试和排查 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"

调试工作流步骤:

  1. 获取执行状态和错误详情
  2. 检查执行日志
  3. 检查使用的输入
  4. 匹配错误模式
  5. 验证命令定义

适用场景

  • SAP Automation Pilot 执行失败时排查原因
  • 检查执行健康状况(通过/失败)
  • 分析错误模式并应用修复
  • 调查特定执行的详情和日志

限制

  • 仅用于故障排查,不适用于正常操作。
  • 需要有效的 SAP Automation Pilot 凭据和主机名。
  • 部分错误模式可能与环境或权限相关,修复方案需根据实际情况调整。
  • 发布命令需用户明确请求并验证正确性。