Add an Ansible Automation Platform job template step

The details panel opens.

After you select an integration, a credential status appears below the field. If a credential is already configured, its name appears. If no credential is configured, click Set up connection and select a credential from the dropdown. To create a new credential without leaving the step configuration, select Create new credential at the top of the dropdown.

If you open an existing step and the previously selected integration is no longer available, a warning appears. The system clears the integration and credential fields. Select a new integration to continue.

• To manually select a specific job template:

  1. In the Organization field, select the Ansible Automation Platform organization that contains the job template you want to run. When you select an organization, the Job template dropdown populates with the available job templates.
  2. Select a job template. The field supports typeahead search. After you select a template, a View job template in AAP link appears so you can verify the template configuration.

• To use expressions to select the job template dynamically based on output from a previous step:

  1. Toggle Use input variables at the top of the Parameters pane. Text fields that accept expressions and input variables replace the Organization and Job template dropdowns. Any enabled prompt-on-launch fields appear.
  2. In the Organization field, enter the organization name or drag an expression from the Input pane.
  3. In the Job template field, enter the template name or drag an expression from a previous step's output. For example, drag output.job_template_name from a task agent step that analyzed logs and recommended a specific remediation template.

• Run type: Select Run for normal execution or Check (Dry Run) to validate without making changes.
• Inventory: Override the default inventory.
• Credentials: Select one or more Ansible Automation Platform credentials to attach to the job.
• Execution environment: Override the default execution environment.
• Limit: Enter a host pattern to restrict which hosts the job runs against.
• Job tags: Enter tags to filter which tasks run. Type a tag and press Enter or comma to add it.
• Skip tags: Enter tags for tasks to skip.
• Extra variables: Enter additional variables as a JSON object. Click the expand icon to open a larger editor.
• Verbosity: Set the logging verbosity level from 0 (Normal) to 5 (WinRM Debug).
• Forks: Set the number of parallel processes.
• Job slicing: Set the number of job slices for parallel execution across inventory segments.
• Show changes: Enable diff mode to see detailed change output.
• Instance groups: Override the default instance groups.
• Labels: Select or create labels for the job.

• On failure behavior: Controls what happens when a step fails.

  • System default: Uses the system-wide setting configured by an administrator.
  • Continue on failure: The step is marked as failed and the workflow continues to the next step.
  • Stop workflow or branch on failure: The step fails and the workflow or current branch stops execution.

• Timeout: The maximum number of seconds the step can run before automation orchestrator marks it as failed with a timeout error. If left unset, the step uses the global default for its step type.

• Retry policy: Configures automatic retry behavior when a step fails due to transient errors. Toggle Override retry policy to enable the following fields:

  • max_retries: The number of retry attempts after the initial failure.
  • initial_interval: Seconds to wait before the first retry.
  • max_interval: Maximum seconds to wait between retries.
  • backoff_coefficient: Multiplier applied to the wait interval after each retry (1.0 = fixed interval, greater than 1.0 = exponential backoff).

  When the toggle is off, the system default retry policy applies.