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.
Instrucciones para el agente
Utilice las instrucciones del agente para ofrecer la orientación permanente que el AWS DevOps agente aplica en cada sesión. Una sesión es una conversación o investigación única con un agente. En la página de información de la aplicación web de Agent Space Operator, seleccione la pestaña Instrucciones para configurar las instrucciones que se apliquen a todos los agentes o defina las instrucciones para un agente gestionado específico, como el chat o la clasificación de incidentes. Estas instrucciones se almacenan en un AGENTS.md archivo. A diferencia DevOps Habilidades de agente de lo que ocurre cuando el agente hace coincidir la descripción de una habilidad con la tarea actual, las instrucciones del agente siempre están presentes desde el inicio de cada sesión, independientemente de en qué esté trabajando el agente.
¿Qué son las instrucciones del agente
Las instrucciones para los agentes proporcionan una orientación incondicional y permanente para sus agentes. Al inicio de cada sesión, el servicio de agentes recupera las instrucciones configuradas para su espacio de agente e inyecta su contenido directamente en la línea de comandos del sistema de agentes. El agente no decide si cargarlas; siempre están presentes.
Cada sesión de agente recibe instrucciones tanto de las instrucciones globales como de las instrucciones específicas del agente pertinentes, por ejemplo, Chat.
Las instrucciones del agente se almacenan como AGENTS.md archivos y se diferencian entre sí DevOps Habilidades de agente en varios aspectos importantes:
| Aspecto | Habilidad | Instrucciones para el agente (AGENTS.md) |
|---|---|---|
| Nombre y descripción | Obligatorio | No aplicable |
| Formato del contenido | Paquete Markdown o ZIP | Solo Markdown |
| Archivos de recursos | compatible | No compatible |
| Inyección de contexto | A petición (el agente decide comparando las descripciones de las habilidades) | Siempre (sin condiciones, en cada sesión) |
| Singularidad | Múltiples por espacio de agente | Uno por agente (uno para las instrucciones globales y otro para cada agente gestionado) |
Las instrucciones del agente no tienen un campo de nombre ni descripción. El AGENTS.md archivo subyacente contiene solo archivos Markdown, sin soporte para paquetes ZIP ni archivos de recursos.
¿Por qué usar las instrucciones del agente
Las instrucciones para los agentes son una forma fiable de garantizar que determinadas directrices estén siempre en su contexto, sin depender de las decisiones del agente sobre la carga de habilidades.
Ventajas principales:
Previsibilidad: las instrucciones están siempre presentes, independientemente de la tarea en la que esté trabajando el agente. No es necesario hacer coincidir las descripciones y el agente no puede omitir el contenido.
Cobertura garantizada: a diferencia de las habilidades, que el agente puede cargar o no según la relevancia de la tarea, las instrucciones del agente siempre se envían al principio de cada sesión.
Políticas permanentes: utilice las instrucciones del agente para establecer políticas operativas permanentes, directrices de seguridad, estándares de codificación o cualquier otra orientación que deba aplicarse a todas las sesiones sin excepción.
Alcance específico: puede aplicar las instrucciones a todos los tipos de agentes a la vez mediante instrucciones globales, o restringir las instrucciones a un tipo de agente específico cuando la orientación solo sea relevante para el trabajo de ese agente.
Cómo funcionan las instrucciones de los agentes
Cuando se inicia una sesión, el servicio de agentes recupera las instrucciones configuradas para su espacio de agente e inyecta su contenido en el indicador del sistema de agentes antes de que comience la sesión. Esto ocurre automáticamente en cada sesión. El agente no evalúa si se deben cargar; siempre inyecta el contenido.
Cada nueva sesión carga las instrucciones como nuevas al inicio. Si actualizas las instrucciones, el cambio surtirá efecto inmediatamente en las sesiones que se inicien después de guardarlas. Las sesiones que ya están en curso siguen utilizando el contenido que se cargó cuando se iniciaron.
El alcance determina qué instrucciones recibe una sesión. Las instrucciones globales se aplican a todos los tipos de agentes de su espacio de agentes, por lo que cada sesión las recibe. Agent-specific las instrucciones se aplican solo a las sesiones de ese tipo de agente en particular. Una sesión recibe instrucciones tanto de las instrucciones globales como de las instrucciones específicas del agente pertinentes.
Determinación del alcance de los tipos de agente
El alcance controla qué sesiones de agentes reciben un conjunto determinado de instrucciones. Hay dos opciones de determinación del alcance:
Instrucciones globales: se aplican a todos los tipos de agentes de su espacio de agente. Cada sesión de agente recibe este contenido.
Agent-specific: Se aplica solo a las sesiones del tipo de agente seleccionado.
Los agentes gestionados disponibles para recibir instrucciones específicas para cada agente son:
Chat: Ad-hoc preguntas y solicitudes durante las sesiones de chat.
Clasificación de incidentes: filtrado de alarmas, clasificación de la gravedad y determinación del alcance inicial.
RCA de incidentes: análisis de la causa raíz con recopilación y validación de pruebas.
Mitigación de incidentes: recomendaciones de Short-term remediación y solución a largo plazo.
Interfaz de usuario de un incidente: generación de los resultados de una investigación, incluidos los publicados en otras plataformas.
Evaluación: puntuación del desempeño de los agentes y comprobaciones del cumplimiento de las políticas.
Pruebas de lanzamiento: pruebas automatizadas de interfaz de usuario y API en aplicaciones web y API REST implementadas.
Guía sobre el tamaño del contenido
Cada vez que inicias una conversación o una investigación, el agente lee todas tus instrucciones antes de hacer cualquier otra cosa. El agente tiene una cantidad fija de memoria de trabajo por sesión y tus instrucciones utilizan parte de ella. Cuanto más grande sea el archivo, menos espacio quedará para sus preguntas, investigaciones, los registros que lee el agente y su propio razonamiento. Las instrucciones más breves y específicas dan al agente más capacidad para resolver el problema.
Límite estricto: 25 KB
Tamaño recomendado: 120 líneas (recomendado para la mayoría de las configuraciones)
Centra tus instrucciones en la orientación que debe estar presente en cada sesión. En el caso de procedimientos de investigación especializados que se aplican solo a tareas específicas, considere utilizarlos DevOps Habilidades de agente en su lugar.
Ejemplo
En el siguiente ejemplo, se muestran instrucciones bien estructuradas para los agentes, con directrices para la investigación, estándares de formato de respuesta y requisitos de seguridad que se aplican a todas las sesiones de los agentes.
# Agent Instructions ## Investigation approach - Always check CloudWatch alarms and recent deployments before proposing a root cause. ## Response format - Lead with a one-sentence summary of findings before listing details. - Include the AWS region and resource identifier for any resource you reference. - Use bullet points for lists of findings or recommendations. ## Security - Never log, display, or suggest storing credentials or secrets in plaintext. - When recommending IAM changes, follow least-privilege principles.
Configurar las instrucciones del agente
Antes de configurar las instrucciones del agente, debe disponer de un espacio para agentes. Para obtener más información, consulte Creación de un espacio de agentes.
Cada agente tiene exactamente un conjunto de instrucciones. Al guardar contenido nuevo, se sobrescribe el contenido existente para ese agente.
Para establecer instrucciones globales (se aplican a todos los agentes):
Diríjase a la página de información de su aplicación web de Agent Space Operator.
Seleccione la pestaña Instrucciones.
Selecciona Ver junto a Todos los agentes.
Introduce las instrucciones de rebajas en el editor.
Seleccione Save.
Para configurar las instrucciones para un agente específico:
Navegue hasta la página de información de su aplicación web de Agent Space Operator.
Seleccione la pestaña Instrucciones.
Seleccione Ver junto al agente que desea configurar: chat, clasificación de incidentes, RCA de incidentes, mitigación de incidentes, interfaz de usuario de incidentes , evaluación o pruebas de lanzamiento.
Introduce las instrucciones de rebajas en el editor.
Seleccione Save.
Administrar las instrucciones del agente
AWS DevOps El agente proporciona capacidades de administración para las instrucciones de los agentes a través de la aplicación web Operator.
Visualización de las instrucciones: vaya a la página de información, seleccione la pestaña Instrucciones y seleccione Ver junto a Todos los agentes o al agente gestionado específico. El editor muestra el contenido actual. Usa la pestaña Vista previa para ver el marcador renderizado o la pestaña Código para ver el marcador sin procesar.
Instrucciones de edición: abre el agente tal y como se describe anteriormente, modifica el contenido en el editor y selecciona Guardar.
Instrucciones para subir un archivo: abre el agente y, a continuación, pulsa el botón Cargar en el editor para subir un archivo Markdown desde tu ordenador.
Instrucciones de descarga: abre el agente y, a continuación, selecciona el botón Descargar del editor para descargar el contenido actual en forma de archivo.
Instrucciones para eliminar: abre el agente, selecciona el botón Eliminar del editor y confirma la eliminación. Esta acción no se puede deshacer. Considera la posibilidad de descargar primero el contenido si es posible que lo necesites de nuevo.
