Compartir a través de


Subagentes en el agente de SRE de Azure

Los subagentes son agentes especialistas que se invocan a petición. Escriba /agent en el chat, seleccione su especialista y haga su pregunta. Por ejemplo, puede invocar a un experto en base de datos para problemas de SQL o un auditor de seguridad para la investigación de amenazas.

A diferencia de las aptitudes (que siempre están disponibles), los subagentes requieren invocación explícita. Este requisito limita su experiencia a tareas específicas.

Captura de pantalla del lienzo del generador de subagentes que muestra los subagentes conectados a desencadenadores y herramientas.

Funcionamiento de los subagentes

Invoque un subagente mediante el comando de diagonal /agent en el chat. El subagente recibe el contexto completo de la conversación y opera con especialización enfocada.

En el ejemplo siguiente se muestra una definición básica del subagente:

name: database_expert
system_prompt: |
  You are a database specialist. Analyze query performance,
  diagnose connection issues, and recommend optimizations.
handoff_description: Handles SQL and database troubleshooting
tools:
  - execute_kusto_query
  - azure_cli
connectors:
  - azure_sql
enable_skills: true  # Can use skills for additional expertise
agent_type: Review   # ReadOnly | Review | Autonomous

Las propiedades clave incluyen:

  • system_prompt: la persona experta y las instrucciones.
  • handoff_description: lo que ve el orquestador al decidir delegar.
  • tools: funcionalidades disponibles.
  • enable_skills: Permite que este subagente acceda a las habilidades de manera dinámica.
  • agent_type: controla las acciones (ReadOnly, Review, Autonomous).

Sugerencia

Las aptitudes son automáticas: el agente las usa siempre que sea pertinente. Los subagentes son explícitos: los invoca mediante /agent cuando se necesita experiencia centrada.

¿Por qué usar subagentes?

Los subagentes permiten empaquetar conocimientos, herramientas y conocimientos sobre el dominio para su reutilización. En lugar de su agente principal intentando controlar todo, se delega a especialistas.

Considere un problema de base de datos: sin subagentes, el agente principal intenta solucionar problemas genéricos. Con un subagente "Experto en bases de datos", obtendrá conocimientos específicos de SQL, runbooks específicos de la base de datos y herramientas optimizadas para el análisis de consultas.

Los subagentes también permiten cadenas de entrega. El subagente de evaluación de prioridades de incidentes clasifica un problema y entrega al experto en dominio adecuado. El experto en dominio investiga y remite a un enrutador de notificaciones. Cada paso es especializado.

Creación de un subagent

Cree subagentes en Generador > de subagentes.

  1. Vaya a su agente SRE de Azure en Azure Portal.

  2. Seleccione la pestaña Generador de subagentes .

  3. Selecciona Crear.

  4. Seleccione Subagent.

  5. Proporcione valores para la siguiente configuración:

    Propiedad Importancia
    Nombre Escriba un nombre descriptivo para el subagente.
    Instrucciones Proporcione instrucciones personalizadas claras que definan cómo debe comportarse el subagente.
    Descripción de entrega Explicar los escenarios en los que otros subagentes deben transferir el procesamiento a este subagente y por qué.
    Herramientas personalizadas (opcional) Elija una o varias herramientas personalizadas para que el subagent use durante sus operaciones.
    Herramientas integradas (opcional) Seleccione las herramientas del sistema integradas a las que desea que el subagent tenga acceso.
    Agentes de entrega (opcional) Especifique qué subagente debe asumir el procesamiento después de que este subagent complete sus tareas.

    Opcionalmente, puede habilitar la característica knowledge base . Esta opción permite cargar archivos que el subagent puede usar como material de referencia al responder a las consultas.

Administración de bases de conocimiento

Mejore el conocimiento de los subagentes mediante la carga de documentación, runbooks y guías de procedimientos.

Ejemplos de archivos que puede agregar a su agente:

  • Diseño de arquitectura o sistema: diagramas y documentación que explican los componentes del sistema y los flujos de datos.
  • Guías de solución de problemas: instrucciones paso a paso para diagnosticar y resolver problemas comunes o recurrentes.
  • Runbooks y SOPs: Flujos de trabajo detallados para operaciones rutinarias, mantenimiento y respuesta a incidentes.
  • Informes de incidentes y postmortems: documentación de interrupciones pasadas, incluido el análisis de la causa principal y las lecciones aprendidas.
  • Notas de la versión y registros de cambios: resúmenes de actualizaciones de productos o servicios, incluidas nuevas características, correcciones de errores y cambios.

Tipos de archivo compatibles

Procedimientos operativos en formato Markdown (.md) o texto (.txt).

Flujo de trabajo de administración de archivos

  1. Para acceder a la base de conocimiento, vaya a la pestaña Configuración > Base de conocimiento > Archivos.
  2. Cargue archivos arrastrando y colocando los archivos o navegando para seleccionar archivos (máximo 50 MB por archivo).
  3. Organice el contenido agregando etiquetas y descripciones para mejorar la capacidad de búsqueda.
  4. Habilite el acceso a subagentes configurando qué subagentes pueden acceder a orígenes de conocimiento específicos.
  5. Supervise el uso mediante el seguimiento de cómo los subagentes usan el conocimiento cargado en sus respuestas.

Nota:

Los subagentes indexan y realizan búsquedas automáticamente en los archivos cargados. El sistema admite hasta 1000 archivos por instancia de subagent.

