Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

DevOps Competenze degli agenti

AWS DevOps Agent Skills sono set di istruzioni modulari che estendono le capacità dell'agente con conoscenze specialistiche del settore e metodologie di indagine personalizzate in base all'infrastruttura e ai flussi di lavoro operativi.

Cosa sono le competenze

Le competenze sono directory autonome contenenti istruzioni Markdown che forniscono funzionalità specializzate ad Agent. AWS DevOps AWS DevOps Agent supporta un sottoinsieme della specifica Agent Skills, uno standard aperto per le istruzioni e le risorse degli agenti di packaging, che supporta solo documenti non eseguibili: istruzioni Markdown, PDF, immagini e file di dati.

Ogni competenza richiede un SKILL.md file contenente le istruzioni che desideri fornire al tuo agente. AWS DevOps Oltre al SKILL.md file richiesto, le competenze possono includere:

Perché usare Skills

Le competenze trasformano AWS DevOps Agent da assistente generico a specialista per l'infrastruttura e i flussi di lavoro operativi. A differenza delle istruzioni monouso fornite in un messaggio di chat, le Skills sono funzionalità riutilizzabili che si caricano automaticamente quando sono pertinenti alle attività eseguite dall'agente. AWS DevOps

Principali vantaggi:

Come funzionano le competenze

Quando un AWS DevOps agente affronta un compito rilevante, acquisisce le competenze appropriate e segue le istruzioni per guidarne l'indagine. Ad esempio, una competenza di «Database Performance Investigation» potrebbe includere procedure dettagliate per l'analisi dei problemi di limitazione RDS, che consentano all'agente di controllare sistematicamente lo stato degli allarmi, analizzare le metriche di connessione e identificare le query lente.

Struttura delle competenze

Un'abilità è organizzata come una cartella contenente:

my-skill/
├── SKILL.md              # Main skill instructions
├── references/           # Optional: additional reference documentation
└── assets/               # Optional: images, diagrams, data files

SKILL.md

Il SKILL.md è l'unico file obbligatorio. Contiene le istruzioni di base scritte in formato Markdown. Questo file dovrebbe:

Parte introduttiva

Frontmatter è il blocco di metadati nella parte superiore di un SKILL.md file, racchiuso tra delimitatori. --- Contiene i description campi name e utilizzati dall' AWS DevOps Agente per determinare quando attivare l'abilità durante un'indagine o un'attività.

---
name: rds-performance-investigation
description: Investigation procedures for RDS performance issues including
  connection exhaustion, slow queries, replication lag, and storage capacity.
  Use this skill when investigating database latency, connection errors, or
  read/write performance degradation.
---

nome: un identificatore univoco per l'abilità. Utilizza solo lettere minuscole, numeri e trattini (massimo 64 caratteri). Non deve iniziare o terminare con un trattino.

descrizione — Una spiegazione dettagliata di quando e perché AWS DevOps l'Agente dovrebbe usare questa Skill. AWS DevOps L'agente valuta questo campo per decidere se l'abilità è rilevante per l'attività corrente. Una descrizione vaga o mancante può far sì che l'agente salti completamente l'abilità, anche se le istruzioni sono scritte bene.

Importante: scrivi la descrizione dal punto di vista dell'agente. Includi gli scenari, i servizi, i tipi di errore o i sintomi specifici che dovrebbero attivare la Skill. Ad esempio, «Usa questa abilità per analizzare la latenza del database, gli errori di connessione o i timeout delle query per le istanze Amazon RDS» è più efficace di «abilità RDS».

Quando crei una Skill nell'interfaccia utente, il sistema genera automaticamente una parte introduttiva a partire dal nome e dalla descrizione che fornisci. Le abilità caricate come file zip devono includere il frontespizio nel file. SKILL.md

Esempio: abilità completa

