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 Le competenze degli agenti sono set di istruzioni modulari che estendono le capacità dell'agente con conoscenze di dominio specializzate e metodologie di indagine su misura per l'infrastruttura e i flussi di lavoro operativi.

Cosa sono le competenze

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

Ogni abilità richiede un SKILL.md file contenente le istruzioni che desideri fornire al tuo AWS DevOps agente. 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 la tua infrastruttura e i tuoi flussi di lavoro operativi. A differenza delle istruzioni una tantum 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 AWS DevOps l'agente incontra un compito pertinente, acquisisce le competenze appropriate e segue le istruzioni per guidare la sua indagine. Ad esempio, una competenza «Database Performance Investigation» potrebbe includere procedure dettagliate per l'analisi dei problemi di limitazione dell'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

Una competenza è organizzata come una directory contenente:

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

SKILL.md

SKILL.mdÈ l'unico file obbligatorio. Contiene le istruzioni principali scritte in formato Markdown. Questo file dovrebbe:

Argomento principale

Frontmatter è il blocco di metadati nella parte superiore di un SKILL.md file, racchiuso tra delimitatori. --- Contiene description i campi name e che l' AWS DevOps Agente utilizza 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 la Skill. Usa 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é l' AWS DevOps agente dovrebbe usare questa abilità. AWS DevOps L'Agente valuta questo campo per decidere se la Skill è pertinente all'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 il frontespizio in base al nome e alla descrizione forniti. Le competenze caricate come file zip devono includere frontmatter nel SKILL.md file.

Esempio: abilità completa

L'esempio seguente mostra una competenza completa e ben strutturata per l'analisi dei problemi relativi alle prestazioni di RDS. Illustra la struttura delle directory, il SKILL.md front-matter, le procedure di indagine attuabili e un file di riferimenti supplementare.

Struttura della 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 specifiche per il tipo di agente Incident Triage possono definire criteri per ignorare automaticamente gli incidenti. Usalo 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 evita 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 competenze, 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 gli AWS SDK, consulta. Gestione delle risorse

Creazione di una competenza nell'interfaccia utente

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

Per creare un'abilità nell'interfaccia utente:

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

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

Caricare un'abilità

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

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

SKILL.md requisiti preliminari:

Le competenze caricate come file zip devono includere frontmatter nei campi SKILL.md con name edescription. AWS DevOps L'agente utilizza questi campi per determinare quando attivare la Skill. Per informazioni dettagliate su come scrivere un frontmatter efficace, consulta la sezione Frontmatter riportata all'inizio 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:

Procedure consigliate per la denominazione delle competenze:

Utilizza nomi chiari e descrittivi come «rds-throttling-investigation» anziché nomi generici. Un nome valido riflette lo scenario o il servizio specifico a cui si rivolge, facilitando l'identificazione della competenza giusta a colpo d'occhio.

Importazione di una competenza da un repository

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

Prerequisiti:

Struttura del repository:

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

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 una competenza 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 competenze importate vengono visualizzate nell'elenco delle competenze personalizzate con un collegamento al repository di origine. Nella visualizzazione dei dettagli delle competenze:

Sincronizzazione delle competenze 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 scegliendo Sincronizza nella riga delle abilità importate.

Vincoli:

Strumenti comunitari

L'archivio AWS DevOps Agent Tools sul GitHub sito Web contiene competenze fornite dalla community, agenti personalizzati e server MCP che puoi utilizzare così come sono o come punto di partenza per scriverne di tuoi. L'archivio è gestito dal team di assistenza degli agenti. AWS DevOps Tutti i contributi vengono esaminati nella stessa barra di revisione della sicurezza prima di essere aggiunti, in modo da ottenere una rapida distribuzione di nuove funzionalità con la certezza che ogni strumento soddisfi gli standard di AWS qualità. Per scoprire cosa è disponibile, consulta la galleria delle competenze della community sul GitHub sito web.

Le competenze disponibili includono:

Per utilizzare una competenza comunitaria:

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

Il repository include anche agenti personalizzati della community e server MCP distribuibili. Per informazioni dettagliate, vedere Community Custom Agents e Community MCP Servers.

Gestione delle competenze

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

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

Visualizzazione delle competenze: scegli una competenza per visualizzarne i dettagli. Le competenze create nell'interfaccia utente visualizzano contenuti modificabili in cui puoi modificare il nome, la descrizione o le istruzioni direttamente nell'interfaccia utente e scegliere «Salva» per aggiornarle. Le competenze caricate come file zip mostrano un albero di file SKILL.md e tutte le directory aggiuntive come references/ e assets/. Scegli i file nell'albero per visualizzarne il contenuto in modalità di sola lettura.

Selezione degli agenti per una competenza: 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 agente utilizzando le caselle di controllo: Generico (impostazione predefinita: si applica a tutti i tipi di agente), On-demand (domande conversazionali), Incident Triage (valutazione iniziale dell'incidente), Incident RCA (analisi delle cause principali), Incident Mitigation (risposta automatica agli incidenti) o Valutazione (raccomandazioni proattive). Generico è selezionato per impostazione predefinita e rende l'abilità disponibile per tutti i tipi di agenti. Le competenze destinate a specifici agenti riducono il consumo di contesto e migliorano la concentrazione degli agenti.

Attivazione e disattivazione delle competenze: disabilita temporaneamente le competenze senza eliminarle utilizzando l'interruttore. Active/Inactive Apri la visualizzazione dei dettagli delle competenze e imposta l'interruttore su «Inattivo» per impedire all'agente di caricarle per nuove indagini, preservando al contempo tutti i contenuti e le configurazioni. In-progress le indagini continuano utilizzando l'abilità. Torna su «Attiva» per rendere immediatamente disponibile l'abilità. Per attivare o disattivare le competenze a livello di programmazione, vedi 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 competenze, modifica il nome, la descrizione o le istruzioni e scegli «Salva» per aggiornarle. 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 competenze dal tuo Agent Space. Apri la visualizzazione dell'elenco delle abilità, scegli il menu Altre opzioni (⋮) e seleziona «Elimina», rivedi l'avviso sull'eliminazione permanente, digita il nome dell'abilità per confermare e scegli «Elimina abilità». L'eliminazione non può essere annullata. In-progress le indagini possono essere compromesse se tentano di caricare l'abilità eliminata. Per le competenze caricate come file zip, scarica il file zip prima di eliminarlo come backup. Valuta la possibilità di disattivare la skill invece di eliminarla se potresti averne nuovamente bisogno.

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 delle competenze o hai bisogno di assistenza per gli aggiornamenti successivi alla migrazione.