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.
Creación de un agente personalizado
Puedes crear un agente personalizado de dos maneras: mediante el formulario de la aplicación web del DevOps agente o mediante una conversación guiada en Chat. Ambos métodos dan como resultado la misma configuración de agente personalizada almacenada en su 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.
Crear un agente personalizado mediante el formulario
El formulario le permite crear rápidamente un agente personalizado especificando un nombre, una solicitud del sistema y habilidades opcionales. Para asignar las herramientas de MCP al agente, utilice el chat después de crear el agente.
Para crear un agente personalizado mediante el formulario:
Navegue hasta la página de agentes en la aplicación web de su DevOps agente.
En la sección Agentes personalizados, elija Crear agente.
En el cuadro de diálogo, elija Formulario.
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-reportSímbolo 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 eficaces, consulte Cómo escribir un mensaje de sistema.
Habilidades (opcional): seleccione las habilidades de su espacio de agente que proporcionen al agente conocimientos o capacidades adicionales sobre el dominio. Utilice el campo de búsqueda para buscar las habilidades por nombre.
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
Chat ofrece una experiencia conversacional guiada para crear agentes personalizados. Se recomienda este método cuando desee asignar herramientas de MCP al agente o cuando necesite ayuda para escribir el mensaje del sistema.
Para crear un agente personalizado mediante Chat:
Navegue hasta la página de agentes en la aplicación web de su DevOps agente.
En la sección Agentes personalizados, elija Crear agente.
En el cuadro de diálogo, elija 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.
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 ya 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 te pide que confirmes.
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 que lo revise. 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ándole 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.
Importación de un agente personalizado desde un repositorio
Puedes importar el indicador del sistema de un agente personalizado directamente desde un archivo Markdown de un GitHub repositorio. El contenido del archivo se convierte en el indicador del sistema del agente. Puede gestionar las solicitudes del agente en el control de versiones e importarlas con una sola acción.
Requisitos previos:
Una GitHub cuenta asociada a su espacio de agente. Para conectar una GitHub cuenta, consulteConectando GitHub. Cualquier conexión de GitHub cuenta permite importar desde repositorios públicos. En el caso de los repositorios privados, la cuenta asociada debe tener acceso de lectura al repositorio. GitHub También se admiten GitHub Enterprise Server y Enterprise Cloud con conexiones de residencia de datos.
Un archivo Markdown (
.md) en un GitHub repositorio que contenga el indicador del sistema.
Para importar un agente personalizado desde un repositorio:
Navegue hasta la página de agentes en la aplicación web de su DevOps agente.
En la sección Agentes personalizados, elija Crear agente.
En el cuadro de diálogo, elija Importar. El cuadro de diálogo cambia a la GitHub vista Importar desde.
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.
URL del repositorio: un enlace a un único archivo Markdown (
.md) que contiene la línea de comandos del sistema del agente. Por ejemplo:https://github.com/my-org/my-repo/blob/main/my-agent.md. En el caso de GitHub Enterprise Server o GitHub Enterprise Cloud con residencia de datos, usa la URL de tu instancia en su lugar. Por ejemplo:https://github.example.com/my-org/my-repo/blob/main/my-agent.md. Si la URL no termina en.md, aparecerá una advertencia. La importación falla si el archivo no es Markdown.Habilidades (opcional): seleccione las habilidades de su espacio de agente para proporcionar al agente conocimientos o capacidades adicionales sobre el dominio.
Seleccione Agente de importación.
El archivo del repositorio solo proporciona el indicador del sistema. El nombre y las habilidades provienen del formulario.
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.
Visualización de los agentes importados:
Un agente importado muestra la GitHub insignia Sincronizado desde junto a su nombre en la página de detalles del agente, junto con la fecha de la última sincronización y un enlace al archivo fuente. GitHub En la lista de agentes personalizados, los agentes importados incluyen un enlace a su archivo fuente.
Si edita un agente importado, el indicador del sistema muestra una Read-only etiqueta con una sugerencia que enlaza con el archivo fuente. El nombre y las habilidades siguen siendo editables.
Sincronización de los agentes importados:
Cuando actualices el archivo Markdown de tu repositorio, abre la página de detalles del agente importado y selecciona Sincronizar para ver la última solicitud del sistema.
Restricciones:
Formato de URL: solo se aceptan las GitHub URL, incluidas GitHub Enterprise Server y GitHub Enterprise Cloud con residencia de datos. La GitHub cuenta conectada debe coincidir con el host de la URL. Por ejemplo, una
github.example.comconexión solo puede importar desdegithub.example.comdirecciones URL, no desde direccionesgithub.comURL.Archivo Markdown obligatorio: la URL debe apuntar a un único archivo.
.mdTamaño máximo de archivo: el archivo no debe superar 1 MB (límite de GitHub API).
GitHub se requiere una cuenta: su espacio de agente debe tener una GitHub cuenta asociada para importar agentes. En el caso de los repositorios privados, la cuenta debe tener acceso de lectura.
Agentes personalizados comunitarios
El repositorio de AWS DevOps Agent Tools
Para usar un agente personalizado de la comunidad, impórtelo desde el repositorio mediante el flujo Importar desde el repositorio de la página de agentes. Copia la URL del archivo Markdown del agente y pégala como la URL del repositorio. Para obtener más información, consulta Cómo importar un agente personalizado desde un repositorio.
Escribir un mensaje del sistema
El indicador del sistema es la parte más importante de su agente personalizado. Define el propósito, el enfoque, las restricciones y el resultado esperado del agente. Un mensaje bien redactado produce resultados consistentes y confiables.
Estructure el indicador 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 debe seguir el agente, 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 considerar 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 aviso 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 con respecto a las herramientas: haga referencia directa a los nombres de las herramientas (por ejemplo
list_investigationsuse_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 de las instrucciones.
Configuración de herramientas
Las herramientas de MCP determinan qué acciones puede realizar su agente personalizado durante la invocación. Usted selecciona las herramientas del conjunto completo disponible en su espacio de agente, incluidas las herramientas de las AWS cuentas conectadas, las plataformas de observabilidad, las CI/CD canalizaciones, los sistemas de venta de entradas 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 del mínimo privilegio: 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.
Herramientas de Release Manager
Los agentes personalizados tienen acceso a las herramientas de Release Manager. Estas herramientas permiten al agente crear, enumerar, obtener y cancelar las tareas de Release Manager. Su agente también puede analizar un informe de revisión del estado de preparación para publicar los resultados y las acciones recomendadas.
Para usar las herramientas de Release Manager, asígnelas a tu agente personalizado a través del chat. Por ejemplo:
Add the release manager tools to my release-pipeline-agent.
Para obtener más información sobre las capacidades de administración de versiones, consulteGestión de lanzamientos.
Configuración de habilidades
Las habilidades proporcionan a su agente personalizado conocimientos adicionales sobre el dominio, procedimientos de investigación o capacidades especializadas. Cuando se ejecuta un agente personalizado, carga sus habilidades asignadas y puede consultar sus instrucciones durante la invocación.
Puedes 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 ya deben existir en su espacio de agente. Para obtener más información sobre la creación de habilidades, consulteDevOps Habilidades de agente.
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.
Puede asignar hasta 200 habilidades por agente personalizado. Elija las habilidades que sean relevantes para el propósito del agente para reducir el consumo de contexto y mejorar la concentración del agente.
