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 pedido o configurar activadores para que se ejecute automáticamente.

Ejecutar un agente personalizado bajo demanda

Puede ejecutar 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. Navegue hasta la página de agentes en su aplicación web de DevOps agentes.

  2. Elija el agente personalizado que desee ejecutar.

  3. Seleccione Ejecutar ahora para ejecutar el agente con sus instrucciones configuradas.

Para proporcionar 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 elija 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». Seleccione la invocación para ver su trayectoria en tiempo real.

Para ejecutar un agente personalizado mediante Chat:

Pide a Chat que dirija 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 mensaje para esa ejecución. 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.

Programar 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 horarios, que ejecutan al agente a intervalos recurrentes mediante expresiones EventBridge-compatible cron o rate.

Para crear un activador programado:

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

  2. Elija el agente personalizado que desee programar.

  3. Elija la pestaña Desencadenadores.

  4. Selecciona 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 en 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 UTC

      • 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 el día del mes o el 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 Tipos de programación en la Guía del usuario de Amazon EventBridge Scheduler.

Tras la creación, el disparador aparece en la lista con su expresión, fecha de creación y próxima hora de ejecución programada.

Administrar los desencadenadores

La pestaña Activadores muestra todos los activadores configurados para el agente personalizado. Para cada activador, 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 conmutador situado junto al activador. El estado del disparador 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, selecciona 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 desencadenadores eliminados no se pueden recuperar.

Cancelar una invocación

Puede cancelar una invocación en ejecución desde la vista de la trayectoria de la invocación o a través del chat.

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

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

  2. Selecciona 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 «Cancelada». Todo trabajo realizado antes de la cancelación se conserva en la trayectoria. Es posible que las llamadas a las herramientas que estaban en curso cuando se produjo la cancelación aún se hayan completado.

Resultados de 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 transparencia sobre lo que hizo el agente durante la invocación:

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

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

Puede inspeccionar las llamadas a las herramientas individuales y sus resultados en la trayectoria de invocación para comprender el comportamiento del agente, comprobar que ha accedido a los recursos correctos y solucionar los problemas que se produzcan de forma inesperada. Para obtener más información sobre la visualización de las trayectorias, consulte Visualización de una trayectoria de invocación.