💪🏻

Microsoft Agent Framework を 理解するための道のり

に公開
2026/01/11

概要

Microsoft Agent Framework(以下MAF)とは何か、という部分の話は公式の説明や他のレスポンスの早かったブロガーに任せて、これはわかった上で使いたいというMAFの重要なポイントをまとめて共有したいと思ったのでまとめシリーズを始めようと思います。
途中で飽きたり他のもっと良いフレームワークが出てきたりで中途半端になる可能性があります。(個人的にMAFをかなり推しているので、後者に関してはなかなかないんじゃないかと思っています)

Microsoft Agent Frameworkを使う上で気を付けたいこと

  • 2025/12現在、まだPublic Preview段階
    • 色々使っているとバージョン違いで書いていたコードが動かなくなる、packageのバージョン違いで一部ライブラリだけコード以前の問題で動かなくなる、ということがテスト中に発生しています
  • 必要なものが大体揃っている可能性
    • これ作らなきゃ、で作ったものが実は元々MAFにある、ということが起こります
    • 賢い人が作っているので自分が思い付くような機能は全部あるのでは?という疑いの目で見ましょう
    • 自分で実装するより、ライブラリの実装を理解して使いこなす方が実装もコードの維持・管理も楽になるはずです、というかMAFはそのためのライブラリです

書きたい(書いた)こと

無限に機能があるので今これを書きながらあれもこれも……となっています。執筆順は適当、項目が増える可能性もあります。各項目が書き終わったら更新していきます。

  • coreモジュール
  • ワークフロー・エージェント・エグゼキューターとエッジ
    • それぞれの役割
    • 相互接続・変換
  • エージェント
  • エグゼキューター
    • エグゼキューターの入出力設計
  • ワークフロー
    • ワークフローの作り方の基本, as_agent
    • 代表的なエージェンティックワークフローのビルダー
  • ヒューマンインザループ
    • すごく簡単にHITLが追加できる
    • 各ワークフローでの簡単なHITLの追加
  • 会話履歴・チェックポイント
    • 細かい制御が思ったより簡単じゃないかも
  • ミドルウェア
    • 上で言った細かい制御のためのやつ
    • エージェントの実行、関数呼び出し、チャットのやり取りなど、さまざまな実行段階での動作を傍受・修正のためのミドルウェアが用意されているがまだ使いこなせていない
  • DevUI 可視化・テストツール
    • DevUIがテストツールとしてめちゃくちゃ優秀な件
      • 前述のFunction Toolの記事で利用しています
  • エージェンティック検索
  • ag-ui (Agentic UI)
    • 「LLM/エージェントが会話文だけでなく、UIの状態・表示・進行状況までをイベントとして生成/更新し、ユーザーが途中介入できる」ようにしたUI設計パターン
    • Agentic UIのためのエージェント等のFastAPI化が関数1つで出来てすごい
  • a2a
    • A2Aプロトコル準拠のクライアントをMAFのエージェントに出来る
  • declearative
    • yamlからエージェントビルドが出来る。動的なエージェント作成や、社内でWebアプリからポチポチするだけでエージェント作れるアプリとか作りたかったらこれか
  • mem0, redis
    • エージェントに永続的なメモリ機能を提供し、異なるセッションやスレッド間でユーザーの好みや会話コンテキストを記憶できる

意気込み

年末年始、やるぞー

ヘッドウォータース

Discussion