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 de forma inmediata 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:
Navega hasta la página de agentes en la aplicación web de tu DevOps agente.
Elija el agente personalizado que desea ejecutar.
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.
Configuración de los desencadenadores de
Los activadores ejecutan automáticamente un agente personalizado en función de las condiciones definidas. AWS DevOps El agente admite dos tipos de desencadenantes:
Programe los activadores: ejecute el agente a intervalos periódicos mediante expresiones EventBridge-compatible cron o de tasa.
Activadores de eventos: ejecuta el agente cuando llega un evento de webhook desde una integración conectada, pasando la carga útil del evento como contexto.
Ambos tipos de activadores se crean desde la pestaña Activadores del agente personalizado. Para abrirlo, vaya a la página Agentes en la aplicación web de su DevOps agente, elija el agente personalizado y, a continuación, elija la pestaña Activadores.
Crear un activador de programación
Las expresiones de programación utilizan la sintaxis EventBridge-compatible cron o rate. 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 horarate(30 minutes)— Cada 30 minutosrate(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. UTCcron(0 0 1 * ? *)— El primer día de cada mes a medianoche (hora peninsular española)cron(0 */6 ? * * *)— Cada 6 horas
En el caso de las expresiones cron, debe coincidir 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
Para crear un activador de programación:
Selecciona el botón + (crear).
Para el tipo de desencadenador, selecciona Programar.
Introduzca una expresión de programación. Aparece un mensaje de confirmación verde cuando la expresión es válida.
(Opcional) Para proporcionar un contexto adicional para cada ejecución programada, introduzca una solicitud en el campo Solicitud de usuario (opcional). La solicitud se envía al agente junto con la solicitud del sistema.
Seleccione Crear.
Tras la creación, el activador aparece en la lista con su expresión, fecha de creación y siguiente hora de ejecución programada.
Creación de un desencadenador de eventos
Un desencadenador de eventos ejecuta el agente personalizado cuando llega un evento de webhook desde una integración conectada. La carga útil del evento se pasa al agente como contexto para esa ejecución.
Requisitos previos:
Antes de crear un activador de eventos, debes tener una integración conectada con un webhook activo en tu espacio de agente. Cualquier integración con un webhook activo puede servir como fuente de eventos. Para obtener más información sobre la configuración de integraciones, consulte Invocar al DevOps agente a través de Webhook.
Para crear un activador de eventos:
Selecciona el botón + (crear).
Para el tipo de desencadenante, selecciona Evento.
En Origen del evento, elija la integración cuyos eventos de webhook deben ejecutar el agente. Solo se muestran las integraciones con un webhook activo.
(Opcional) En la expresión de filtro, introduce una expresión de JMEspath para filtrar y, si lo deseas, transformar la carga útil del evento.
Seleccione Crear.
Si no aparece ninguna fuente de eventos, significa que no existe ninguna integración habilitada para webhooks en el espacio de agentes o que tu rol carece de los permisos y. ListAssociations ListWebhooks
Expresiones de filtro:
Si lo desea, puede especificar una expresión de filtro de JMEspath para controlar qué eventos inician el agente y qué contexto recibe el agente. Las expresiones de filtro se evalúan comparándolas con la raíz de carga útil de eventos sin procesar.
Sintaxis: especificación JMEpath
Longitud máxima: 4.096 caracteres
Validación: las expresiones no válidas se rechazan al crear el desencadenador
La expresión de filtro actúa como condición y, opcionalmente, como proyección:
Cuando el resultado no
nulles una cadena vacía, una matriz vacía o un objeto vacío, el desencadenador se ejecuta.falseCuando el resultado es un valor booleano
true(por ejemplo, un predicado similarseverity == 'critical'), el agente recibe la carga útil del evento sin procesar como contexto.Cuando el resultado es cualquier otro valor verdadero (por ejemplo, una proyección similar a la de una proyección
{sev: severity}), el agente recibe el resultado proyectado como contexto.
AWS DevOps El agente trunca este contexto en 10 000 caracteres.
Si deja la expresión del filtro vacía, el agente se ejecuta en todos los eventos de esa fuente y recibe la carga útil del evento sin procesar como contexto.
nota
Una proyección que dé como resultado un objeto vacío o una matriz vacía se considera que no coincide y el agente no se ejecuta. Para pasar un valor que pueda estar vacío, envuélvalo en un objeto literal. Por ejemplo, {payload: details}.
Ejemplos de expresiones de filtro:
severity == 'critical'— Predicado: ejecuta el agente solo cuando la gravedad es igual a crítica, pasando la carga útil del evento sin procesar como contexto.{sev: severity}— Proyección: ejecuta el agente en cada evento y pasa como contexto un objeto que contiene solo el campo de gravedad. Como un hash de selección múltiple siempre incluye sus claves, el resultado nunca está vacío y no se filtra.
Como la forma de la carga útil es diferente para cada fuente, los campos disponibles dependen de la integración. Cuando llega un evento pero el desencadenador no se ejecuta, el AWS DevOps agente emite un aviso explicando el motivo. Por ejemplo, el aviso puede indicar que la expresión del filtro no coincide con nada. El aviso también muestra los campos de nivel superior presentes en esa carga útil. Para obtener más información, consulte Registros y métricas de Vended.
Creación de desencadenadores mediante programación
También puede crear desencadenadores mediante programación mediante los SDK. AWS Llama a la CreateTrigger operación del devops-agent cliente, que requiere el permiso. aidevops:CreateTrigger Defina el tipo de desencadenador en TIME_BASED y proporcione una condición de programación que contenga la expresión de programación y la solicitud de usuario opcional.
Como alternativa, puede modelar los desencadenadores basados en la programación como AWS::DevOpsAgent::Trigger recursos en. AWS CloudFormation Un disparador 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, consulteAdministración de activos.
Administrar los desencadenantes
La pestaña Activadores muestra todos los activadores configurados para el agente personalizado. Un activador de programación muestra su expresión de programación. Un desencadenador de eventos muestra su origen de eventos y, si está establecido, su expresión de filtro. Ambos tipos muestran la fecha de creación.
Si se elimina la integración de origen o su webhook, un desencadenador de eventos permanece en la lista, pero muestra que el origen ya no está disponible y no se ejecuta.
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 ejecutarse hasta que se vuelva a activar. Vuelva a activar el botón para reanudar.
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
Puede cancelar una invocación en ejecución desde la vista de trayectoria de invocación o mediante Chat.
Para cancelar una invocación en ejecución desde la vista de trayectoria:
En la pestaña Historial, elige la invocación en ejecución.
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_logsdevuelve entradas de registro ouse_awsrespuestas 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.
