Usare l'orchestrazione Magentic

L'orchestrazione magentica è un modello flessibile multi-agente per utilizzo generico progettato per attività complesse e aperte che richiedono la collaborazione dinamica. Questo modello usa un responsabile Magentic dedicato per coordinare un team di agenti specializzati. Il responsabile decide quale agente deve agire successivamente in base al contesto in evoluzione, allo stato delle attività e alle funzionalità dell'agente.

Il manager Magentic gestisce un contesto condiviso, tiene traccia dello stato di avanzamento e adatta il flusso di lavoro in tempo reale. Questo approccio consente al sistema di suddividere i problemi complessi, assegnare sottoattività e perfezionare in modo iterativo le soluzioni. Il processo si concentra tanto sulla costruzione e documentazione dell'approccio quanto sulla consegna della soluzione finale. Un libro mastro dinamico delle attività viene compilato e perfezionato man mano che il flusso di lavoro avanza, registra gli obiettivi, i sottogoal e i piani di esecuzione.

Quando usare l'orchestrazione Magentic

Prendere in considerazione l'uso del modello di orchestrazione Magentic in questi scenari:

• Il problema è complesso o aperto senza percorso di soluzione predeterminato.
• L'input e il feedback di più agenti specializzati sono necessari per modellare una soluzione valida.
• Il sistema deve generare un piano di approccio documentato per la revisione umana.
• Gli agenti dispongono di strumenti che possono interagire direttamente con sistemi e risorse esterni.
• Un piano di esecuzione compilato in modo dinamico aggiunge valore prima di eseguire le attività.

Quando evitare l'orchestrazione magnetica

È consigliabile evitare questo modello quando:

• Il percorso della soluzione è fisso o deterministico.
• Non è necessario produrre un libro mastro o un piano d'approccio.
• L'attività è abbastanza semplice da permettere l'uso di un pattern di orchestrazione più leggero.
• La velocità è la priorità, perché questo metodo enfatizza la pianificazione rispetto all'esecuzione rapida.
• Si prevedono blocchi o cicli frequenti senza un percorso di risoluzione chiaro.

Implementazione dell'orchestrazione magentica

Implementare il modello di orchestrazione Magentic con Microsoft Agent Framework:

1. Definire agenti specializzati
   Creare istanze dell'agente (ad esempio, ChatAgent) con istruzioni specifiche e client di chat. Ogni agente deve avere un ruolo e funzionalità specializzati adatti a diversi aspetti dell'attività complessa.

2. Configurare il callback per la gestione degli eventi
   Definire una funzione di callback asincrona per gestire diversi tipi di eventi durante l'orchestrazione, inclusi messaggi dell'orchestratore, aggiornamenti in streaming degli agenti, messaggi dell'agente e risultati finali.

3. Creare il flusso di lavoro Magentic
   Usare la MagenticBuilder classe per creare l'orchestrazione. Aggiungere le istanze dell'agente come partecipanti, configurare il callback di evento con la modalità streaming e configurare il gestore standard con i parametri appropriati, ad esempio il numero massimo di round e i limiti di stallo.

4. Configurare il gestore standard
   Il manager standard coordina la collaborazione degli agenti usando un client di chat per la pianificazione e il rilevamento dello stato. Configurare parametri come il numero massimo di round, il numero di stalli massime e il numero di ripristini per controllare il comportamento dell'orchestrazione.

5. Eseguire il flusso di lavoro
   Chiamare il metodo run_stream del flusso di lavoro con l'attività complessa. Il flusso di lavoro pianifica in modo dinamico, delega il lavoro agli agenti appropriati e coordina la collaborazione per risolvere il problema.

6. Eventi del workflow di processo
   Scorrere gli eventi del flusso di lavoro usando un ciclo asincrono. Gestire diversi tipi di eventi, tra cui WorkflowOutputEvent, che contiene i risultati finali dell'orchestrazione.

7. Estrarre il risultato finale
   Raccogliere l'output finale dagli eventi del flusso di lavoro. Il risultato contiene la soluzione completa sviluppata attraverso lo sforzo collaborativo di tutti gli agenti partecipanti.

L'orchestrazione magentica eccelle nella risoluzione di problemi complessi e in evoluzione che richiedono un coordinamento in tempo reale tra agenti specializzati. È ideale per le attività in cui il piano non può essere definito in anticipo e deve adattarsi man mano che emergono nuove informazioni. Usando Microsoft Agent Framework, è possibile creare sistemi che progettano, affinano ed eseguono in modo dinamico i percorsi delle soluzioni tramite la collaborazione degli agenti intelligenti.