L'esempio seguente mostra un'abilità completa e ben formata per l'analisi dei problemi di prestazioni RDS. Illustra la struttura delle cartelle, la parte introduttiva SKILL.md , le procedure di indagine utilizzabili e un file di riferimenti supplementare.

Struttura delle directory:

rds-performance-investigation/
├── SKILL.md
├── references/
│   └── rds-metrics-reference.md
└── assets/
    └── rds-investigation-flowchart.png

SKILL.md:

---
name: rds-performance-investigation
description: Investigation procedures for RDS performance issues including
  connection exhaustion, slow queries, replication lag, and storage capacity.
  Use this skill when investigating database latency, connection errors, or
  read/write performance degradation.
---

# RDS Performance Investigation

Use this skill when customers report database latency, connection errors,
query timeouts, or read/write performance degradation.


## Step 1: Check alarm status

Query CloudWatch for active alarms on the affected RDS instance. Look for:
- `DatabaseConnections` exceeding 80% of max_connections
- `ReadLatency` or `WriteLatency` above 20ms
- `FreeStorageSpace` below 20% of total storage
- `ReplicaLag` above 30 seconds (read replicas only)


## Step 2: Analyze connection metrics

Retrieve `DatabaseConnections` over the past hour. If connections are near
the max_connections limit, check for connection pool misconfiguration or
long-running idle connections.


## Step 3: Identify slow queries

Use Performance Insights (`pi:GetResourceMetrics`) to retrieve the top SQL
statements by average active sessions. Focus on queries with high `db.load`
contribution or frequent I/O waits.


## Step 4: Summarize findings

Provide a summary with:
1. Current performance status (healthy / degraded / critical)
2. Root cause hypothesis with supporting metrics
3. Recommended remediation steps ranked by priority

references/rds-metrics-reference.md:

# RDS CloudWatch Metrics Reference


| Metric | Normal Range | Investigation Threshold |
|---|---|---|
| DatabaseConnections | < 70% max_connections | > 80% max_connections |
| ReadLatency | < 5ms | > 20ms |
| WriteLatency | < 5ms | > 20ms |
| FreeStorageSpace | > 30% total storage | < 20% total storage |
| ReplicaLag | < 5 seconds | > 30 seconds |
| CPUUtilization | < 70% | > 85% |

Esempio: abilità di filtraggio degli incidenti

Le competenze mirate al tipo di agente Incident Triage possono definire criteri per saltare automaticamente gli incidenti. Utilizzalo per filtrare gli incidenti che non richiedono indagini. Quando un nuovo incidente soddisfa i criteri di ignoramento, l' AWS DevOps agente lo contrassegna come ignorato. Il sistema fornisce un motivo che spiega perché è stato filtrato.

L'esempio seguente mostra un'abilità che ignora gli incidenti a bassa priorità durante la manutenzione programmata:

SKILL.md:

---
name: skip-scheduled-maintenance
description: Skip low-priority incidents during a scheduled maintenance window.
  Use this skill to automatically filter MEDIUM and LOW severity alarms that
  fire during planned maintenance, avoiding unnecessary investigations for
  expected disruptions.
---

# Skip Scheduled Maintenance

Skip all incidents that meet BOTH of the following criteria:

1. The incident arrived between **2025-03-15 02:00 UTC** and **2025-03-15 06:00 UTC**
2. Severity is MEDIUM or LOW

Do NOT skip HIGH or CRITICAL severity incidents, even during the maintenance window.

Quando crei questa abilità, seleziona Incident Triage come tipo di agente. Ciò garantisce che l'abilità venga valutata solo durante la fase di triage.

Creazione di competenze

Prima di creare abilità, devi disporre di un Agent Space. Per ulteriori informazioni, consulta Creazione di uno spazio per agenti.

È possibile creare competenze in due modi, a seconda delle preferenze del flusso di lavoro e della complessità delle competenze:

Per gestire le competenze in modo programmatico tramite la AWS CLI o AWS gli SDK, consulta. Gestione degli asset

Creazione di un'abilità nell'interfaccia utente

