Instrucciones del agente

Utilice las instrucciones del agente para proporcionar una orientación permanente que el AWS DevOps agente aplique en cada sesión. Una sesión es una conversación o investigación única con un agente. En la página de agentes de la aplicación web Agent Space Operator, puede configurar instrucciones globales que se apliquen a todos los agentes o establecer instrucciones para un agente gestionado específico, como el chat o la clasificación de incidentes. Estas instrucciones se guardan como 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 están siempre 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 agente recupera las instrucciones configuradas para su espacio de agente e introduce su contenido directamente en el indicador del sistema del agente. El agente no decide si cargarlas o no; 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 de ellas DevOps Habilidades de agente en varios aspectos importantes:

Aspecto	Habilidad	Instrucciones para el agente (AGENTS.md)
Nombre y descripción	Obligatorio	No aplicable
Formato de contenido	Paquete Markdown o ZIP	Solo Markdown
Archivos de recursos	compatible	No compatible
Inyección de contexto	A pedido (el agente decide mediante la comparación de las descripciones de las habilidades)	Siempre (incondicional, en cada sesión)
Singularidad	Múltiplo por espacio de agente	Uno por agente (uno para instrucciones globales y uno por agente gestionado)

Las instrucciones del agente no tienen ningún campo de nombre o descripción. El AGENTS.md archivo subyacente solo contiene archivos Markdown sin contenido preliminar, sin soporte para paquetes ZIP ni archivos de recursos.

¿Por qué usar las instrucciones del agente

Las instrucciones del agente le proporcionan una forma fiable de garantizar que determinadas directrices estén siempre en su contexto, sin depender de las decisiones que tome el agente sobre la carga de habilidades.

Ventajas clave:

• Previsibilidad: las instrucciones están siempre presentes, independientemente de la tarea en la que esté trabajando el agente. No es necesario que la descripción coincida y el agente no puede omitir el contenido.

• Cobertura garantizada: a diferencia de las habilidades, que el agente puede o no cargar según la relevancia de la tarea, las instrucciones del agente siempre se incluyen al principio de cada sesión.

• Políticas permanentes: utilice las instrucciones de los agentes para establecer políticas operativas permanentes, directrices de seguridad, normas de codificación o cualquier otra guía que deba aplicarse a todas las sesiones sin excepción.

• Alcance objetivo: puede aplicar las instrucciones a todos los tipos de agentes a la vez mediante instrucciones globales, o restringirlas a un tipo de agente específico cuando la guía sea relevante únicamente para el trabajo de ese agente.

Cómo funcionan las instrucciones para los agentes

Cuando se inicia una sesión, el servicio de agente recupera las instrucciones configuradas para su espacio de agente e inyecta su contenido en el indicador del sistema del agente antes de que comience la sesión. Esto ocurre automáticamente en cada sesión. El agente no evalúa si cargarlas; siempre inyecta el contenido.

Cada nueva sesión carga las instrucciones 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 seguirán utilizando el contenido que se cargó cuando se iniciaron.

El alcance determina las instrucciones que recibe una sesión. Las instrucciones globales se aplican a todos los tipos de agentes de tu espacio de agente, por lo que todas las sesiones las reciben. 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.

Tipo de agente: alcance

El ámbito controla qué sesiones de los agentes reciben un conjunto de instrucciones determinado. Hay dos opciones de determinación del alcance:

• Instrucciones globales: se aplican a todos los tipos de agentes de tu 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 gravedad y alcance inicial.

• RCA del incidente: 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 reparación a largo plazo.

• Evaluación: puntuación del desempeño de los agentes y controles del cumplimiento de las políticas.

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 queda para las preguntas, las investigaciones, los registros que lee el agente y su propio razonamiento. Las instrucciones más breves y específicas le 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 las directrices que deben estar presentes en todas las sesiones. En el caso de procedimientos de investigación especializados que se apliquen únicamente 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 de investigación, normas de formato de respuesta y requisitos de seguridad aplicables 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 de agente. 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 configurar instrucciones globales (se aplica a todos los agentes):

1. Navegue hasta la página de agentes en su aplicación web Agent Space Operator.

2. Seleccione Ver junto a las instrucciones globales.

3. Introduce tus instrucciones de rebajas en el editor.

4. Seleccione Save.

Para configurar las instrucciones para un agente específico:

1. Navegue a la página de agentes en su aplicación web Agent Space Operator.

2. En Agentes gestionados, selecciona Ver junto al agente que quieres configurar: chat, clasificación de incidentes, RCA de incidentes, mitigación de incidentes o evaluación.

3. Introduce tus instrucciones de rebajas en el editor.

4. Seleccione Save.

Administrar las instrucciones del agente

AWS DevOps El agente proporciona capacidades de administración de las instrucciones del agente a través de la aplicación web Operator.

Instrucciones de visualización: vaya a la página de agentes y seleccione Ver junto a las instrucciones globales o al agente gestionado específico. El editor muestra el contenido actual. Usa la pestaña Vista previa para ver las rebajas renderizadas o la pestaña Código para ver las rebajas sin procesar.

Instrucciones de edición: abre el agente tal y como se ha descrito anteriormente, modifica el contenido en el editor y selecciona Guardar.

Instrucciones para cargar desde un archivo: abra el agente y, a continuación, pulse el botón Cargar en el editor para cargar un archivo marcado desde su ordenador.

Instrucciones de descarga: abre el agente y, a continuación, pulsa el botón Descargar del editor para descargar el contenido actual como un archivo.

Instrucciones de eliminación: abra el agente, pulse el botón Eliminar en el editor y confirme la eliminación. Esta acción no se puede deshacer. Considere la posibilidad de descargar primero el contenido si es posible que lo necesite de nuevo.