microsoft-agent-framework

Microsoft Agent Framework

Microsoft Agent Framework を基盤とするアプリケーション、エージェント、ワークフロー、または移行に取り組む際は、このスキルを使用してください。

Microsoft Agent Framework は Semantic Kernel と AutoGen の統合された後継であり、それぞれの強みと新機能を組み合わせています。まだパブリックプレビュー段階で頻繁に変更されるため、実装に関するアドバイスは、古い知識に頼るのではなく、常に最新の公式ドキュメントとサンプルに基づいて行ってください。

まず対象言語を特定する

推奨やコード変更を行う前に、言語に応じたワークフローを選択してください。

1. リポジトリに .cs、.csproj、.sln、.slnx、またはその他の .NET プロジェクトファイルが含まれている場合、あるいはユーザーが C# または .NET に関するガイダンスを明示的に求めている場合は、.NET ワークフローを使用してください。references/dotnet.md に従ってください。
2. リポジトリに .py、pyproject.toml、requirements.txt が含まれている場合、またはユーザーが Python に関するガイダンスを明示的に求めている場合は、Python ワークフローを使用してください。references/python.md に従ってください。
3. リポジトリに両方のエコシステムが含まれている場合は、編集対象のファイルで使用されている言語、またはユーザーが指定した対象に合わせてください。
4. 言語が不明確な場合は、まず現在のワークスペースを調べてから、最も適切な言語別リファレンスを選択してください。

常に最新のドキュメントを確認する

• まず Microsoft Agent Framework の概要を読んでください：https://learn.microsoft.com/agent-framework/overview/agent-framework-overview
• 現在の API の仕様については、公式ドキュメントとサンプルを優先してください。
• 利用可能な場合は、Microsoft Docs MCP ツールを使用して、最新のフレームワークのガイダンスやサンプルを取得してください。
• 古い Semantic Kernel または AutoGen のパターンは移行の入力として扱い、デフォルトの実装モデルとして使用しないでください。

共通ガイダンス

どの言語で Microsoft Agent Framework を使用する場合も、以下に従ってください。

• エージェントやワークフローの操作には、非同期パターンを使用してください。
• 明示的なエラー処理とログ記録を実装してください。
• 強い型付け、明確なインターフェイス、保守しやすい合成パターンを優先してください。
• Azure 認証が適切な場合は、DefaultAzureCredential を使用してください。
• 自律的な意思決定、アドホックな計画、会話フロー、ツールの使用、MCP サーバーとのやり取りにはエージェントを使用してください。
• 複数ステップのオーケストレーション、事前定義された実行グラフ、長時間実行タスク、Human-in-the-loop のシナリオにはワークフローを使用してください。
• Azure AI Foundry、Azure OpenAI、OpenAI などのモデルプロバイダーをサポートしますが、ユーザーのニーズに合う新規プロジェクトでは Azure AI Foundry サービスを優先してください。
• 問題に適している場合は、スレッドベースまたは同等の状態管理、コンテキストプロバイダー、ミドルウェア、チェックポイント、ルーティング、オーケストレーションのパターンを使用してください。

移行ガイダンス

• Semantic Kernel から移行する場合は、公式の移行ガイドを使用してください：https://learn.microsoft.com/agent-framework/migration-guide/from-semantic-kernel/
• AutoGen から移行する場合は、公式の移行ガイドを使用してください：https://learn.microsoft.com/agent-framework/migration-guide/from-autogen/
• まず動作を維持し、その後、ネイティブな Agent Framework のパターンを段階的に採用してください。

ワークフロー

1. 対象言語を特定し、対応するリファレンスファイルを読んでください。
2. 実装方針を決める前に、最新の公式ドキュメントとサンプルを取得してください。
3. このスキルの共通エージェントおよびワークフローのガイダンスを適用してください。
4. 選択したリファレンスに記載された言語別のパッケージ、リポジトリ、サンプルのパス、コーディング慣習を使用してください。
5. リポジトリ内のサンプルが最新のドキュメントと異なる場合は、その違いを説明し、現在サポートされているパターンに従ってください。

リファレンス

• .NET リファレンス
• Python リファレンス

完了条件

• 推奨事項が対象言語に適合していること。
• パッケージ名、リポジトリのパス、サンプルの場所が、選択したエコシステムと一致していること。
• ガイダンスがレガシーな前提ではなく、Microsoft Agent Framework の最新ドキュメントを反映していること。
• 移行に関するアドバイスでは、関連する場合に限り Semantic Kernel と AutoGen に言及していること。