Le competenze create nell'app Web AWS DevOps Agent Operator contengono un nome, una descrizione e le istruzioni in un unico SKILL.md file.

Per creare un'abilità nell'interfaccia utente:

Il sistema genera automaticamente un SKILL.md file con la struttura del frontespizio corretta.

Per modificare un'abilità creata nell'interfaccia utente:

Caricamento di un'abilità

Le competenze caricate come file zip contengono un SKILL.md file e risorse aggiuntive come materiali di riferimento o risorse.

Struttura delle abilità:

my-skill.zip
├── SKILL.md              # Required: main skill instructions
├── references/           # Optional: reference documentation
│   ├── architecture.md
│   └── troubleshooting.md
└── assets/               # Optional: images, diagrams, data files
    ├── topology.png
    └── metrics.csv

SKILL.md requisiti frontali:

Le competenze caricate come file zip devono includere frontespizi e campi. SKILL.md name description AWS DevOps L'agente utilizza questi campi per determinare quando attivare l'abilità. Per informazioni dettagliate sulla scrittura di frontespizi efficaci, consultate la sezione Frontmatter più avanti di questo argomento.

---
name: rds-performance-analysis
description: Comprehensive RDS performance investigation procedures
  for connection exhaustion, slow queries, and storage capacity issues.
  Use when investigating database latency or read/write degradation.
---


# RDS Performance Analysis


[Your skill instructions here...]

Per creare un'abilità tramite caricamento zip:

Restrizioni importanti per le competenze caricate come file zip:

Le migliori pratiche per le competenze di denominazione:

Utilizza nomi chiari e descrittivi come «rds-throttling-investigation» anziché nomi generici. Un buon nome di abilità riflette lo scenario o il servizio specifico a cui si rivolge, rendendo più facile identificare la competenza giusta a colpo d'occhio.

Importazione di una skill da un repository

È possibile importare le competenze direttamente da una directory del GitHub repository. AWS DevOps L'agente recupera il contenuto delle abilità dal repository, estrae il nome e la descrizione dalla pagina principale e crea SKILL.md l'abilità nel tuo Agent Space. Ciò consente di gestire le competenze relative al controllo delle versioni e di importarle con una sola azione.

Prerequisiti:

Struttura del repository:

La directory del repository da importare deve seguire la struttura delle competenze standard:

my-skill/
├── SKILL.md              # Required: must include name and description in frontmatter
├── references/           # Optional: reference documentation
│   └── runbook.md
└── assets/               # Optional: images, diagrams, data files
    └── architecture.png

Per importare un'abilità da un repository:

AWS DevOps L'agente recupera il contenuto della directory, legge il SKILL.md frontespizio per estrarre il nome e la descrizione dell'abilità e importa tutti i file nell'Agent Space.

Visualizzazione delle competenze importate:

Le abilità importate vengono visualizzate nell'elenco delle competenze personalizzate con un collegamento all'archivio di origine. Nella visualizzazione dettagliata delle abilità:

Sincronizzazione delle abilità importate:

Quando aggiorni i file delle abilità nel tuo repository, puoi sincronizzare le abilità importate per recuperare le ultime modifiche:

Puoi anche eseguire la sincronizzazione dalla visualizzazione dell'elenco delle competenze facendo clic sul pulsante Sincronizza nella riga delle abilità importate.

Vincoli:

Competenze di esempio

L'archivio DevOps delle competenze GitHub contiene competenze fornite dalla community che puoi utilizzare così come sono o come punto di partenza per scriverne di tue. Gli esempi disponibili includono competenze per l'indagine sugli eventi AWS Health, l'analisi dei casi di AWS Support, le revisioni operative EKS e le revisioni operative RDS. Per sfogliare le competenze disponibili, consulta la galleria delle competenze della community.

Per usare un'abilità di esempio:

Ogni abilità include un README con prerequisiti e istruzioni per l'uso.

