automation-pilot-command-generation

SAP Automation Pilot Command Development

This skill provides guidance for creating SAP Automation Pilot commands by composing existing reference commands from the content library.

Command Release Policy

Deployed commands start in DRAFT state. Do not release automatically — only release when:

1. The command has been tested and works correctly
2. The user explicitly requests release

Draft state allows safe iteration without affecting production.

Overview

SAP Automation Pilot commands are JSON definitions that automate operations on SAP BTP. Commands can be:

• Atomic: Execute a single operation (e.g., HttpRequest, SendEmail)
• Composite: Orchestrate multiple steps using executors

Reference Materials

• examples/ — Pattern examples (HTTP, ForEach, polling workflows)
• references/patterns.md — Common implementation patterns
• references/expressions.md — Expression language reference

Discovering Available Executors

Use the catalog-explorer skill to discover available executors via API:

# List available catalogs
curl -s -u "$AUTOPI_USERNAME:$AUTOPI_PASSWORD" \
  "https://$AUTOPI_HOSTNAME/api/v1/catalogs?own=false"

# Find commands in a catalog
curl -s -u "$AUTOPI_USERNAME:$AUTOPI_PASSWORD" \
  "https://$AUTOPI_HOSTNAME/api/v1/commands?catalog=applm-sapcp"

# Get full command definition (inputs, outputs, executors)
curl -s -u "$AUTOPI_USERNAME:$AUTOPI_PASSWORD" \
  "https://$AUTOPI_HOSTNAME/api/v1/commands/applm-sapcp:RestartCfApp:1"

This ensures you always use valid executor names and correct parameters, even for newly added catalogs.

Dry Run

dryRun is always present on every executor. Set it to null unless you have a specific reason to provide mock output.

"dryRun": null

The dryRun: {output: {...}} form (with mock values) is only needed if a downstream executor references this executor's output AND you want dry-run mode to propagate realistic values through the chain. In practice, null is the standard.