

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.

# Crear un agente personalizado
<a name="custom-agents-creating-a-custom-agent"></a>

Puedes crear un agente personalizado de dos maneras: mediante el formulario de la aplicación web DevOps Agent o mediante una conversación guiada en Chat. Ambos métodos dan como resultado la misma configuración de agente personalizada almacenada en tu espacio de agente.

Antes de crear un agente personalizado, debe tener un espacio de agente con al menos una integración conectada. Para obtener más información, consulte [Creación de un espacio de agentes](getting-started-with-aws-devops-agent-creating-an-agent-space.md).

## Crear un agente personalizado mediante el formulario
<a name="creating-a-custom-agent-using-the-form"></a>

El formulario le permite crear rápidamente un agente personalizado especificando un nombre, un mensaje del sistema y habilidades opcionales. Para asignar herramientas de MCP al agente, utilice Chat después de crear el agente.

**Para crear un agente personalizado mediante el formulario:**

1. Navegue a la página de **agentes** en su aplicación web de DevOps agentes.

1. En la sección **Agentes personalizados**, selecciona **Crear agente**.

1. En el cuadro de diálogo, elija **Formulario**.

1. Rellene el formulario:
   + **Nombre**: un identificador único para su agente. Utilice únicamente letras minúsculas, números y guiones (64 caracteres como máximo). No debe empezar ni terminar con un guión. Ejemplo: `weekly-health-report`
   + **Mensaje del sistema**: instrucciones que definen lo que hace el agente y cómo funciona, escritas en Markdown (mínimo 10 caracteres, máximo 50 000 caracteres). Para obtener instrucciones sobre cómo escribir mensajes efectivos, consulte Cómo [escribir un mensaje del sistema.](#writing-a-system-prompt)
   + **Habilidades** (opcional): seleccione las habilidades de su espacio de agente que proporcionen al agente conocimientos o capacidades adicionales sobre el campo. Usa el campo de búsqueda para buscar las habilidades por nombre.

1. Elija **Crear agente**.

Tras la creación, se le redirigirá a la página de detalles del agente, donde podrá ver la configuración, ejecutar el agente o configurar los activadores.

## Crear un agente personalizado mediante Chat
<a name="creating-a-custom-agent-using-chat"></a>

Chat proporciona una experiencia conversacional guiada para crear agentes personalizados. Este método se recomienda si desea asignar herramientas de MCP al agente o si necesita ayuda para escribir el mensaje del sistema.

**Para crear un agente personalizado mediante Chat:**

1. Navegue a la página de **agentes** en su aplicación web de DevOps agentes.

1. En la sección **Agentes personalizados**, selecciona **Crear agente**.

1. En el cuadro de diálogo, selecciona **Chat**. El cuadro de diálogo se cierra y se abre una nueva conversación en el panel de chat con un mensaje ya redactado.

1. El chat lo guía a través de un proceso de colaboración:
   + **Aclaración de intenciones**: confirma el propósito y el alcance de su agente.
   + **Verificación duplicada**: verifica que no exista ningún agente similar en su espacio de agente.
   + **Selección de herramientas y habilidades**: propone qué herramientas y habilidades de MCP necesita el agente y le pide que las confirme.
   + **Tipo de resultado**: determina si el agente debe producir respuestas de texto, artefactos o recomendaciones.
   + **Borrador del mensaje** del sistema: escribe un mensaje del sistema y lo presenta para su revisión. Puede repetirlo hasta que esté satisfecho.
   + **Confirmación**: sugiere un nombre y confirma todos los ajustes antes de crear el agente.

También puedes crear un agente personalizado preguntándolo directamente a Chat en cualquier momento. Por ejemplo:

```
Create an agent that generates a weekly report of all investigations from the past week.
```

```
Create a custom agent for checking certificate expiration across all accounts.
```

```
Make me an agent that audits DynamoDB table configurations daily.
```

## Escribir un mensaje del sistema
<a name="writing-a-system-prompt"></a>

El mensaje del sistema es la parte más importante de su agente de aduanas. Define el propósito, el enfoque, las limitaciones y los resultados esperados del agente. Un mensaje bien redactado produce resultados consistentes y confiables.

**Estructura el mensaje del sistema con estas secciones:**
+ **Objetivo**: lo que el agente debe lograr en una sola oración o en un párrafo corto.
+ **Enfoque**: Step-by-step procedimientos que el agente debe seguir, haciendo referencia a los nombres específicos de las herramientas a las que debe llamar y en qué orden.
+ **Restricciones**: límites sobre lo que el agente debe y no debe hacer. Por ejemplo, el acceso de solo lectura, los intervalos de tiempo que se deben tener en cuenta o los servicios que se deben excluir.
+ **Resultado**: qué debe producir el agente y en qué formato. Especifique si debe generar texto, crear un artefacto o crear una recomendación.

**Ejemplo de mensaje del sistema:**

```
You are a DevOps reporting agent specializing in summarizing investigation activity.

## Goal
Generate a concise weekly report of all investigations from the past 7 days.

## Approach
1. Call `list_investigations` to fetch investigations from the last 7 days.
2. For each investigation, retrieve its title, status, root cause, and resolution time.
3. Group investigations by status and root cause category.
4. Identify trends: services most affected, average resolution time, recurring root causes.

## Constraints
- Only include investigations from the past 7 days.
- Read-only access — do not modify, close, or reassign investigations.

## Output
Produce a single artifact titled "Weekly Investigation Report" containing:
- A table listing each investigation with title, status, and resolution time.
- A chart showing investigation counts by root cause category.
- A summary paragraph with key trends and recommendations.
```

**Consejos para que las indicaciones del sistema sean eficaces:**
+ **Sea específico acerca de las herramientas**: consulte directamente los nombres de las herramientas (por ejemplo,`list_investigations`,`use_aws`,`query_cloudwatch_logs`) para que el agente sepa a qué herramientas debe llamar.
+ **Defina los criterios de éxito**: describa qué aspecto tiene un buen resultado para que el agente sepa cuándo está listo.
+ **Establezca límites**: indique explícitamente lo que el agente no debe hacer para evitar acciones no deseadas.
+ **Utilice el formato Markdown**: los encabezados, las listas y los bloques de código facilitan al agente el análisis y el seguimiento del mensaje.

## Herramientas de configuración
<a name="configuring-tools"></a>

Las herramientas de MCP determinan qué acciones puede realizar su agente personalizado durante la invocación. Puede seleccionar herramientas del conjunto completo disponible en su espacio de agente, incluidas las herramientas de las AWS cuentas conectadas, las plataformas de observación, los CI/CD canales, los sistemas de emisión de tickets y los servidores MCP personalizados.

Las herramientas solo se pueden configurar a través del chat. Para asignar herramientas al crear un agente, utilice el método de creación de Chat. Para añadir o cambiar las herramientas de un agente existente, pídele a Chat que actualice el agente. Por ejemplo:

```
Add the query_cloudwatch_logs and use_aws tools to my weekly-health-report agent.
```

```
Update certificate-checker to also use the list_resources tool.
```

```
Remove the use_kubectl tool from cluster-audit-agent.
```

Al seleccionar las herramientas, siga el principio de privilegios mínimos: asigne solo las herramientas que el agente necesite para realizar su tarea. Esto reduce el riesgo de acciones no deseadas y mantiene al agente concentrado.

## Habilidades de configuración
<a name="configuring-skills"></a>

Las habilidades proporcionan a su agente personalizado conocimientos de dominio adicionales, procedimientos de investigación o capacidades especializadas. Cuando se ejecuta un agente personalizado, carga las habilidades que se le han asignado y puede consultar sus instrucciones durante la invocación.

Puede asignar habilidades durante la creación (mediante el formulario o el chat) o añadirlas más adelante editando el agente. Las habilidades asignadas a un agente personalizado deben existir ya en tu espacio de agente. Para obtener más información sobre la creación de habilidades, consulte[DevOps Habilidades de agente](about-aws-devops-agent-devops-agent-skills.md).

Los agentes personalizados también tienen funciones integradas para crear artefactos y recomendaciones que no requieren la asignación de habilidades. Para obtener más información, consulte [Salidas de agente personalizadas](custom-agents-custom-agent-outputs.md).

Puede asignar hasta 200 habilidades a cada agente personalizado. Elija habilidades que sean relevantes para el propósito del agente a fin de reducir el consumo de contexto y mejorar la concentración del agente.