Tutorial: Creación de una aptitud en el agente de SRE de Azure

En este tutorial, crearás una habilidad personalizada que agrega conocimientos de dominio y guías de procedimientos a tu agente. Las aptitudes son funcionalidades modulares que el agente carga automáticamente cuando es pertinente, como solucionar problemas de un servicio específico o ejecutar un procedimiento de diagnóstico.

En este tutorial aprenderá a:

Tiempo estimado: 10 minutos

Prerrequisitos

Asegúrese de que cumple los siguientes requisitos previos antes de empezar:

• Un agente creado en el portal del agente de SRE de Azure.
• Una comprensión clara del procedimiento o el conocimiento de dominio que desea codificar.

Vaya al generador de subagentes.

Abra el generador de subagentes donde cree y administre aptitudes.

1. Abra el portal del agente de SRE.
2. Seleccionar tu agente.
3. Seleccione Generador en el panel de navegación izquierdo.
4. Seleccione Subagent builder (Generador de subagentes).

Inicio de la creación de aptitudes

Inicie el proceso de creación de aptitudes desde la barra de herramientas.

1. Seleccione la lista desplegable Crear en la barra de herramientas.
2. Seleccione Aptitud.

El cuadro de diálogo de creación de aptitudes se abre con un diseño de dos columnas. Campos de formulario en un lado y un editor de código en el otro que muestra SKILL.md.

Escriba el nombre y la descripción.

Proporcione un nombre y una descripción que ayuden al agente a decidir cuándo usar esta aptitud.

El nombre debe ser único en las capacidades. La descripción aparece en la lista de aptitudes y ayuda al agente a decidir cuándo usar esta aptitud.

Escribir instrucciones de habilidad

El editor central muestra SKILL.md, que contiene las instrucciones de la habilidad. El archivo comienza con una plantilla predeterminada.

---
name:
description:
---

<!-- Add your skill instructions here -->

El front-matter de YAML (name, description, tools) permanece sincronizado con los campos del formulario a la izquierda. Escriba sus instrucciones en Markdown debajo de la materia introductoria:

---
name: high-cpu-troubleshooting
description: Troubleshooting procedure for high CPU alerts on container apps
tools:
  - kusto_query
---

## When to use this skill
Use this skill when you receive a high CPU alert on any container app.

## Steps
1. Check upstream dependencies for cascading failures
2. Query connection pool metrics for the last hour
3. Review deployments in the last 24 hours
4. If a recent deployment correlates with CPU spike, identify the commit
5. Recommend rollback or fix based on findings

## Expected output
Structured report with: affected resource, root cause, recommended action, and evidence.

Agregar archivos auxiliares

La sección Archivos de un lado muestra un explorador de archivos. Más allá del valor predeterminado SKILL.md, puede agregar datos de referencia, plantillas y consultas de ejemplo.

• Seleccione el nuevo icono de archivo para agregar archivos.
• Seleccione el icono de nueva carpeta para organizar los archivos en directorios.
• Arrastre y coloque una carpeta en la zona de colocación o seleccione el vínculo Cargar carpeta para cargar una estructura de carpetas completa.

Seleccione cualquier archivo del explorador para editarlo en el editor de código. El editor admite el resaltado de sintaxis para scripts de Markdown, JSON, YAML, KQL, Python y shell.

Selección de herramientas

Opcionalmente, adjunte las herramientas que usa la aptitud durante la ejecución.

1. Seleccione Elegir herramientas en la sección Herramientas .
2. Navegue o busque herramientas. Filtre por tipo (Herramienta personalizada, herramienta MCP) o busque por nombre.
3. Compruebe las herramientas que necesita esta aptitud (por ejemplo, kusto_query o azure_resource_health).
4. Cierre el panel.

Las herramientas seleccionadas aparecen como cápsulas que se pueden mover. Estas herramientas están disponibles dinámicamente cuando se activa la aptitud.

Para crear herramientas personalizadas, consulte Creación de una herramienta kusto o Creación de una herramienta de Python. Para obtener más información sobre las herramientas, consulte Herramientas.

Crear la habilidad

Seleccione Crear para guardar la habilidad.

La aptitud aparece en la pestaña Aptitudes del generador de subagentes. El agente ahora puede usar la aptitud automáticamente cuando encuentra una situación relevante.

Prueba de la aptitud

El agente principal puede usar aptitudes de forma predeterminada, por lo que puede probarlas directamente en el chat sin crear primero un subagente.

Prueba en un nuevo chat

Utiliza un nuevo hilo de chat para comprobar que el agente ha activado tu habilidad.

1. Seleccione Nuevo subproceso de chat en la barra lateral.
2. Escriba un mensaje que deba desencadenar la habilidad. Por ejemplo: "Estamos viendo un alto uso de CPU en nuestra aplicación contenedorizada, ¿puede investigar?"
3. Compruebe que el agente activa la habilidad y sigue los procedimientos que usted definió.

Prueba en el área de juegos

Use el área de juegos para probar la aptitud a través de un subagente.

1. Cree un subagente y asígnele esta aptitud.
2. En la barra de herramientas del generador de subagentes, seleccione el conmutador de vista Área de juegos de pruebas.
3. Seleccione el subagente, escriba un mensaje de prueba y compruebe que usa la aptitud correctamente.

Para obtener más información, consulte Área de juegos del agente.

Editar una aptitud

Puede modificar una aptitud existente para actualizar sus instrucciones, herramientas o archivos auxiliares.

1. En la pestaña Aptitudes , seleccione el nombre de la aptitud o selecciónelo y elija Editar.

2. El cuadro de diálogo de edición se abre con todos los valores actuales rellenados previamente. Cambie los campos que necesita:

   Qué cambiar	Dónde actualizar
   Cuando el agente lo usa	Descripción e instrucciones de SKILL.md
   Procedimientos que se deben seguir	contenido de SKILL.md en el editor
   Qué herramientas están disponibles	Herramientas> Elegir herramientas
   Datos de referencia	Archivos> agregar, editar o quitar archivos

3. Haga clic en Guardar.

Sugerencias para escribir capacidades eficaces

Use las instrucciones siguientes para crear aptitudes que el agente pueda usar de forma eficaz.

• Sea específico sobre cuándo usarlo. El agente lee la descripción y las instrucciones para decidir la relevancia.
• Incluya procedimientos paso a paso. Los pasos numerados proporcionan al agente un cuaderno de estrategias claro.
• Especifique la salida esperada. Indique al agente qué formato deben tomar los resultados.
• Agregue datos de referencia. Cargue plantillas de consulta, líneas base de configuración o valores verificados como archivos de soporte.
• Asigne herramientas pertinentes. Si la aptitud necesita herramientas específicas como consultas de Kusto o acciones de Azure, agréguelas.

Paso siguiente

Contenido relacionado

• Habilidades
• Carga de documentos de conocimiento
• Subagentes
• Área de juegos del agente
• Herramientas
• Crear una herramienta Kusto
• Creación de una herramienta de Python
• Creación de tareas programadas
• Prueba de una herramienta en el área de juegos