Agentes personalizados en el agente de SRE de Azure

Los agentes personalizados son agentes especializados que se invocan bajo demanda. Escriba /agent en el chat, seleccione su especialista y haga su pregunta. Este proceso proporciona acceso a un experto en base de datos para problemas de SQL y un auditor de seguridad para la investigación de amenazas.

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

Cómo funcionan los agentes personalizados

Para invocar un agente personalizado, use el comando de barra oblicua /agent en el chat. El agente personalizado recibe el contexto de conversación completo y utiliza su experiencia especializada.

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

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

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: cuando se usa esta propiedad, el agente personalizado puede acceder a aptitudes dinámicamente.

Sugerencia

Las aptitudes son automáticas. El agente los usa siempre que sea pertinente. Los agentes personalizados son explícitos, es decir, se invocan mediante /agent cuando se necesita experiencia centrada.

¿Por qué usar agentes personalizados?

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

Considere un problema de base de datos: sin agentes personalizados, el agente principal intenta solucionar problemas genéricos. Con un agente personalizado "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 agentes personalizados también permiten cadenas de transferencia. El agente personalizado de evaluación de prioridades de incidentes clasifica un problema, lo transfiere al experto en el dominio adecuado, quien lo investiga y luego lo transfiere a un enrutador de notificaciones. Cada paso es especializado.

Creación de un agente personalizado

Cree agentes personalizados en Builder > Lienzo del agente.

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

2. Seleccione la pestaña Agent Canvas.

3. Selecciona Crear.

4. Seleccione Agente personalizado.

5. Proporcione valores para la siguiente configuración:

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

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

Administración de bases de conocimiento

Para mejorar el conocimiento de los agentes personalizados, cargue la documentación, los manuales operativos y las 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 al agente personalizado mediante la configuración de qué agentes personalizados pueden acceder a orígenes de conocimiento específicos.
5. Supervise el uso mediante el seguimiento de cómo usan los agentes personalizados los conocimientos cargados en sus respuestas.

Nota:

Los agentes personalizados indexarán automáticamente y harán que se puedan realizar búsquedas en los archivos que cargue. El sistema admite hasta 1000 archivos por instancia de agente personalizada.

Vistas del Lienzo del agente

Construya agentes personalizados en Builder>Lienzo del agente. Están disponibles las siguientes vistas:

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

Cuándo usar agentes personalizados

La tabla siguiente le ayuda a determinar cuándo los agentes personalizados son la opción adecuada:

Escenario	¿Usar agente personalizado?	Por qué
Conocimientos profundos de dominio necesarios	Sí	Experiencia de SQL de paquetes, conocimientos de redes, procedimientos recomendados de seguridad
Flujos de trabajo de varios pasos	Sí	Evaluación de prioridades de incidentes, validación de implementación, comprobación de copia de seguridad
Conjuntos de herramientas especializados	Sí	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 agente personalizado, consulte Respuesta a incidentes para la automatización de la respuesta.

Transferencia del agente personalizado

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

• Historial de conversaciones completo: todos los mensajes anteriores, las llamadas a herramientas y los resultados.
• Razonamiento de la subtarea: lo que el proceso de transferencia solicita que realice este agente personalizado.
• Pregunta original del usuario: se conserva a lo largo de la cadena de entrega.

Nota:

Los agentes personalizados no hacen "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 agente personalizado cede el control al siguiente agente o devuelve el control al orquestador. El contexto conversacional continúa acumulándose a lo largo de la cadena.

Patrones de agente personalizados

En la tabla siguiente se describen los patrones comunes de agente personalizado:

Modelo	Ejemplos	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)

Comparación de aptitudes, agentes personalizados y archivos de conocimiento

En la tabla siguiente se compara cada concepto de extensibilidad:

Feature	Habilidades	Agentes personalizados	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 hilo 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)
• Agente personalizado: especialista con ámbito invocado a petición (Experto en PostgreSQL)
• Archivo de conocimiento: contenido de referencia para el contexto (documentos de arquitectura)

Conexión de agentes personalizados a desencadenadores

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

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

Modos de agente personalizados

Cada agente personalizado se ejecuta en un modo que controla la autonomía que tiene. Establezca el modo para cada plan de respuesta o tarea programada.

Modo	Descripción
Reseña	Propone acciones, espera la aprobación
Autónomo	Actos sin aprobación humana

Elija el modo en función del riesgo:

• ¿Recomendaciones de optimización de costos? Use Revisión (se requiere aprobación humana).
• ¿Automatización bien probada? Use Autónomo (para operaciones de confianza).

Configure los modos para cada plan de respuesta o tarea programada. No establezca modos en la definición de YAML del agente personalizado. Para obtener más información, consulte Modos de ejecución.

Prueba y desarrollo de agentes personalizados

Pruebe los agentes personalizados en el área de pruebas antes de la implementación. Vaya a Builder>Agent Canvas y seleccione Test playground en el botón de alternancia 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 de servidor MCP del agente SRE te permite editar el YAML personalizado del agente en tu editor, con los cambios sincronizándose con el agente.

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

Contenido relacionado

Recurso	Descripción
Habilidades	Procedimientos y herramientas reutilizables para el agente
Enviar notificaciones	Enviar conclusiones de investigación a Teams, Outlook y mucho más
Chatear desde las herramientas	Interactúa con tu agente desde Teams, webhooks y mucho más