Create OOS automation templates with a skill

In the Agent mode of your AI agent platform, send the following prompt to add and configure the Skill:

Install the skill "alibabacloud-oos-template-generation" from GitHub repo aliyun/alibabacloud-aiops-skills. Skill path: skills/migrationom/oos/alibabacloud-oos-template-generation. After install, inspect the skill metadata and help me finish setup.

Download the Skill definition file from the GitHub repository and follow the documentation of your AI agent platform to add the Skill file to your project.

Generates an OOS automation template based on your operational requirements. The Skill performs requirement analysis, action queries, template generation, and syntax validation.

Example prompts:

• "Help me generate an OOS template to reboot an ECS instance."

• "Write an automation template to run a command on a specified instance."

• "Create a scheduled orchestration template to stop an ECS instance."

The Skill extracts the operation type, target resource, and region from the conversation, uses Alibaba Cloud CLI to find a suitable OOS action, and generates a complete template that includes FormatVersion, Description, Parameters, and Tasks. It then calls the ValidateTemplateContent API to validate the syntax before outputting the result.

Generates a template for batch operations on multiple resources. The Skill uses the OOS Loop mechanism to implement batch logic.

Example prompts:

• "Help me write a template to reboot multiple ECS instances in a batch."

• "Generate a template that first queries all instances and then stops them one by one."

For batch operations, the Skill uses the Loop property of a Task and the {{ ACS::TaskLoopItem }} loop variable to iterate through items. It also defines Outputs in a preceding Task for reference by subsequent Tasks.

Generates a multi-step orchestration template that supports output passing between steps and conditional branching.

Example prompts:

• "Generate a template that first creates a snapshot, and then reboots the instance after the snapshot is complete."

• "Help me orchestrate an automated task that decides whether to perform a reboot based on the instance status."

The Skill breaks down a requirement into multiple Tasks, passes output between steps by using the {{ taskName.outputField }} format, and uses the ACS::Choice action for conditional branching.

When validation fails, the Skill analyzes and fixes the error automatically. Common error types include:

• Invalid action: A non-existent action name is used. The Skill requeries the correct action name by using Alibaba Cloud CLI.

• Property name case mismatch: The case of action property names must exactly match the API definition. The Skill corrects the case based on the retrieved property definition.

• Incorrect YAML format: The indentation or quotation marks are incorrect. The Skill corrects the format and re-validates.

• Missing required fields: Fields such as FormatVersion, Description, or Tasks are missing. The Skill adds them and re-validates.

The OOS template generation Skill requires Alibaba Cloud CLI 3.3.3 or later. Run the following command to install or update it:

curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash

After installation, run aliyun version to confirm the version number.

The following actions do not exist in OOS. The Skill automatically uses an alternative.

Before you can reference the output of another Task, that Task must first define an Outputs block. The reference format is {{ taskName.outputField }}.

For example, use ACS::ExecuteAPI to query a list of instances and define the output, then iterate through the results in a subsequent Task by using a Loop:

Tasks:
  - Name: listInstances
    Action: ACS::ExecuteAPI
    Properties:
      Service: ecs
      API: DescribeInstances
      Parameters:
        RegionId: '{{ regionId }}'
    Outputs:
      instanceIds:
        Type: List
        ValueSelector: 'Instances.Instance[].InstanceId'
  - Name: rebootInstances
    Action: ACS::ECS::RebootInstance
    Properties:
      regionId: '{{ regionId }}'
      instanceId: '{{ ACS::TaskLoopItem }}'
    Loop:
      Items: '{{ listInstances.instanceIds }}'

If you encounter a permission error when you run a CLI command, the Skill indicates the required RAM permissions. Contact an administrator to grant the oos:ListActions and oos:ValidateTemplateContent permissions to the current account and then retry.