Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

DevOps Habilidades de agente

AWS DevOps Las habilidades de los agentes son conjuntos de instrucciones modulares que amplían las capacidades del agente con conocimientos de dominio especializados y metodologías de investigación adaptadas a su infraestructura y sus flujos de trabajo operativos.

¿Qué son las habilidades

Las habilidades son directorios independientes que contienen instrucciones de Markdown que proporcionan capacidades especializadas a AWS DevOps Agent. AWS DevOps Agent admite un subconjunto de la especificación Agent Skills, un estándar abierto para empaquetar instrucciones y recursos relacionados con los agentes, y solo admite documentos no ejecutables: instrucciones, imágenes y archivos de datos de Markdown. PDFs

Cada habilidad requiere un archivo Skill.md que contenga las instrucciones que desee proporcionar a su agente. AWS DevOps Además del archivo Skill.md requerido, las habilidades pueden incluir:

¿Por qué usar Skills

Las habilidades transforman a AWS DevOps Agent de un asistente de uso general en un especialista para sus flujos de trabajo operativos y de infraestructura. A diferencia de las instrucciones únicas que se proporcionan en un mensaje de chat, las habilidades son capacidades reutilizables que se cargan automáticamente cuando son relevantes para las tareas realizadas por AWS DevOps el agente.

Ventajas clave:

Cómo funcionan las habilidades

Cuando el AWS DevOps agente encuentra una tarea relevante, adquiere las habilidades adecuadas y sigue las instrucciones para guiar su investigación. Por ejemplo, una habilidad de «investigación del rendimiento de una base de datos» podría incluir step-by-step procedimientos para analizar los problemas de regulación del RDS, lo que permitiría al agente comprobar sistemáticamente el estado de las alarmas, analizar las métricas de conexión e identificar las consultas lentas.

Estructura de habilidades

Una habilidad se organiza como un directorio que contiene:

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

Skill.md

SKILL.mdEs el único archivo obligatorio. Contiene las instrucciones básicas escritas en formato Markdown. Este archivo debe:

Frontmatter

Frontmatter es el bloque de metadatos situado en la parte superior de un SKILL.md archivo, encerrado entre --- delimitadores. Contiene los description campos name y campos que el AWS DevOps agente utiliza para determinar cuándo activar la habilidad durante una investigación o tarea.

---
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.
---

nombre: un identificador único de la habilidad. Utilice únicamente letras minúsculas, números y guiones (64 caracteres como máximo). No debe empezar ni terminar con un guión.

descripción: una explicación detallada de cuándo y por qué el AWS DevOps agente debe usar esta habilidad. AWS DevOps El agente evalúa este campo para decidir si la habilidad es relevante para la tarea actual. Una descripción vaga o faltante puede provocar que el agente se salte la habilidad por completo, incluso si las instrucciones están bien redactadas.

Importante: escribe la descripción desde la perspectiva del agente. Incluya los escenarios, los servicios, los tipos de error o los síntomas específicos que deberían activar la habilidad. Por ejemplo, «Utilice esta habilidad para investigar la latencia de la base de datos, los errores de conexión o los tiempos de espera de las consultas para las instancias de Amazon RDS» es más eficaz que «habilidad RDS».

Al crear una habilidad en la interfaz de usuario, el sistema genera información preliminar automáticamente a partir del nombre y la descripción que usted proporciona. Las habilidades subidas como archivos zip deben incluir frontmatter en el SKILL.md archivo.

Ejemplo: habilidad completa

El siguiente ejemplo muestra una habilidad completa y bien formada para investigar los problemas de rendimiento del RDS. Muestra la estructura de directorios, la información preliminar de Skill.md, los procedimientos de investigación procesables y un archivo de referencias complementario.

Estructura de directorios:

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

referencias/ .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% |

Creando habilidades

Antes de crear habilidades, debes tener un espacio de agente. Para obtener más información, consulte Creación de un espacio de agentes.

Puede crear habilidades de dos maneras, en función de sus preferencias de flujo de trabajo y de la complejidad de las habilidades:

Crear una habilidad en la interfaz de usuario

Las habilidades creadas en la aplicación web AWS DevOps Agent Operator contienen un nombre, una descripción e instrucciones en un único archivo Skill.md.

Para crear una habilidad en la interfaz de usuario:

El sistema genera automáticamente un archivo Skill.md con la estructura frontal adecuada.

Para editar una habilidad creada en la interfaz de usuario:

Cargar una habilidad

Las habilidades subidas como archivos zip contienen un archivo Skill.md además de recursos adicionales, como materiales de referencia o activos.

Estructura de habilidades:

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

