Rutinas en Foundry Agent Service (versión preliminar)

Las rutinas de Foundry Agent Service permiten ejecutar un agente automáticamente cuando se activa un desencadenante definido. Use una rutina cuando quiera una forma nativa del proyecto de decir: «Cuando llegue una hora concreta o se cumpla un horario determinado, invoque a este agente».

Sin rutinas, los equipos suelen crear esta capa de desencadenador mediante la combinación de tecnologías como programadores, Logic Apps, Azure Functions, colas, almacenamiento personalizado y código de autenticación. Las rutinas trasladan esa lógica operativa a Foundry para que el disparador, la acción, los permisos, las conexiones y el historial de ejecuciones se queden con el agente en el mismo proyecto de Foundry.

Use rutinas para la automatización ligera del agente, como resúmenes diarios, recordatorios únicos o comprobaciones periódicas. Si el escenario necesita bifurcación, varios agentes, pasos de aprobación humana o estado complejo, use un flujo de trabajo en su lugar.

Qué contiene una rutina

Una rutina tiene un desencadenador y una acción.

El modelo de un solo desencadenador y una acción mantiene las rutinas centradas en una sola pregunta: ¿cuándo se debe ejecutar este agente? No reemplaza la orquestación. Cuando necesite varias acciones, varios agentes o lógica condicional, cree un flujo de trabajo en su lugar. El agente que invoca una rutina puede implementar su propio flujo de trabajo interno mediante marcos como Microsoft Agent Framework o LangGraph.

Tipo de desencadenadores

Las rutinas admiten dos tipos de desencadenador en la versión preliminar: temporizador y periódico. El desencadenador periódico también se conoce como desencadenador recursivo.

Cómo se ejecutan las rutinas

Cuando una rutina está habilitada, Foundry administra automáticamente el disparador y la ruta de distribución.

1. El desencadenante se activa mediante un temporizador o una programación recurrente.
2. Foundry crea un registro de ejecución rutinario en el proyecto.
3. Foundry invoca el punto de conexión del agente configurado con la entrada rutinaria.
4. El agente procesa la solicitud mediante su modelo configurado, instrucciones, herramientas e identidad.
5. Foundry almacena el estado de ejecución rutinario y vincula la ejecución a los detalles de respuesta y seguimiento del agente.

Este flujo usa la ruta de invocación del agente existente, por lo que las rutinas no introducen un entorno de ejecución independiente para la lógica del agente. El agente sigue usando las mismas características de configuración, herramientas y observabilidad que usa cuando se invoca desde una aplicación o área de juegos.

Conexiones, identidades y gobernanza

Las rutinas están restringidas al ámbito de un proyecto de Foundry. Las rutinas se administran con el mismo modelo de gobernanza de proyectos que se usa para agentes, herramientas y conexiones. Para obtener más información, consulte control de acceso basado en roles de Azure en Foundry.

Este diseño con ámbito de proyecto proporciona las siguientes ventajas:

• Ningún recurso de programador independiente para administrar: cree y opere rutinas de Foundry en lugar de aprovisionar una infraestructura de automatización independiente.
• Gobernanza compartida: aplique el control de acceso de nivel de proyecto a la administración rutinaria y a la invocación del agente.
• Ejecuciones observables: revise las ejecuciones de rutinas junto con las respuestas del agente y las trazas que estas generan.

No incluya secretos, credenciales ni tokens de acceso personal en solicitudes o entradas rutinarias. Use conexiones de proyecto y acceso basado en Microsoft Entra ID siempre que se admita.

Monitorizar y ejecutar rutinas

Después de crear una rutina, use el historial de ejecución para comprender lo que ha ocurrido cada vez que se desencadene el desencadenador. El historial de ejecución le ayuda a responder a preguntas operativas como:

• ¿Se activó el disparador?
• ¿Qué entrada se envió al agente?
• ¿Se ha completado o la fallado la invocación del agente?
• ¿Qué respuesta produjo el agente?
• ¿Qué traza contiene la información detallada sobre el modelo, la herramienta y la latencia de esa invocación?

Para pausar una rutina, deshabilítela y, para reanudarla, vuelva a habilitarla. También puede actualizar el desencadenador, la acción o la entrada de una rutina existente sin volver a crear el agente.

Rutinas y flujos de trabajo

Las rutinas y los flujos de trabajo ayudan a automatizar escenarios de agente, pero resuelven diferentes problemas.

Use una rutina en primer lugar cuando la automatización es simplemente "ejecutar este agente cuando sucede algo". Vaya a los flujos de trabajo cuando la automatización necesite lógica de coordinación más allá de una invocación de agente única.

Limitaciones de la versión preliminar

La versión preliminar tiene las siguientes limitaciones:

• Una rutina tiene exactamente un desencadenador y una acción.
• El único tipo de acción es invocar a un agente de Foundry.
• Los tipos de desencadenador admitidos son temporizadores y desencadenadores periódicos.

Contenido relacionado

• Ciclo de vida de desarrollo del agente
• Creación de un flujo de trabajo en Microsoft Foundry
• Automatización de agentes con rutinas
• Seguimiento de agentes en Microsoft Foundry