Utilizar la orquestación magnética

La orquestación magnética es un patrón de múltiples agentes flexible y de uso general diseñado para tareas complejas y abiertas que requieren colaboración dinámica. Este patrón utiliza un gestor magnético dedicado para coordinar un equipo de agentes especializados. El administrador decide qué agente debe actuar a continuación en función del contexto en evolución, el progreso de la tarea y las funcionalidades del agente.

El administrador de Magentic mantiene un contexto compartido, realiza un seguimiento del progreso y adapta el flujo de trabajo en tiempo real. Este enfoque permite al sistema desglosar problemas complejos, asignar subtareas y refinar soluciones de forma iterativa. El proceso se centra tanto en la creación y documentación del enfoque como en la entrega de la solución final. Un libro de contabilidad de tareas dinámico se crea y refina a medida que avanza el flujo de trabajo, registra objetivos, subgoales y planes de ejecución.

Cuándo usar la orquestación magnética

Considere la posibilidad de usar el patrón de orquestación magnético en estos escenarios:

• El problema es complejo o indeterminado, sin un camino predeterminado para la solución.
• La entrada y los comentarios de varios agentes especializados son necesarios para dar forma a una solución válida.
• El sistema debe generar un plan de enfoque documentado para la revisión humana.
• Los agentes tienen herramientas que pueden interactuar directamente con sistemas y recursos externos.
• Un plan de ejecución compilado de forma paso a paso agrega valor antes de ejecutar las tareas.

Cuándo evitar la orquestación magnética

Es posible que quiera evitar este patrón cuando:

• La ruta de acceso de la solución es fija o determinista.
• No es necesario generar un libro de contabilidad o un plan de enfoque.
• La tarea es lo suficientemente sencilla como para un patrón de orquestación más ligero.
• La velocidad es la prioridad, ya que este método enfatiza la planificación sobre la ejecución rápida.
• Se esperan bloqueos o bucles frecuentes sin una ruta de acceso de resolución clara.

Implementación de la Orquestación Magnética

Implemente el patrón de orquestación magnético con el Microsoft Agent Framework.

1. Definición de agentes especializados
   Cree instancias de agente (por ejemplo, ChatAgent) con instrucciones específicas y clientes de chat. Cada agente debe tener un rol y funcionalidades especializados adecuados para distintos aspectos de la tarea compleja.

2. Configuración de la devolución de llamada de control de eventos
   Defina una función de devolución de llamada asincrónica para controlar diferentes tipos de eventos durante la orquestación, incluidos los mensajes de orquestador, las actualizaciones de streaming del agente, los mensajes del agente y los resultados finales.

3. Crear el flujo de trabajo Magentic
   Use la MagenticBuilder clase para crear la orquestación. Agregue las instancias del agente como participantes, configure el callback de eventos con el modo de streaming y configure el gestor estándar con los parámetros adecuados, como el conteo máximo de rondas y los límites de inactividad.

4. Configuración del administrador estándar
   El administrador estándar coordina la colaboración del agente mediante un cliente de chat para planear y realizar el seguimiento del progreso. Configure parámetros como el número máximo de rondas, el recuento de puestos y el recuento de restablecimiento para controlar el comportamiento de la orquestación.

5. Ejecución del flujo de trabajo
   Llame al método del flujo de trabajo run_stream con la tarea compleja. El flujo de trabajo planea dinámicamente, los delegados trabajan con los agentes adecuados y coordina su colaboración para resolver el problema.

6. Procesar eventos de flujo de trabajo
   Recorrer en iteración los eventos de flujo de trabajo mediante un bucle asincrónico. Controle diferentes tipos de eventos, incluidos WorkflowOutputEvent, que contiene los resultados finales de la orquestación.

7. Extracción del resultado final
   Recopile la salida final de los eventos de flujo de trabajo. El resultado contiene la solución completa desarrollada a través del esfuerzo colaborativo de todos los agentes participantes.

La orquestación magnética destaca en la resolución de problemas complejos y en evolución que requieren la coordinación en tiempo real de agentes especializados. Es ideal para las tareas en las que el plan no se puede definir de antemano y debe adaptarse a medida que surge nueva información. Con Microsoft Agent Framework, puede crear sistemas que diseñan, refinan y ejecutan rutas de solución dinámicamente a través de la colaboración inteligente del agente.