Gestione delle competenze

AWS DevOps Agent offre funzionalità complete di gestione delle competenze tramite l'app Web Operator:

Elenco delle competenze: visualizza tutte le competenze nel tuo Agent Space. La scheda Competenze della pagina Conoscenze mostra il nome dell'abilità, lo stato Attivo o Inattivo, la data di creazione, la data dell'ultimo aggiornamento e le azioni disponibili.

Competenze di visualizzazione: scegli un'abilità per visualizzarne i dettagli. Le abilità create nell'interfaccia utente mostrano contenuti modificabili in cui puoi modificare il nome, la descrizione o le istruzioni direttamente nell'interfaccia utente e scegliere «Salva» per aggiornare. Le abilità caricate come file zip mostrano un albero di file SKILL.md e tutte le cartelle aggiuntive come references/ e assets/. Scegliete i file nell'albero per visualizzarne il contenuto in modalità di sola lettura.

Selezione degli agenti per un'abilità: configura i tipi di agenti che possono utilizzare ciascuna abilità durante la creazione o la modifica. Nel menu a discesa Tipo di agente, seleziona uno o più tipi di agenti utilizzando le caselle di controllo: Generico (impostazione predefinita, si applica a tutti i tipi di agenti), On-demand(query conversazionali), Incident Triage (valutazione iniziale dell'incidente), Incident RCA (analisi della causa principale), Incident Mitigation (risposta automatizzata agli incidenti) o Valutazione (consigli proattivi). Generico è selezionato per impostazione predefinita e rende la competenza disponibile per tutti i tipi di agenti. Le competenze destinate a agenti specifici riducono il consumo di contesto e migliorano la concentrazione degli agenti.

Attivazione e disattivazione delle abilità: disattiva temporaneamente le abilità senza eliminarle utilizzando l'interruttore. Active/Inactive Apri la visualizzazione dei dettagli delle abilità e imposta l'interruttore su «Inattivo» per impedire all'agente di caricarlo per nuove indagini, preservando al contempo tutti i contenuti e le configurazioni. In-progress le indagini continuano utilizzando l'abilità. Torna a «Attiva» per rendere immediatamente nuovamente disponibile l'abilità. Per attivare o disattivare le competenze a livello di codice, consulta Attivazione e disattivazione delle competenze nella pagina Gestione delle risorse.

Aggiornamento delle competenze: modifica le competenze esistenti in base a come sono state create. Per le competenze create nell'interfaccia utente, scegli «Modifica» nella visualizzazione dei dettagli delle abilità, modifica il nome, la descrizione o le istruzioni e scegli «Salva» per aggiornare. Per le competenze caricate come file zip, modifica i file localmente, crea un nuovo file zip e carica una nuova versione.

Eliminazione delle competenze: rimuovi definitivamente le abilità dal tuo Agent Space. Apri la visualizzazione dell'elenco delle abilità, scegli il menu Altre opzioni (⋮) e seleziona «Elimina», leggi l'avviso relativo all'eliminazione permanente, digita il nome dell'abilità per confermare e scegli «Elimina abilità». L'eliminazione non può essere annullata. In-progress le indagini potrebbero essere compromesse se tentano di caricare l'abilità eliminata. Per le abilità caricate come file zip, scaricate il file zip prima di eliminarle come backup. Prendi in considerazione la possibilità di disattivare l'abilità invece di eliminarla se potresti averne bisogno di nuovo.

Migrazione da Runbook

I Runbook esistenti vengono migrati automaticamente a Skills senza che sia richiesta alcuna azione da parte del cliente. Quando Agent Space passa al modello Skills, tutti i Runbook vengono convertiti in Skills e vengono visualizzati nell'interfaccia utente Skills. Dopo la migrazione, puoi:

Contatta l' AWS assistenza se riscontri problemi con la migrazione automatica di Skills o hai bisogno di assistenza con gli aggiornamenti successivi alla migrazione.