training/data/raw/about-aws-devops-agent-managing-assets.md

Managing Assets

AWS DevOps Agent stores the configuration and reference material for an Agent Space as assets, the customer-managed resources that shape what the agent knows and how it behaves. Skills, AGENTS.md files, and attachments are all assets, and you can create, read, update, and delete them programmatically through the Asset API.

When to use the Asset API

The Operator Web App is the fastest way to author a single skill or upload an AGENTS.md file interactively. The Asset API exposes the same operations programmatically so that scripts and automation can manage assets without going through the Web App. Common reasons to call the Asset API directly include:

• Authoring or updating an asset from a script, terminal, or notebook instead of the Web App.
• Bulk-loading a starter set of skills or AGENTS.md files into a new Agent Space.
• Reading an asset's contents to back it up or compare versions.

Every operation in the Asset API is exposed through the AWS CLI as aws devops-agent <operation> and through the AWS SDKs as the devops-agent client.

Asset API operations

Operation	Description	IAM action	Resource
ListAssetTypes	List the asset types supported by AWS DevOps Agent.	aidevops:ListAssetTypes	*
CreateAsset	Create a new asset in an Agent Space.	aidevops:CreateAsset	Agent Space
GetAsset	Retrieve an asset's metadata and version information.	aidevops:GetAsset	Agent Space
UpdateAsset	Update the metadata or content of an existing asset.	aidevops:UpdateAsset	Agent Space
DeleteAsset	Delete an asset and all of its files from an Agent Space.	aidevops:DeleteAsset	Agent Space
ListAssets	List assets in an Agent Space, with optional filtering.	aidevops:ListAssets	Agent Space
ListAssetVersions	List the historical versions of an asset.	aidevops:ListAssetVersions	Agent Space
GetAssetContent	Download an asset's full content as a zip bundle.	aidevops:GetAssetContent	Agent Space
CreateAssetFile	Add a new file to an existing asset.	aidevops:CreateAssetFile	Agent Space
GetAssetFile	Retrieve a single file from an asset by its path.	aidevops:GetAssetFile	Agent Space
UpdateAssetFile	Replace the content or metadata of an existing file.	aidevops:UpdateAssetFile	Agent Space
DeleteAssetFile	Remove a single file from an asset.	aidevops:DeleteAssetFile	Agent Space
ListAssetFiles	List the files within an asset.	aidevops:ListAssetFiles	Agent Space

Asset types

Every asset has an assetType string that identifies what kind of resource it is. Three asset types can be created through the Asset API: skill, agents_md, and attachment.

skill

A skill asset packages instructions and reference material that the agent loads when relevant. A simple skill is a single SKILL.md file; a complex skill is a zip bundle.

Required metadata properties:

• name (string) – A unique identifier for the skill. Lowercase letters, numbers, and hyphens only, 1-64 characters.
• description (string) – A 1-1024 character explanation of when the agent should use the skill.
• agent_types (array of strings) – One or more agent types this skill applies to.

Optional metadata properties:

• skill_type (string) – Defaults to USER.
• status (string) – ACTIVE or INACTIVE. Defaults to ACTIVE.
• enable_tools (array of strings) – A list of tool identifiers the agent can call when it loads this skill.

agents_md

An agents_md asset is a markdown file containing standing agent instructions for a specific agent type.

Required metadata properties:

• agent_type (string) – The agent type the AGENTS.md file applies to.

Limits: Each Agent Space can contain at most one AGENTS.md per agent_type. Maximum 25 KB.

attachment

An attachment asset stores a binary or text file that the agent can reference during investigations.

Required metadata properties:

• filename (string) – The original file name.
• extension (string) – The file extension without the leading dot.
• size (number) – The size of the file in bytes.

Managing a skill end-to-end

Create a skill from a single text file

aws devops-agent create-asset \
  --agent-space-id 8f6187a7-0388-4926-8217-3a0fe32f757c \
  --asset-type skill \
  --metadata '{
    "name": "rds-performance-investigation",
    "description": "Investigation procedures for RDS performance issues.",
    "agent_types": ["GENERIC"]
  }' \
  --content '{
    "file": {
      "path": "SKILL.md",
      "body": {
        "text": "# RDS Performance Investigation\n\nUse this skill when customers report database latency."
      }
    }
  }'

Create a skill from a zip bundle

base64 -w 0 rds-performance-investigation.zip > skill.zip.b64
aws devops-agent create-asset --cli-input-json file://create-skill.json

Get, list, update, and delete

aws devops-agent get-asset --agent-space-id <id> --asset-id <assetId>
aws devops-agent list-assets --agent-space-id <id> --max-results 50
aws devops-agent update-asset --agent-space-id <id> --asset-id <assetId> --metadata '{ "agent_types": ["INCIDENT_TRIAGE"] }'
aws devops-agent delete-asset --agent-space-id <id> --asset-id <assetId>

Activating and deactivating skills

aws devops-agent update-asset --agent-space-id <id> --asset-id <assetId> --metadata '{ "status": "INACTIVE" }'
aws devops-agent update-asset --agent-space-id <id> --asset-id <assetId> --metadata '{ "status": "ACTIVE" }'