AIエージェントの構築・連携・実行をまるごとカバー！Python＆.NET対応のマルチエージェント基盤 — agent-framework

アーキテクチャ・仕組み

• グラフベースワークフロー: エージェントと確定的な関数をデータフローで接続し、ストリーミング、チェックポイント（途中保存）、ヒューマン・イン・ザ・ループ（人間の介入）、タイムトラベル（過去の状態に戻る）機能を提供
• ミドルウェアシステム: リクエスト/レスポンスの処理パイプラインをカスタマイズ可能。例外処理やカスタムパイプラインの構築にも対応
• オブザーバビリティ（監視）: OpenTelemetryを統合した分散トレーシング・モニタリング・デバッグ機能を標準搭載

対応環境・プラットフォーム

• 言語: Python / C#(.NET)
• AIモデル提供元: Azure OpenAI、OpenAI、Microsoft Foundry（Azure AI Projects）など複数に対応。今後も追加予定
• ホスティング: A2A（Agent-to-Agent）、Azure Functions、Durable Task、Durable Agents/Workflowsに対応
• 認証: Azure CLI（az login）、DefaultAzureCredential、ManagedIdentityCredential、OpenAI APIキーなど

主要な機能一覧

• 単純なチャットエージェントの構築
• マルチエージェントのオーケストレーション（複数のエージェントを協調動作させる仕組み）
• グラフベースのワークフロー設計
• ストリーミング応答
• チェックポイントとタイムトラベル
• ヒューマン・イン・ザ・ループ
• ツール呼び出し（エージェントが外部関数を実行する機能）
• DevUI（開発者向けインタラクティブUI）でのテスト・デバッグ
• OpenTelemetryによる分散トレーシング
• ミドルウェアによるカスタムパイプライン
• AF Labs（実験的パッケージ）: ベンチマーク、強化学習、研究イニシアチブ

競合・類似ツールとの違い

• Semantic Kernel / AutoGen からの移行ガイドが公式に提供されており、Microsoftのエージェント開発の統合基盤として位置づけられている
• Python と .NET の両方で一貫したAPIを提供する点が他のフレームワーク（LangChain等はPython中心）との大きな差別化ポイント

環境変数（主要な設定項目）

制約・注意点

• サードパーティのサーバーやエージェントと連携する場合、データの共有・保管場所・コンプライアンス境界について利用者自身が管理する責任がある
• 本番環境では DefaultAzureCredential の代わりに ManagedIdentityCredential など特定の認証方式の使用が推奨される（レイテンシやセキュリティリスク回避のため）
• .NETパッケージの一部はプレリリース版（--prereleaseフラグが必要）

ドキュメント・コミュニティ

• MS Learn上に包括的なドキュメント（概要、クイックスタート、チュートリアル、ユーザーガイド）を提供
• Discordチャンネルと毎週のオフィスアワーでコミュニティサポートあり
• サンプルコードが段階的に用意（入門→エージェント概念→ワークフロー→ホスティング→エンドツーエンド）

Python

pip install agent-framework
# すべてのサブパッケージがインストールされます
# Windows環境では初回インストールに少し時間がかかる場合があります

.NET

dotnet add package Microsoft.Agents.AI

Python クイックスタート（Azure利用）

import asyncio
from agent_framework import Agent
from agent_framework.foundry import FoundryChatClient
from azure.identity import AzureCliCredential

async def main():
    agent = Agent(
      client=FoundryChatClient(credential=AzureCliCredential()),
      name="HaikuBot",
      instructions="You are an upbeat assistant that writes beautifully.",
    )
    print(await agent.run("Write a haiku about Microsoft Agent Framework."))

asyncio.run(main())

事前に az login でAzure CLIへの認証が必要です。