マゼンティック オーケストレーションを使用する

マゼンティック オーケストレーション は、動的なコラボレーションを必要とする複雑で自由なタスク用に設計された、柔軟で汎用のマルチエージェント パターンです。 このパターンでは、専用のマゼンティック マネージャーを使用して、専門エージェントのチームを調整します。 マネージャーは、進化するコンテキスト、タスクの進行状況、およびエージェントの機能に基づいて、次にアクションを実行するエージェントを決定します。

Magentic マネージャーは、共有コンテキストを維持し、進行状況を追跡し、ワークフローをリアルタイムで調整します。 このアプローチにより、システムは複雑な問題を分割し、サブタスクを割り当て、ソリューションを繰り返し調整できます。 このプロセスでは、最終的なソリューションの提供と同じように、アプローチの構築と文書化に重点を置いています。 動的なタスク台帳は、ワークフローの進行、目標、サブゴール、実行計画の記録に合って構築および調整されます。

マゼンティック オーケストレーションを使用する場合

次のシナリオでは、マゼンティック オーケストレーション パターンの使用を検討してください。

• この問題は、事前に定義されたソリューション パスを持たない複雑またはオープンエンドです。
• 有効なソリューションを形成するには、複数の特殊なエージェントからの入力とフィードバックが必要です。
• システムは、人間のレビューのための文書化されたアプローチ計画を生成する必要があります。
• エージェントには、外部システムやリソースと直接やり取りできるツールがあります。
• ステップ バイ ステップの動的に構築された実行プランは、タスクを実行する前に価値を追加します。

マゼンティック オーケストレーションを回避するタイミング

このパターンは、次の場合に回避できます。

• ソリューション パスは固定または確定的です。
• 台帳やアプローチの計画を作成する必要はありません。
• このタスクは、より軽量なオーケストレーション パターンに十分にシンプルです。
• この方法では高速実行の計画が重視されるため、速度が優先されます。
• 解決パスが明確でなくても、頻繁にストールまたはループが発生する可能性があります。

マゼンティック オーケストレーションの実装

Microsoft Agent Framework を使用して、マゼンティック オーケストレーション パターンを実装します。

1. 特殊なエージェントを定義する
   特定の指示とチャット クライアントを使用してエージェント インスタンス ( ChatAgent など) を作成します。 各エージェントには、複雑なタスクのさまざまな側面に適した特殊な役割と機能が必要です。

2. イベント処理コールバックを設定する
   オーケストレーター メッセージ、エージェント ストリーミングの更新、エージェント メッセージ、最終結果など、オーケストレーション中にさまざまな種類のイベントを処理する非同期コールバック関数を定義します。

3. マゼンティック ワークフローを構築する
   オーケストレーションを作成するには、 MagenticBuilder クラスを使用します。 エージェント インスタンスを参加者として追加し、ストリーミング モードでイベント コールバックを構成し、最大ラウンド数やストール制限などの適切なパラメーターを使用して標準マネージャーを設定します。

4. 標準マネージャーを構成する
   標準マネージャーは、計画と進行状況の追跡のためにチャット クライアントを使用してエージェントのコラボレーションを調整します。 最大ラウンド数、ストール数、リセット数などのパラメーターを構成して、オーケストレーションの動作を制御します。

5. ワークフローを実行する
   複雑なタスクでワークフローの run_stream メソッドを呼び出します。 ワークフローは動的に計画し、適切なエージェントに作業を委任し、問題を解決するためにコラボレーションを調整します。

6. ワークフロー イベントを処理する
   非同期ループを使用してワークフロー イベントを反復処理します。 オーケストレーションの最終的な結果を含む WorkflowOutputEventなど、さまざまなイベントの種類を処理します。

7. 最終的な結果を抽出する
   ワークフロー イベントから最終的な出力を収集します。 結果には、すべての参加エージェントの共同作業によって開発された完全なソリューションが含まれます。

マゼンティック オーケストレーションは、特殊なエージェント間のリアルタイムの調整を必要とする複雑で進化する問題の解決に優れています。 これは、計画を事前に定義できないため、新しい情報が出現するにつれて適応する必要があるタスクに最適です。 Microsoft Agent Framework を使用すると、インテリジェントなエージェント コラボレーションを通じてソリューション パスを動的に設計、調整、実行するシステムを構築できます。