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](https://agentskills.io/), uno standard aperto per le istruzioni e le risorse degli agenti di packaging, che supporta solo documenti non eseguibili: istruzioni Markdown, immagini e file di dati. PDFs
Ogni abilità richiede un file Skill.md contenente le istruzioni che desideri fornire al tuo agente. AWS DevOps Oltre al file Skill.md richiesto, le competenze possono includere:
+ **Flussi di lavoro di indagine** per scenari o tipi di infrastruttura specifici.
+ **Materiali di riferimento**, inclusi modelli di architettura e procedure operative.
+ **Targeting per tipo di agente**: le competenze possono essere indirizzate a tipi di agenti specifici (generico, on-demand, Incident Triage, Incident RCA, Incident Mitigation, Evaluation) per ridurre il consumo di contesto e migliorare l'attenzione degli agenti.
## 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:**
+ **Specializza il tuo agente**: personalizza AWS DevOps l'agente con procedure di indagine, best practice e conoscenze organizzative specifiche per la tua infrastruttura e i tuoi modelli operativi.
+ **Riduci le ripetizioni**: crea i flussi di lavoro di indagine una sola volta e AWS DevOps l'agente li utilizza automaticamente in tutte le indagini pertinenti, eliminando la necessità di fornire ripetutamente le stesse indicazioni.
+ **Composizione di funzionalità**: combina più competenze per creare flussi di lavoro di indagine. end-to-end AWS DevOps L'agente acquisisce diverse competenze durante l'esecuzione, ad esempio un'abilità per recuperare le distribuzioni dalla CI/CD pipeline personalizzata e un'abilità per cercare negli archivi di codice.
+ **Amplifica gli strumenti personalizzati**: crea competenze che AWS DevOps guidino l'agente nell'utilizzo efficace degli strumenti server MCP personalizzati. Le competenze possono documentare quando richiamare strumenti specifici, quali parametri utilizzare per diversi scenari e come interpretare i risultati per realizzare flussi di lavoro specifici per l'infrastruttura.
## 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 step-by-step procedure per analizzare i problemi di limitazione RDS, che consentono 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:
+ Descrivi quando e come usare l'abilità.
+ Fornire procedure di step-by-step indagine.
+ Includi alberi decisionali per diversi scenari.
+ Documenta i risultati attesi e i criteri di successo.
### 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 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, il frontespizio di 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
```
**riferimenti/ .mdrds-metrics-reference:**
```
# 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% |
```
## Creazione di competenze
Prima di creare abilità, devi disporre di un Agent Space. Per ulteriori informazioni, consulta [Creazione di uno spazio per agenti](getting-started-with-aws-devops-agent-creating-an-agent-space.md).
È possibile creare competenze in due modi, a seconda delle preferenze del flusso di lavoro e della complessità delle competenze:
### Creazione di un'abilità nell'interfaccia utente
Le competenze create nell'app Web AWS DevOps Agent Operator contengono un nome, una descrizione e istruzioni in un unico file Skill.md.
**Per creare un'abilità nell'interfaccia utente:**
+ Vai alla pagina Competenze nella tua app Web Agent Space Operator.
+ Fai clic su «Aggiungi abilità».
+ Seleziona «Crea abilità» dalla modalità modale.
+ Compila il modulo di abilità:
+ **Nome**: solo lettere minuscole, numeri e trattini (massimo 64 caratteri). Non deve iniziare o terminare con un trattino. Ad esempio: `rds-throttling-investigation`
+ **Descrizione**: breve spiegazione di quando utilizzare questa abilità (minimo 100 caratteri consigliati, massimo 1.024 caratteri). Questo aiuta l'agente a determinare quando attivare l'abilità.
+ **Stato**: impostato su Attivo (impostazione predefinita) o Inattivo. Le abilità inattive non vengono utilizzate dall'agente.
+ **Tipo di agente**: seleziona uno o più tipi di agenti che possono utilizzare questa abilità. L'opzione **Generica** è selezionata per impostazione predefinita e rende l'abilità disponibile per tutti i tipi di agenti. Per scegliere come target agenti specifici, deselezionate Generico e scegliete tra: On-demand, Incident Triage, Incident RCA, Incident Mitigation o Evaluation.
+ **Istruzioni: Step-by-step procedure** in formato Markdown. Sii specifico e fattibile.
+ Fai clic su «Crea» per salvare l'abilità.
Il sistema genera automaticamente un file Skill.md con la struttura di frontmatter corretta.
**Per modificare un'abilità creata nell'interfaccia utente:**
+ Vai all'abilità nell'elenco Competenze e fai clic sull'abilità per aprirla.
+ Fare clic su **Edit (Modifica)**.
+ Modifica il nome, la descrizione o le istruzioni.
+ Fai clic su **Salva** per aggiornare l'abilità.
### Caricamento di un'abilità
Le competenze caricate come file zip contengono un file Skill.md e risorse aggiuntive come materiali o risorse di riferimento.
**Struttura delle competenze:**
```
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
```
**Requisiti della parte anteriore di Skill.md:**
Le competenze caricate come file zip devono includere frontmatter in Skill.md con i campi and. `name` `description` AWS DevOps L'agente utilizza questi campi per determinare quando attivare la Skill. Per informazioni dettagliate sulla scrittura di frontespizi efficaci, consultate la sezione Frontmatter più avanti in 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 in formato zip:**
+ Crea una cartella con i file delle tue abilità seguendo la struttura sopra riportata.
+ Assicurati che Skill.md includa il frontespizio corretto (nome e descrizione).
+ Comprimi la directory in un file.zip.
+ Vai alla pagina Skills nella tua app Web Agent Space Operator.
+ Fai clic su «Aggiungi abilità».
+ Seleziona «Carica abilità» dalla modalità modale.
+ Trascina e rilascia il file.zip o fai clic per sfogliarlo (solo file ZIP, massimo 6 MB).
+ Seleziona uno o più tipi di agenti che possono utilizzare questa abilità (l'opzione Generico è selezionata per impostazione predefinita e si applica a tutti i tipi di agenti; deselezionala per scegliere come target specifico On-demand, Incident Triage, Incident RCA, Incident Mitigation o Evaluation).
+ Esamina i requisiti del file zip e i risultati della convalida.
+ Fai clic su «Carica» per aggiungere l'abilità al tuo Agent Space.
**Restrizioni importanti per le competenze caricate come file zip:**
+ **Gli script non sono attualmente supportati**: le abilità che contengono script nella `scripts/` directory verranno rifiutate durante il caricamento. L'esecuzione degli script verrà abilitata in una versione futura non appena gli agenti avranno accesso a un ambiente di codifica sicuro.
+ **Limite di dimensione**: la dimensione totale del file zip non deve superare i 6 MB (inclusi tutti i file).
+ **Skill.md richiesto**: il file zip deve contenere un file Skill.md con frontespizio valido.
**Le migliori pratiche per le competenze di denominazione:**
Usa nomi chiari e descrittivi come "rds-throttling-investigation" anziché nomi generici. Un buon nome di competenza riflette lo scenario o il servizio specifico a cui si rivolge, rendendo più facile identificare la competenza giusta a colpo d'occhio.
## 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 pagina Competenze mostra il nome della competenza, lo stato Attivo o Inattivo, la data di creazione, la data dell'ultimo aggiornamento e le azioni disponibili.
**Competenze di visualizzazione**: fai clic su una competenza 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 fare clic su «Salva» per aggiornare. Le abilità caricate come file zip mostrano un albero di file che mostra Skill.md e tutte le cartelle aggiuntive come references/ e assets/. Fate clic sui file nell'albero per visualizzarne il contenuto in modalità di sola lettura.
**Selezione degli agenti per un'abilità**: configura quali tipi di agenti 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 automatica agli incidenti**) o Valutazione (raccomandazioni proattive).** 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. Le indagini in corso continuano a utilizzare l'abilità. Torna a «Attiva» per rendere immediatamente nuovamente disponibile l'abilità.
**Aggiornamento delle competenze**: modifica le competenze esistenti in base a come sono state create. Per le competenze create nell'interfaccia utente, fai clic su «Modifica» nella visualizzazione dei dettagli delle competenze, modifica il nome, la descrizione o le istruzioni e fai clic su «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à, fai clic sul menu Altre opzioni (⋮) e seleziona «Elimina», leggi l'avviso relativo all'eliminazione permanente, digita il nome dell'abilità per confermare e fai clic su «Elimina abilità». L'eliminazione non può essere annullata. Le indagini in corso potrebbero risentirne 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:
+ **Rivedi le competenze migrate**: verifica che la migrazione automatica abbia convertito correttamente i tuoi Runbook.
+ **Aggiorna se necessario**: modifica le competenze direttamente nell'interfaccia utente per perfezionare le istruzioni, aggiornare le descrizioni o configurare il targeting per tipo di agente.
+ **Espandi con riferimenti**: per le competenze che potrebbero trarre vantaggio da materiali di riferimento o diagrammi di architettura aggiuntivi, ricreale come abilità di caricamento zip con una directory references/ o assets/.
+ **Crea nuove competenze: aggiungi nuove competenze** per flussi di lavoro di indagine non inclusi in precedenza nei Runbooks.
Contatta l' AWS assistenza se riscontri problemi con la migrazione automatica di Skills o hai bisogno di assistenza con gli aggiornamenti successivi alla migrazione.