Vistas del generador de subagentes

Compile subagentes en el Generador > de subagentes. Están disponibles las siguientes vistas:

Ver propósito
Vista de Canvas Diagrama visual que muestra subagentes, herramientas y conexiones de desencadenador
Vista de tabla Lista de todos los subagentes con acceso rápido
Prueba del área de juegos Entorno de pruebas interactivas

Cuándo usar subagentes

La tabla siguiente le ayuda a determinar cuándo los subagentes son la opción correcta:

Escenario ¿Usar subagente? Por qué
Conocimientos profundos de dominio necesarios Experiencia de SQL de paquetes, conocimientos de redes, procedimientos recomendados de seguridad
Flujos de trabajo de varios pasos Evaluación de prioridades de incidentes, validación de implementación, comprobación de copia de seguridad
Conjuntos de herramientas especializados Herramientas específicas de la base de datos, herramientas de optimización de costos
Operaciones simples únicas No Usar aptitudes en su lugar para acciones sencillas y repetibles
Consultas de solo lectura No El agente principal puede controlar sin delegación

Para obtener una configuración completa del subagente, consulte Respuesta a incidentes para la automatización de la respuesta.

Entrega de subagentes

Cuando el agente principal se entrega a un subagente, comparten un único contexto de conversación. El subagente receptor ve:

  • Historial de conversaciones completo: todos los mensajes anteriores, las llamadas a herramientas y los resultados
  • Razonamiento de subtarea: lo que se le pide a este subagente que realice
  • Pregunta original del usuario: conservada en toda la cadena de entrega

Nota:

Los subagentes no obtienen un "borrón y cuenta nueva". Continúan el mismo hilo de conversación. Este enfoque permite cadenas de entrega en las que cada especialista se basa en el trabajo del agente anterior.

Después de completar su trabajo, el subagente se entrega al siguiente agente o devuelve el control al orquestador. El contexto conversacional continúa acumulándose a lo largo de la cadena.

Patrones de subagentes

En la tabla siguiente se describen los patrones de subagentes comunes:

Modelo Subagentes de ejemplo Caso de uso
Experto en dominio Experto en máquinas virtuales, experto en AKS, experto en red Experiencia profunda en una tecnología (todos los problemas de máquina virtual, solución de problemas de Kubernetes, red virtual,NSG/equilibrador de carga)
Especialista en tareas Analizador de registros, Optimizador de costos, Analizador de seguridad Centrado en tareas específicas (análisis de registros, búsqueda de ahorros, identificación de vulnerabilidades)
Ejecutor de flujo de trabajo Evaluación de incidentes, Validador de implementación, Comprobador de copia de seguridad Procedimientos de varios pasos (clasificación de incidentes, comprobaciones posteriores a la implementación, integridad de copia de seguridad de prueba)

Comparar habilidades, subagentes y archivos de conocimiento

En la tabla siguiente se compara cada concepto de extensibilidad:

Feature Habilidades Subagentes Archivos de conocimiento
Access Automático Comando /agent Mediante la herramienta de consulta de KB
Herramientas Se puede adjuntar Tiene herramientas Sin herramientas
Contexto Usa el contexto del subproceso Contexto de subproceso compartido Solo referencia
Más adecuado para Procedimientos Especialistas en dominios Runbooks, documentos

Use las instrucciones siguientes para elegir el enfoque adecuado:

  • Aptitud: procedimiento para todo el equipo con ejecución opcional (guía de solución de problemas de AKS + CLI de Azure)
  • Subagente: especialista en área específica activado bajo demanda (Experto en PostgreSQL)
  • Archivo de conocimiento: contenido de referencia para el contexto (documentos de arquitectura)

Conexión de subagentes a desencadenadores

Los incidentes o las tareas programadas pueden desencadenar automáticamente subagentes. La vista de lienzo muestra estas conexiones visualmente: los desencadenadores aparecen como nodos conectados a subagentes, las herramientas se agrupan con su subagente primario y las notificaciones de estado muestran el estado activo o inactivo.

Para más información sobre la configuración, consulte Respuesta a incidentes para conectar subagentes a incidentes o Tareas programadas para la automatización periódica.

Modos de subagentes

Cada subagente puede funcionar en un modo diferente en función del nivel de autonomía que desee conceder.

Modo Descripción
ReadOnly Solo puede consultar y analizar, sin acciones
Reseña Propone acciones, espera la aprobación
Autónomo Actos sin aprobación humana

Establezca el modo en función del nivel de riesgo del subagente:

  • ¿Análisis de registros? ReadOnly (más seguro)
  • ¿Recomendaciones de optimización de costos? Revisión (se requiere aprobación humana)
  • ¿Automatización bien probada? Autónomo (para operaciones de confianza)

Prueba y desarrollo de subagentes

Pruebe los subagentes en el entorno de pruebas antes de desplegar. Vaya a Builder Subagent builder< c0 /> y seleccione Test playground en el alternador de vista. El diseño de pantalla dividida le permite editar instrucciones a la izquierda y probar en un chat en directo a la derecha, con la evaluación con tecnología de inteligencia artificial para puntuar la configuración.

Para los usuarios de VS Code, la extensión del servidor MCP del agente SRE les permite editar archivos YAML de subagente en su editor, con los cambios sincronizándose con su agente.

Captura de pantalla del área de juegos del agente con el editor de pantalla dividida y el panel de prueba de chat.

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

Paso siguiente