Requisitos de experiencia previa de Skill.md:

Las habilidades subidas como archivos zip deben incluir FrontMatter en Skill.md con los campos y. name description AWS DevOps El agente usa estos campos para determinar cuándo activar la habilidad. Para obtener más información sobre cómo escribir un material preliminar efectivo, consulte la sección Frontmatter que aparece al principio de este tema.

---
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...]

Para crear una habilidad subiéndola a un archivo zip, sigue estos pasos:

Restricciones importantes para las habilidades que se suben como archivos zip:

Mejores prácticas para las habilidades de nomenclatura:

Utilice nombres descriptivos y claros, como «rds-throttling-investigation», en lugar de nombres genéricos. Un buen nombre de habilidad refleja el escenario o servicio específico al que se dirige, lo que facilita la identificación de la habilidad adecuada de un vistazo.

Administración de Skills

AWS DevOps Agent ofrece capacidades integrales de gestión de habilidades a través de la aplicación web Operator:

Publica tus habilidades: consulta todas las habilidades en tu espacio de agente. La página de habilidades muestra el nombre de la habilidad, su estado activo o inactivo, la fecha de creación, la fecha de la última actualización y las acciones disponibles.

Visualización de habilidades: haga clic en cualquier habilidad para ver su vista detallada. Las habilidades creadas en la interfaz de usuario muestran contenido editable, donde puedes modificar el nombre, la descripción o las instrucciones directamente en la interfaz de usuario y hacer clic en «Guardar» para actualizarlas. Las habilidades subidas como archivos zip muestran un árbol de archivos que muestra Skill.md y cualquier directorio adicional, como references/ y assets/. Haga clic en los archivos del árbol para ver su contenido en modo de solo lectura.

Selección de agentes para una habilidad: configure qué tipos de agentes pueden usar cada habilidad al crearla o editarla. En el menú desplegable Tipo de agente, seleccione uno o más tipos de agentes mediante las casillas de verificación: Genérico (predeterminado, se aplica a todos los tipos de agentes), Bajo demanda (consultas conversacionales), Triaje de incidentes (evaluación inicial de incidentes), RCA de incidentes (análisis de causa raíz), Mitigación de incidentes (respuesta automática a incidentes) o Evaluación (recomendaciones proactivas). La opción Genérica está seleccionada de forma predeterminada y pone la habilidad a disposición de todos los tipos de agentes. Las habilidades dirigidas a agentes específicos reducen el consumo de contexto y mejoran la concentración de los agentes.

Activación y desactivación de habilidades: desactiva temporalmente las habilidades sin eliminarlas con el botón Active/Inactive . Abre la vista detallada de las habilidades y coloca el interruptor en «Inactivo» para evitar que el agente las cargue para nuevas investigaciones y, al mismo tiempo, conservar todo el contenido y las configuraciones. Las investigaciones en curso siguen utilizando la habilidad. Vuelve a «Activa» para que la habilidad vuelva a estar disponible inmediatamente.

Actualización de habilidades: modifique las habilidades existentes en función de cómo se crearon. En el caso de las habilidades creadas en la interfaz de usuario, haga clic en «Editar» en la vista de detalles de la habilidad, modifique el nombre, la descripción o las instrucciones y, a continuación, haga clic en «Guardar» para actualizarlas. En el caso de las habilidades subidas como archivos zip, modifique los archivos localmente, cree un nuevo archivo zip y cargue una nueva versión.

Eliminar habilidades: elimina permanentemente las habilidades de tu espacio de agente. Abre la vista de lista de habilidades, haz clic en el menú de más opciones (◉) y selecciona «Eliminar», lee la advertencia sobre la eliminación permanente, escribe el nombre de la habilidad para confirmarla y haz clic en «Eliminar habilidad». La eliminación no se puede deshacer. Las investigaciones en curso pueden verse afectadas si intentan cargar la habilidad eliminada. Para las habilidades subidas como archivos zip, descarga el archivo zip antes de eliminarlas como copia de seguridad. Considera la posibilidad de desactivar la habilidad en lugar de eliminarla si es posible que la vuelvas a necesitar.

¿Migrar desde Runbooks

Los Runbooks existentes se migran automáticamente a Skills sin que el cliente tenga que hacer nada al respecto. Cuando tu espacio de agente pasa al modelo de habilidades, todos los cuadernos de runbooks se convierten en habilidades y aparecen en tu interfaz de usuario de habilidades. Tras la migración, podrás:

Póngase en contacto con AWS Support si tiene algún problema con las habilidades que se migran automáticamente o si necesita ayuda con las actualizaciones posteriores a la migración.