View a markdown version of this page

Ejecución de agentes personalizados - AWS DevOps Agente

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.

Ejecución de agentes personalizados

Puede ejecutar un agente personalizado a petición o configurar activadores para que se ejecuten automáticamente.

Cómo ejecutar un agente personalizado bajo demanda

Puedes crear un agente personalizado inmediatamente desde la página de detalles del agente o a través del chat.

Para ejecutar un agente personalizado desde la página de detalles:

  1. Navega hasta la página de agentes en la aplicación web de tu DevOps agente.

  2. Elija el agente personalizado que desea ejecutar.

  3. Elija Ejecutar ahora para ejecutar el agente con las instrucciones configuradas.

Para proporcionar un contexto adicional para una ejecución específica, seleccione la flecha desplegable situada junto a Ejecutar ahora, introduzca un mensaje que describa en qué debe centrarse el agente en esta invocación y seleccione Ejecutar con mensaje. La solicitud se pasa al agente como contexto adicional junto con la solicitud del sistema.

Una vez iniciada la ejecución, la nueva invocación aparece en la pestaña Historial con el estado «Inicio pendiente». Elige la invocación para ver su trayectoria en tiempo real.

Para ejecutar un agente personalizado mediante Chat:

Pídele a Chat que ejecute el agente por su nombre. Por ejemplo:

Run my weekly-investigation-report agent.
Run certificate-checker and focus on certificates expiring in the next 7 days.

Cuando proporcionas contexto adicional en el mensaje de chat, Chat lo pasa como la solicitud para ejecutarlo. Si no proporciona contexto adicional, el agente se ejecuta únicamente con la línea de comandos del sistema configurada.

Un agente personalizado solo puede ejecutar una invocación a la vez. Si el agente ya está en ejecución, debe esperar a que se complete la invocación actual, se agote el tiempo de espera o se cancele antes de iniciar otra.

Programación de agentes personalizados

Los activadores permiten ejecutar un agente personalizado automáticamente en función de las condiciones definidas. AWS DevOps Actualmente, el agente admite activadores basados en cronogramas, que ejecutan el agente a intervalos periódicos mediante expresiones EventBridge-compatible cron o rate.

Para crear un activador de programación:

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

  2. Elija el agente personalizado que desea programar.

  3. Elija la pestaña Desencadenadores.

  4. Elija el botón + (crear).

  5. En el cuadro de diálogo, introduzca una expresión de programación en el campo de entrada. La expresión debe tener uno de los siguientes formatos:

    • Expresión de velocidad: se ejecuta en un intervalo fijo. Formato: rate(value unit). Ejemplos:

      • rate(1 hour)— Cada hora

      • rate(30 minutes)— Cada 30 minutos

      • rate(7 days)— Cada 7 días

    • Expresión Cron: se ejecuta según un horario específico. Formato: cron(minutes hours day-of-month month day-of-week year). Ejemplos:

      • cron(0 9 ? * MON-FRI *)— Todos los días de la semana a las 9:00 a.m. UTC

      • cron(0 0 1 * ? *)— El primer día de cada mes a medianoche (hora peninsular española)

      • cron(0 */6 ? * * *)— Cada 6 horas

Aparece un mensaje de confirmación verde cuando la expresión es válida.

  1. Seleccione Crear.

En el caso de las expresiones cron, debe ser ? exactamente un día del mes o un día de la semana (signo de interrogación). Para obtener más información sobre la sintaxis de las expresiones de programación, consulte los tipos de programación en la guía del usuario de Amazon Scheduler. EventBridge

Tras la creación, el activador aparece en la lista y muestra su expresión, la fecha de creación y la siguiente hora de ejecución programada.

También puede crear desencadenadores mediante programación. Usa los AWS SDK para invocar la CreateTrigger operación del devops-agent cliente, que requiere el permiso. aidevops:CreateTrigger Como alternativa, modele los activadores a medida que AWS::DevOpsAgent::Trigger ingresan recursos. AWS CloudFormation Un desencadenador basado en una programación hace referencia al agente personalizado que ejecuta, por lo que debe crear primero el agente. Para obtener más información sobre el tipo de AWS::DevOpsAgent::Trigger recurso, consulte. Administración de activos

Administrar los desencadenantes

La pestaña Activadores muestra todos los activadores configurados para el agente personalizado. Para cada desencadenador, puede ver la expresión de programación, cuándo se creó y cuándo se ejecutará de nuevo.

Pausar un disparador:

Para impedir temporalmente que un activador invoque al agente sin eliminarlo, desactive el interruptor situado junto al activador. El estado del activador cambia a «En pausa» y deja de activarse hasta que se vuelva a activar. Vuelva a activar el botón para reanudar la programación.

Eliminar un disparador:

Para eliminar un disparador de forma permanente, elige el icono de eliminación (papelera) situado junto al disparador que quieres eliminar. Confirma la eliminación en el cuadro de diálogo que aparece. Los activadores eliminados no se pueden recuperar.

Cancelar una invocación

Puedes cancelar una invocación en ejecución desde la vista de trayectoria de invocación o mediante el chat.

Para cancelar una invocación en ejecución desde la vista de trayectoria:

  1. En la pestaña Historial, elige la invocación en ejecución.

  2. Seleccione Cancelar en la parte superior de la vista de trayectoria.

Para cancelar una invocación en ejecución mediante Chat:

Cancel the running invocation of weekly-health-report.

El estado de la invocación cambia a «Cancelado». Cualquier trabajo completado antes de la cancelación se conserva en la trayectoria. Las llamadas a las herramientas que estaban en curso cuando se produjo la cancelación aún pueden completarse.

Resultados de las llamadas a herramientas

Durante la invocación, el agente personalizado invoca las herramientas de MCP para recopilar datos, realizar acciones y generar resultados. Cada llamada a la herramienta y su resultado se registran en la trayectoria de invocación.

Los resultados de las llamadas a las herramientas proporcionan información transparente sobre lo que hizo el agente durante la invocación:

  • Llamadas a herramientas correctas: la herramienta devolvió datos que el agente utiliza para continuar con su trabajo. Por ejemplo, query_cloudwatch_logs devuelve entradas de registro o use_aws respuestas de la API.

  • Llamadas a la herramienta fallidas: la herramienta ha devuelto un error. El agente puede volver a intentarlo, probar un enfoque alternativo o informar del error en su resultado.

Puede inspeccionar las llamadas individuales a las herramientas y sus resultados a lo largo de la trayectoria de invocación para comprender el comportamiento del agente, verificar que ha accedido a los recursos correctos y solucionar los resultados inesperados. Para obtener más información sobre la visualización de las trayectorias, consulte Visualización de una trayectoria de invocación.