1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

はじめに

Microsoft Agent Framework は、AIエージェントを構築するためのMicrosoft製オープンソースSDKです。

対象は、そのPython向け実装である Agent Framework for Python です。
python-1.0.0 が 2026-04-02 にリリースされ、その後 2026-10-02 には python-1.20.0 に達しています。
短期間に多くの機能が追加され、破壊的変更も複数回含まれています。

python-1.0.0 から python-1.20.0 までのリリースを追い、細かなバグ修正ではなく、利用者に影響する使い勝手と移行時の注意点を整理します。

全差分を均等に追うより、利用している領域に破壊的変更があるかを優先して確認する方が効率的です。

利用機能 重点的に見るバージョン 理由
Checkpoint永続化 python-1.0.1 , python-1.1.0 制限付きデシリアライズに変わり、保存内容によっては修正が必要
Workflow / Orchestration python-1.2.2 終端出力が AgentResponse に統一された
Skills / MCP / HarnessAgent python-1.3.0 , python-1.8.0 〜 python-1.20.0 破壊的変更と機能追加が集中。1.20.0ではapprovalとMCP runtime contextを厳格化し、解決できないapproval bindingやagent-tool approvalを拒否する。approval利用者はsessionと権限設定を確認する
Foundry Hosted Agent python-1.1.0 , python-1.7.0 , python-1.10.0 , python-1.12.0 〜 python-1.20.0 Hosted Agent V2、session helper、protocol upgrade、Foundry hosting packageのbeta昇格に加え、1.20.0ではrequest-scoped agent factory、永続的でsandbox分離されたsession、Invocations runを軸にhosting APIが再設計された
DevUI / A2A / AG-UI / Declarative python-1.4.0 , python-1.7.0 , python-1.9.0 , python-1.11.0 〜 python-1.20.0 アクセス制御、SDK v1.0移行、AG-UI変更・stable昇格、A2A helper追加、Declarative stable昇格に加え、1.20.0ではAG-UIの切断runを永続化し、Declarative workflowのstate属性参照などをexperimental breakingとして変更した
Durable Task hosting python-1.10.0 〜 python-1.14.0 worker、multi-workflow・sub-workflow、workflow内HITLのresponse URL対応に加え、1.14.0で別リポジトリのDurable Agent Framework extensionへ移管された
本番運用・観測性 python-1.6.0 , python-1.8.1 , python-1.10.0 , python-1.12.0 〜 python-1.20.0 instrumentationやOTel関連に加え、tool spanやsession snapshotの修正、機能利用テレメトリ、Mistralのprompt cache usage保持、1.15.0のOTel GenAI semantic convention設定変更、1.16.0のservice metadata・resource attribute・OTLP exporterのプログラム設定、1.17.0のtool-loop compaction・観測性の整合、1.20.0のFoundry trace propagationとResponses streamの制御を確認する

この記事は 2026-10-02 時点で確認した情報をもとにしています。
対象はAgent Framework全体のPython向け正式版リリース python-1.0.0 〜 python-1.20.0 です。

Microsoft Agent Frameworkとは

公式READMEによると、Microsoft Agent Frameworkは、本番運用を想定したAIエージェントとマルチエージェントワークフローを構築するための、オープンなマルチ言語フレームワークと説明されています。PythonとC#/.NETの両方をサポートし、プロトタイプから本番運用まで一貫して扱うことを目的としています。

Python版でも、単一のプロンプトやステートレスなチャットを超えて、Agentの構築・オーケストレーション・運用を同じ基盤で扱えます。主な特徴は次のとおりです。

  • Microsoft Foundry、Azure OpenAI、OpenAI、GitHub Copilot SDKなど複数のProviderに対応
  • sequential、concurrent、handoff、group collaborationなどのWorkflow patternをサポート
  • checkpoint、streaming、human-in-the-loop、time-travelのWorkflowへの組み込み
  • middlewareによるrequest / response処理、例外処理、独自pipelineの追加
  • OpenTelemetryによる分散trace、監視、debuggingの統合
  • Foundry Hosted AgentsやA2A、Azure Functions、Durable Taskなどのhosting patternの選択肢
  • YAMLで定義するDeclarative Agent、Agent Skills、開発・テスト用DevUIの提供

Providerやhosting先を固定せず、要件の変化に合わせて柔軟に構成を選択できる点も、公式READMEで示されている設計上の特徴です。

インストール方法

新規に導入する場合は、特定の互換性要件がなければ、バージョンを指定せずに最新版をインストールすることを推奨します。

pip install agent-framework

既存プロジェクトとの互換性確認や再現性のためにバージョンを固定する場合は、対象が比較的最近の版か、古い版かで指定方法を分けます。

比較的最近の版を固定する

2026-10-02時点では、1.11.0 から 1.20.0 はumbrella packageの agent-framework のバージョン固定で依存関係を解決してインストールできます。

pip install "agent-framework==1.20.0"

別の最近の版を確認したい場合は、1.20.0 の部分を対象バージョンに置き換えます。

古い版を固定する

1.0.0 から 1.10.0 を使う場合は、umbrella packageの agent-framework ではなく、必要な個別パッケージのみを同一バージョンに揃えて固定します。
例えばOpenAIのみを利用する場合、1.5.0 では以下の指定によりクリーン環境で依存関係を解決してインストールできます。

pip install \
  "agent-framework-core==1.5.0" \
  "agent-framework-openai==1.5.0"

Foundryを使う場合は、agent-framework-foundry==1.5.0 も同時に指定します。

pip install \
  "agent-framework-core==1.5.0" \
  "agent-framework-foundry==1.5.0"

古いバージョンを agent-framework==... で固定すると、依存解決に失敗します。

2026-08-07にクリーンなPython 3.10環境で確認したところ、agent-framework==1.0.0 から 1.10.0 はすべて ResolutionImpossible になりました。

古い agent-framework は agent-framework-core[all] を同じ版へ固定しますが、all extra に含まれる個別統合パッケージの一部はバージョン未固定です。
例えば現在公開されている agent-framework-ag-ui は agent-framework-core>=1.11.0 を要求するため、agent-framework-core==1.0.0 から 1.10.0 と衝突します。

例えば agent-framework==1.5.0 を指定すると、次のように依存解決に失敗します。

$ pip install "agent-framework==1.5.0"
ERROR: Cannot install agent-framework-core, agent-framework-core[all]==1.5.0 and agent-framework==1.5.0 because these package versions have conflicting dependencies.

ERROR: ResolutionImpossible: for help visit https://pip.pypa.io/en/latest/topics/dependency-resolution/#dealing-with-dependency-conflicts

pipの依存関係リゾルバーと実行時点のパッケージ公開状況によって、衝突として表示される個別パッケージや詳細な文面は変わります。

必要な統合パッケージとバージョンの組み合わせは、既存環境の影響を避けるため、対象版ごとに新しいクリーンな仮想環境で確認してください。
--no-deps で依存関係リゾルバーを迂回しても、実行時に整合しない組み合わせが残るため、回避策にはなりません。

リリース全体を俯瞰する

まず、各リリースを「移行コスト」と「導入メリット」で並べると次のようになります。

ここでのスコアは厳密な評価ではなく、リリースノートを読むための目安です。
ただし客観性を持たせるため、以下の式により機械的に算出しました。

移行コスト = BREAKING項目数 * 3 + Changed項目数 + 差分コミット数 / 20
導入メリット = Added項目数 * 2 + Fixed項目数 * 0.7 + 主要機能ボーナス

X座標 = 移行コスト / 最大移行コスト * 0.9
Y座標 = 導入メリット / 最大導入メリット * 0.9

主要機能ボーナスは、Provider追加、Hosted Agent、Skills、MCP、HarnessAgent、評価・観測性・安全性など、利用者の選択肢を広げる変更に 0 〜 2 点を付けています。
ここでの差分コミット数は、GitHub Releasesの比較リンクで確認できるリリース間のコミット数を指します。

全リリースの算出根拠

Added、Changed、Fixedは各見出し内の項目数、BREAKINGは見出しを問わず [BREAKING] と明記された項目数です。差分コミット数は、1.0.0 のみ直前の 1.0.0rc6、それ以降は直前の正式版タグとの比較から取得しました。

主要機能ボーナスは、安定化・安全性改善など特定用途への効果を 1、Provider・Workflow・hostingなど利用者の選択肢を大きく広げる変更を 2、該当しない場合を 0 としています。

Version Added Changed Fixed BREAKING Commits Bonus 移行コスト 導入メリット 座標
1.0.0 1 4 3 4 50 2 18.50 6.10 [0.37, 0.11]
1.0.1 2 9 5 1 35 1 13.75 8.50 [0.28, 0.15]
1.1.0 12 10 9 1 51 2 15.55 32.30 [0.31, 0.56]
1.1.1 4 3 6 0 21 1 4.05 13.20 [0.08, 0.23]
1.2.0 4 2 3 0 19 2 2.95 12.10 [0.06, 0.21]
1.2.1 2 15 1 0 22 1 16.10 5.70 [0.32, 0.10]
1.2.2 2 3 2 1 8 1 6.40 6.40 [0.13, 0.11]
1.3.0 16 2 6 1 59 2 7.95 38.20 [0.16, 0.66]
1.4.0 6 4 3 4 54 1 18.70 15.10 [0.38, 0.26]
1.5.0 2 3 4 0 24 0 4.20 6.80 [0.08, 0.12]
1.6.0 5 2 1 1 20 1 6.00 11.70 [0.12, 0.20]
1.7.0 5 5 10 1 35 2 9.75 19.00 [0.20, 0.33]
1.8.0 13 4 12 2 60 2 13.00 36.40 [0.26, 0.63]
1.8.1 2 3 7 0 29 1 4.45 9.90 [0.09, 0.17]
1.9.0 7 5 11 3 53 2 16.65 23.70 [0.34, 0.41]
1.10.0 11 11 9 7 126 2 38.30 30.30 [0.77, 0.52]
1.11.0 16 22 26 6 93 2 44.65 52.20 [0.90, 0.90]
1.12.0 10 23 23 4 85 2 39.25 38.10 [0.79, 0.66]
1.12.1 1 2 2 0 14 1 2.70 4.40 [0.05, 0.08]
1.13.0 8 4 27 1 71 2 10.55 36.90 [0.21, 0.64]
1.14.0 10 11 20 2 65 2 20.25 36.00 [0.41, 0.62]
1.15.0 5 8 11 1 72 2 14.60 19.70 [0.29, 0.34]
1.16.0 2 2 9 0 38 1 3.90 11.30 [0.08, 0.19]
1.17.0 2 4 16 1 36 2 8.80 17.20 [0.18, 0.30]
1.18.0 10 15 22 6 126 2 39.30 37.40 [0.79, 0.64]
1.19.0 8 14 21 4 153 2 33.65 32.70 [0.68, 0.56]
1.20.0 6 16 27 3 215 2 35.75 32.90 [0.72, 0.57]

座標は全リリース中の最大値で正規化し、表示上限を 0.9 として小数第2位へ丸めています。最大移行コストと最大導入メリットは、どちらも 1.11.0 です。

このスコアは、どのリリースを重点的に読むべきかを把握するための目安です。
実際に導入・アップデートする際は、利用している機能に関連するリリースノートと差分を必ず確認してください。

赤:メジャーリリース 青:マイナーリリース 緑:パッチリリース

本分析から見ると、python-1.3.0 と python-1.8.0 は移行コストに対して導入メリットが大きいリリースです。
一方、python-1.10.0 から python-1.12.0 は導入メリットも大きい反面、破壊的変更が多く、既存コードの移行には注意が必要です。

python-1.15.0 ではA2UI、Foundry Hosted Agentの回復機構、workflow checkpoint type registryが追加され、OpenTelemetry GenAI semantic conventionの設定も変更されました。python-1.16.0 はBREAKING項目なしで、OTel exporterのプログラム設定と、background agent・service-session継続時の制御を拡張しています。python-1.17.0 ではagent middleware入力の破壊的変更と、Foundryの履歴選択、approval・Responses replay保持、Provider SDK更新が同時に入りました。

python-1.18.0 は共有vector storeとtool loopの実行時間上限を追加する一方、SecretString、Lab依存関係、Copilot file hook、Foundry checkpoint復元に影響する変更を含みます。python-1.19.0 はvector storeとOrchestrationの選択肢を広げつつ、MCPとHTTP clientの状態管理について明示的な設定が必要となったリリースです。python-1.20.0 はFoundryのnative workflow hostingとvector store接続を拡張する一方、Foundry hostingとGemini Embeddingの移行を伴います。

後方互換性への影響度は、次のように整理できます。

Version 後方互換性リスク 理由
python-1.0.0 高 正式版化に伴い、RC互換APIや古い依存関係が整理された。
python-1.0.1 中 FileCheckpointStorage の制限付きデシリアライズにより、checkpointの保存内容によっては修正が必要。
python-1.1.0 中 CosmosCheckpointStorage も制限付きデシリアライズに変更された。
python-1.1.1 低 主に評価・UI連携・raw result扱いの改善。
python-1.2.0 低 Functional workflow APIなどの追加が中心。
python-1.2.1 低〜中 Changed項目は多いが、利用者への影響は主にサンプルと周辺環境にとどまる。
python-1.2.2 中 Orchestration終端出力の AgentResponse 標準化により、戻り値依存のコードに影響しうる。
python-1.3.0 中 experimental skills APIがmulti-source化され、Skills利用者は確認が必要。
python-1.4.0 高 Skills、DevUI、A2A関連で破壊的変更が集中している。
python-1.5.0 低 影響の大きい破壊的変更は少なく、MCP関連の安定化が中心。
python-1.6.0 中 instrumentation既定有効化により、運用時のログ・トレース・コストに影響しうる。
python-1.7.0 中 Declarative actionsやalias kindの変更がDeclarative利用者に影響。
python-1.8.0 高 GitHub Copilot SDK v1.0化やexperimental Skill APIのasync化など、重要な変更が含まれる。
python-1.8.1 低 MCPの観測性・安全性改善が中心。
python-1.9.0 高 MCP sampling、FileAccess tools、Declarative workflow周辺に影響がある。
python-1.10.0 高 Skills、FileAccess、FileMemory、HarnessAgent、Foundry Hosted Agent V2 protocol upgradeなどに破壊的変更が集中。
python-1.11.0 高 experimentalなSkills/FileAccess変更に加え、Durable Task hostingとAG-UIに通常の破壊的変更がある。
python-1.12.0 高 Responses hosting、AG-UI、Harness Agentに破壊的変更があり、FileAccessProviderの既定構成も変わる。
python-1.12.1 低 追加・修正とAG-UIのstable昇格が中心で、リリースノート上のBREAKING項目はない。
python-1.13.0 中 checkpointを初期入力とhuman-in-the-loop応答から完全にreplay可能にする破壊的変更があり、checkpoint利用者は復元・再実行の挙動を確認する必要がある。
python-1.14.0 高 Functional workflowはstateful workflow instanceへbuildしてから実行・Agent化する必要がある。Foundry Hosted AgentもAgent Server Responses 2.x storage modelへ移行する。
python-1.15.0 中 OpenTelemetry GenAI semantic conventionがstable / experimental modeと明示的なmessage event制御へ整理された。OTel設定と下流の分析・監視を見直す必要がある。
python-1.16.0 低 リリースノート上のBREAKING項目はない。OTel exporterのプログラム設定や、background agent、Foundry / AG-UIの継続実行を利用している場合に影響がある。
python-1.17.0 高 agent middleware入力のsequence-only回帰や agent-hooks core extraの削除があり、Foundry / Responses / AG-UIの継続実行やMistral連携に影響する。
python-1.18.0 高 SecretString の値オブジェクト化、Labの依存分離、Copilot file hookのopt-in化、Foundry checkpoint復元の制限など、広範な破壊的変更を含む。
python-1.19.0 高 HTTP cookie永続化の明示化、MCP archiveのZIP限定、MCP sessionの分離、Redis history storage keyの変更など、状態管理・セッション管理に影響する。
python-1.20.0 高 Foundry hostingがrequest-scoped agent factoryと永続sessionを軸に再設計される。Gemini Embedding設定は GOOGLE_* namespaceへ移り、Declarative workflowもexperimental breaking変更を含む。Foundry hosting、Gemini embedding、Declarative workflowの利用者は移行と回帰テストが必要。

リリース単位の細かな修正点を除くと、利用者視点では主に以下の動向が重要です。

観点 何が変わったか 主な該当バージョン
安定版化 RCから正式版へ昇格し、--pre なしで導入できる前提になった。一方でRC互換の古いAPIや依存関係は廃止された。 python-1.0.0
Checkpointの安全性 FileCheckpointStorage / CosmosCheckpointStorage のpickleデシリアライズが制限され、カスタム型を保存している場合は allowed_checkpoint_types の明示が必要になった。 python-1.0.1 , python-1.1.0
WorkflowをAgentとして使いやすく workflow.as_agent() に context_providers や description が追加され、Orchestrationの終端出力も AgentResponse に統一された。 python-1.1.0 , python-1.2.2
対応プロバイダー・連携先の増加 Gemini、Foundry Toolboxes、Hosted Agent V2、A2A bridge、Mistral chat client、A2UIなどが追加され、接続先やAgent間連携が広がった。1.17.0ではMistral clientを公式SDKへ移行し、OpenAI SDK 3.xもサポートした。1.18.0ではAzure AI Search、Redis、Qdrant alpha、PostgreSQL/pgvector alpha、1.19.0ではMongoDB alpha、Azure DocumentDB alpha、Azure Cosmos DB NoSQL、1.20.0ではDuckDBとSQL Serverのvector store、TypeSafe AI connectorが加わった。 python-1.1.0 〜 python-1.20.0
評価・観測性の強化 evaluate_workflow のground-truth対応、OpenTelemetry連携、instrumentation既定有効化、MCP OTel span、GenAI semantic conventionの設定整理に加え、service metadata・resource attribute・OTLP exporterをプログラムから設定できるようになった。 python-1.1.1 , python-1.2.0 , python-1.6.0 , python-1.8.1 , python-1.15.0 , python-1.16.0
Skills / MCP / Harness Agent周辺の拡張 Skills API、MCPスキル探索、HarnessAgent、background agent、file access、loop、approvalなどが短期間で大きく拡張され、Skills APIとHarness関連APIの一部はstableへ昇格した。 python-1.3.0 〜 python-1.12.0
ツール実行の安全性と柔軟性 approvalの既定化やguardrailsに加え、1.11.0では用途に応じてSkillsProvider / FileAccessProviderのapprovalを無効化できるようになった。 python-1.9.0 〜 python-1.11.0
実行中Agentへの介入 message injection middlewareにより、実行中のAgentへ同一セッション内でメッセージを差し込めるようになった。HarnessAgentも実行途中で追加指示を受け取れる。 python-1.11.0
ホスティングの共通化 hosting protocol helperとResponses helperに加え、A2A・MCP・Telegramのapp-owned hosting helperが追加された。 python-1.11.0 , python-1.12.0
stable APIの拡大 Skillsに続き、Harness Agent、mode/todo provider、ToolApprovalMiddleware、FileMemoryProvider、Declarative workflow、AG-UIなどがstableへ昇格した。 python-1.11.0 〜 python-1.12.1
セッションとcheckpointの運用 再利用可能なsession storeとFoundry Responses sessionの完全永続化が追加され、checkpointは初期入力とHITL応答からreplay可能になった。1.19.0では組み込みOrchestrationのcheckpoint型が復元用に登録される。 python-1.13.0 , python-1.19.0
Foundry Hosted Agentの進化 Hosted Agent V2、Toolbox、MCP、conversation session helper、Adaptive evals、provider-based state store、steering / retry / recoveryなど、Foundry上で運用するための機能やコンポーネントが拡充された。1.16.0ではFoundryToolboxの親コンストラクタ設定を公開し、backend-owned service-session snapshotを保持するようになった。1.17.0ではAgent Serverまたはagent-ownedのmodel historyを選べるようになり、重複したconversation replayを防ぐ。1.18.0ではcheckpointのデシリアライズを既定で制限する。 python-1.1.0 , python-1.2.0 , python-1.7.0 , python-1.10.0 , python-1.14.0 〜 python-1.18.0
Functional workflowの実行前提 Functional workflowを実行またはAgentとして扱う前に、stateful workflow instanceへbuildする必要がある。 python-1.14.0
Workflow checkpointの型管理 process-wide registryにより、workflow checkpointの状態型を一元的に登録できる。Cosmos checkpoint state typeも登録される。 python-1.15.0

利用環境に応じた確認対象の絞り込み

変更点が多岐にわたるため、利用している機能に応じて確認対象を絞り込みます。

特に影響が大きいと考えられる対象は、以下のとおりです。

  • Workflow / OrchestrationをAgentとして利用する場合: python-1.2.2 の AgentResponse 標準化に加え、python-1.14.0 ではFunctional workflowをstateful workflow instanceへbuildしてから実行・Agent化する必要がある。
  • Checkpointを永続化している場合: python-1.0.1 と python-1.1.0 の制限付きデシリアライズに注意する。python-1.15.0 ではworkflow checkpoint type registryが追加されたため、Cosmos checkpointを使う場合は型の登録・復元も確認する。
  • Skills / MCP / HarnessAgentを利用する場合: python-1.3.0 以降、特に python-1.8.0 〜 python-1.20.0 は変更が多い。1.20.0ではapprovalとMCP runtime contextの扱いが厳格化される。session-backed local approvalと、approval binding・agent-tool approvalの解決を確認する。
  • Checkpointを利用するWorkflowを運用する場合: python-1.13.0 でcheckpoint replayの前提が変わる。初期入力とhuman-in-the-loop応答を含めた再実行・復元テストを確認する。組み込みOrchestrationを使う場合は、python-1.19.0 でのcheckpoint復元も確認する。
  • Foundry Hosted Agentを利用する場合: Hosted Agent V2、Toolbox、MCP、conversation session helperに加え、python-1.14.0 のAgent Server Responses 2.x storage model、python-1.15.0 のsteering / retry / recovery、python-1.16.0 のFoundryToolbox設定とservice-session snapshotの継続性、python-1.17.0 のmodel history選択とOAuth consent復元、python-1.18.0 の制限付きcheckpointデシリアライズ、python-1.20.0 のrequest-scoped agent factoryと永続sessionを確認する。
  • DevUI / A2A / AG-UI / Declarativeを利用する場合: python-1.4.0、python-1.7.0、python-1.9.0、python-1.11.0 〜 python-1.20.0 の変更が移行に影響しやすい。checkpointを使うAG-UI Workflowでは、1.13.0のreplay変更、1.14.0のcheckpoint作成・resume、1.15.0のA2UI、1.16.0の継続入力の検証、1.17.0のapprovalとparallel function resultの保持、1.18.0のsnapshot出力設定、1.19.0のcookie永続化、1.20.0の切断run永続化とDeclarative workflow変更を確認する。
  • 観測性や本番運用を重視する場合: python-1.6.0 以降、instrumentationやOTel関連の挙動を確認する。特に1.15.0へ上げる場合はGenAI semantic conventionのmodeとmessage event設定、1.16.0へ上げる場合はservice metadata・resource attribute・OTLP exporterをどこで設定するか、1.17.0へ上げる場合はtool-loop compactionと観測性の出力挙動を見直す。1.18.0ではtool loopの最大実行時間とstop reasonを、監視とリトライの設計へ反映する。1.19.0ではmessage eventの出力制御とAspire trace表示、1.20.0ではFoundryのtrace propagationとResponses streamの制御を確認する。

バージョン別変更概要と移行の要点

軽微な修正を網羅するのではなく、ここでは利用者に直接影響する主要な変更点に絞って整理します。

Version 変更概要(利用者視点) 移行時の確認事項
python-1.0.0 正式版として安定化。 agent-framework / core / OpenAI / Foundryを本番向けパッケージとして扱えるようになった。 RCから上げる場合、依存関係の下限、Message(text=...) 、BaseContextProvider / BaseHistoryProvider の削除に注意。
python-1.0.1 Checkpoint保存の安全性が上がり、Handoff workflowまわりの挙動も改善された。 FileCheckpointStorage にカスタム型を保存している場合、allowed_checkpoint_types を指定しないとロードに失敗する可能性がある。
python-1.1.0 Gemini、Foundry Toolboxes、Hosted Agent V2、workflow.as_agent() 拡張など、接続先とAgent化の幅が広がった。 CosmosCheckpointStorage も制限付きデシリアライズに変わる。Cosmos checkpointを使う場合は allowed_checkpoint_types を確認する。
python-1.1.1 evaluate_workflow の期待出力、AG-UI/A2Aのthread伝播、SKIP_PARSING など、評価・UI連携・raw result扱いが改善された。 Hyperlight CodeActの公開API面が締められているため、Hyperlight利用時は呼び出し側を確認する。
python-1.2.0 Functional workflow API、A2A bridge、GitHub Copilot AgentのOTel統合、FoundryのOAuth consent event対応が入った。 Foundry hosted agent session周辺が更新されているため、Hosted Agent利用時はセッション処理を確認する。
python-1.2.1 Hosted Agent Responsesでfile data typeを扱えるようになり、A2A hosting sampleもpipで試しやすくなった。 主に依存関係更新が多い。フロントエンドサンプルや周辺ツールを含めた環境差分を確認する。
python-1.2.2 Orchestrationの終端出力が AgentResponse に標準化され、Workflow.as_agent() から最終回答を扱いやすくなった。 Orchestrationの戻り値に依存しているコードは、AgentResponse 前提に修正が必要になる可能性がある。
python-1.3.0 Skillsのmulti-source化、Claude/Gemini/Mistral/Purview/Foundry周辺の拡張が入り、対応範囲が広がった。 experimental skills APIが破壊的に再構成されているため、Skillsを利用している場合は確認が必要。
python-1.4.0 file skill discovery、SkillFrontmatter、DevUIのアクセス制御、A2A SDK v1.0対応など、周辺仕様の整合が進んだ。 Skills、DevUI、A2Aを使っている場合は破壊的変更が多い。特に公開DevUIやCORS設定は確認する。
python-1.5.0 MCP prompt loadingのunsupportedケースを避けるなど、MCP利用時の安定性が改善された。 目立つ破壊的変更は少ないが、MCP連携を使う場合は挙動差を確認する。
python-1.6.0 Foundry Toolbox MCPの認証手段が増え、instrumentationが既定で有効になった。 instrumentationの既定有効化に伴い、ログ・トレース・テレメトリの出力挙動や運用コストを確認する。
python-1.7.0 HarnessAgent、background-agents harness provider、A2AAgentSession、prompt-agent conversion/deployment APIなど、Agent運用形態が広がった。 declarative actionsのPython独自仕様が削除され、alias kindがC#の標準仕様へ統一された。Declarative利用時は移行手順の確認が必要。
python-1.8.0 MCP skills discovery、progressive tool exposure、AgentFileStore/FileAccessProvider、Bedrock structured output、Mistral embeddingなどが追加された。 GitHub Copilot SDK v1.0化およびexperimental Skill APIのasync化が破壊的変更となるため、SkillsやGitHub Copilotの利用時は確認が必要。
python-1.8.1 MCPのOTel span、long-running task、tool kwargs allowlistなど、MCP連携の観測性・安全性・安定性が改善された。 大きな破壊的変更はないが、MCP tool引数のフィルタリングで余分なkwargsに依存していた場合は注意。
python-1.9.0 AgentLoopMiddleware、tool approval middleware、harnessへのshell/tool approval統合など、Agentをループ実行・承認付きで動かしやすくなった。 MCP samplingは既定で拒否、FileAccess toolsの仕様も.NETに合わせて変更。MCP、FileAccess、Declarativeの利用者は変更内容の確認が必要。
python-1.10.0 Background agent loop、Foundry session helper、Adaptive evals、Durable Task worker、Azure AI Search API version対応など、運用・評価・ホスティング面が強化された。 Skills/FileAccess/FileMemory/HarnessAgent/Foundry Hosted Agent V2周辺で破壊的変更が集中。experimental領域を利用している場合は特に慎重にアップデートを適用する。
python-1.11.0 実行中Agentへのmessage injection、MCP tool schemaの段階的開示、SkillsのTTLキャッシュ、hosting protocol helper、AG-UIのSSE keepaliveなどが追加された。Skills APIはstableへ昇格した。 Skillsのキャッシュ分離と入れ子探索、FileAccess/FileMemoryの置換挙動、Durable Task hosting、AG-UIのinterrupt/resume、hosting-telegram削除を確認する。
python-1.12.0 A2A・MCP・Telegramのapp-owned hosting helper、Azure Cosmos DB semantic memory、workflow内HITLのresponse URL対応が追加された。Harness Agent、ToolApprovalMiddleware、FileMemoryProvider、Declarative workflowなどがstableへ昇格した。 Responsesのconversation ID、AG-UIの TOOL_CALL event、Harness compaction、FileAccessProviderのopt-in化を確認する。
python-1.12.1 AG-UIがstableへ昇格し、GPT-5.6のprompt cache breakpoint、Gemini 3のthought signature維持、reasoning付きtool callのreplay修正が入った。 BREAKING項目はない。custom MCP Streamable HTTP clientを使う場合は、追加されたセキュリティガイダンスも確認する。
python-1.13.0 archive-backed MCP Skillsの探索、再利用可能なsession store、Foundry Responses sessionの完全永続化、機能利用テレメトリが追加された。 checkpoint利用者は、初期入力とHITL応答からの完全replayへ変わるため、既存の復元・再実行テストを確認する。
python-1.14.0 Mistral chat client、AG-UIのcheckpoint作成・resume、Foundry Hosted Agent向けprovider-based state storeが追加された。 Functional workflowはstateful workflow instanceへbuildしてから実行・Agent化する。Foundry Hosted AgentはAgent Server Responses 2.x storage modelへの移行を確認する。
python-1.15.0 A2UI、workflow checkpoint type registry、Foundry Hosted Agentのsteering / retry / recoveryが追加された。 OTel GenAI semantic conventionのstable / experimental modeとmessage event設定を確認する。Foundry Hosted Agentでは回復処理を含む長時間workflowをテストする。
python-1.16.0 background agentの最初のタスク完了待機timeoutと、OTel service metadata・resource attribute・OTLP exporterのプログラム設定が追加された。Foundry / AG-UIではservice-session継続時のsnapshot保持も修正された。Providerの未対応finish reasonや、instrumentation時のOpenAI streaming保持も修正された。 OTelをコードから構成する場合は設定の責務を整理する。background agent、Foundry Hosted Agent、AG-UIで継続実行を使う場合は、timeoutとsession snapshotを含むシナリオをテストする。Anthropic、Mistral、Gemini、OpenAIを使う場合は終端理由とstreaming応答の扱いも確認する。
python-1.17.0 Agent Serverまたはagent-ownedのmodel historyを選択でき、重複したconversation replayを防げるようになった。Responses / DevUI / AG-UIではprovider refusal、approval、replay metadata、parallel function resultの保持が修正された。Mistral clientは公式SDKへ移行した。 agent middlewareはsequence-only入力へ戻り、experimental agent-hooks core extraは削除された。middleware、agent-hooks、Foundry / Responses / AG-UIの継続実行、Mistral設定を含めて回帰テストする。
python-1.18.0 共通vector store抽象にin-memory、Azure AI Search、Redis、Qdrant alpha、PostgreSQL/pgvector alphaが加わった。tool invocation loopには最大実行時間と停止理由が加わり、AG-UIはterminal message snapshotを抑制できる。 SecretString を文字列として扱うコード、Labを core[all] 経由で導入する環境、Copilot workspace file hook、Foundry hostingのカスタムcheckpoint型を確認する。実運用ではtool loopの時間制限とstop reasonを監視・リトライ方針に反映する。
python-1.19.0 vector store provider protocolと、MongoDB alpha、Azure DocumentDB alpha、Azure Cosmos DB NoSQL実装が加わった。組み込みOrchestrationのstable名とcheckpoint type登録、DevUIのAspire trace表示、逐次function call実行も追加された。 HTTP cookieの保存を暗黙に期待する処理、MCP skill archiveの形式、MCP sampling callback、provider-backed MCP session、Redis history storageを確認する。認証・セッション継続・checkpoint復元を含めた回帰テストを行う。
python-1.20.0 Foundry Responses / Invocationsでnative workflowをhostでき、DuckDB・SQL Server・TypeSafe AIの接続、Responses clientのcomputer use、session単位のfile access分離が追加された。 Foundry hostingはrequest-scoped agent factoryと永続sessionを前提とする設計へ移行する。Gemini Embeddingの環境変数とvector task設定、Declarative workflow、approvalを含むMCP連携を確認する。

注意すべき変更領域

破壊的変更の件数だけを見ると、agent-framework-core 周辺、とくに Skills / MCP / HarnessAgent / FileAccess / FileMemory に変更が集中しています。

この領域は便利な機能追加も多い一方で、まだ設計が動いている印象があります。

領域 注意点 主な該当バージョン
agent-framework-core Message、checkpoint、orchestration output、Skills、MCP、FileAccess、HarnessAgentなど、利用者が直接触る抽象に破壊的変更が多い。1.13.0ではcheckpoint replay、1.14.0ではFunctional workflowの実行前提、1.15.0ではOTel GenAI semantic conventionの設定が変わった。1.16.0ではcheckpointのstorage外からの変更を防ぎ、呼び出し側入力を変更しないようシリアライズも修正された。1.17.0ではagent middleware入力がsequence-onlyへ戻り、experimental agent-hooks core extraが削除された。1.18.0では SecretString の性質、File Storeの行番号契約とパス正規化、1.19.0ではcookie永続化とMCP skill archiveの条件、1.20.0ではapprovalとMCP runtime contextの扱いが変わった。 python-1.0.0、python-1.2.2、python-1.3.0、python-1.8.0 〜 python-1.20.0
Skills / MCP FileSkillsSource、McpSkillsSource、resource/script lookup、tool approval、sampling guardrailsなどが短期間で変わっている。1.12.0では再接続可能なMCP session providerとapp-owned MCP hosting helper、1.13.0ではarchive-backed Skillsの探索、1.14.0ではWindows junctionを拒否する修正、1.15.0ではremote MCP tool名のshadowing回避、1.16.0ではbackground agentの最初のタスク完了待機timeout、1.17.0ではMCP初期化失敗時に原因エラーを伝播する修正、1.18.0ではMCP Host履歴の変換、1.19.0ではskill archiveのZIP限定とsampling callbackの非推奨化、1.20.0ではapprovalとMCP runtime contextの厳格化が入った。 python-1.3.0、python-1.4.0、python-1.8.0 〜 python-1.20.0
HarnessAgent / background agents HarnessAgent、background agent、loop、FileMemory/FileAccess統合、実行中のmessage injectionが追加・変更されている。1.12.0で主要APIの一部がstableへ昇格した。 python-1.7.0 〜 python-1.12.0
FileAccess / FileMemory approval既定化、surgical edits、命名統一、replace_lines のliteral replacement化に加え、1.12.0でHarness Agentの FileAccessProvider がopt-inになった。 python-1.9.0 〜 python-1.12.0
Checkpoint storage pickleデシリアライズが制限され、カスタム型を永続化している場合は許可リスト指定が必要になる。1.13.0ではcheckpoint replayの前提が変わり、1.15.0ではprocess-wide workflow checkpoint type registryが追加された。1.16.0ではstorage実装の外からcheckpointを変更できないようにした。 python-1.0.1、python-1.1.0、python-1.13.0、python-1.15.0、python-1.16.0
Foundry Hosted Agent Hosted Agent V2、Toolbox、MCP、conversation session helperなどが増え、1.12.0ではFoundry hosting packageがbetaへ昇格した。1.13.0ではFoundry Responses sessionを完全に永続化でき、1.14.0ではAgent Server Responses 2.x storage modelへ移行し、1.15.0ではsteering / retry / recovery、1.16.0ではFoundryToolbox設定の公開とbackend-owned service-session snapshot保持、1.17.0ではmodel historyの選択とOAuth consentの復元、1.18.0では制限付きcheckpointデシリアライズ、1.20.0ではrequest-scoped agent factoryと永続sessionを軸とする再設計が入った。 python-1.1.0、python-1.2.0、python-1.7.0、python-1.10.0、python-1.12.0 〜 python-1.20.0
Declarative Python独自actionsの削除、alias kindのC# canonical name化を経て、1.12.0でDeclarative workflowがstableへ昇格した。 python-1.7.0、python-1.9.0、python-1.12.0
DevUI / A2A / AG-UI DevUIのアクセス制御・CORS強化、A2A SDK v1.0移行、AG-UIのinterrupt/resumeと TOOL_CALL event変更に加え、1.13.0ではcheckpoint replay、1.14.0ではcheckpoint作成・resume、1.15.0ではA2UI、1.16.0ではbackend-owned service-session snapshot保持と継続入力の検証、1.17.0ではapproval、Responses replay metadata、parallel function resultの保持、1.18.0ではterminal snapshotの抑制設定、1.19.0ではcookie永続化の明示とAspire trace表示、1.20.0では切断runの永続化が入った。 python-1.4.0、python-1.11.0 〜 python-1.20.0
Durable Task hosting multi-workflowとsub-workflow対応に続き、workflow内部から発生したHITL requestのresponse URL addressingが追加された。1.13.0ではsub-workflow stateを含むcheckpoint復元の修正があり、1.14.0ではDurable Agent Framework extensionへ移管された。 python-1.10.0 〜 python-1.14.0
GitHub Copilot連携 github-copilot-sdk v1.0.0化、tool approval hook連携、session optionの転送など、Copilot連携利用者はSDK側と個別パッケージのリリースも追う必要がある。 python-1.8.0、python-1.10.0 〜 python-1.12.0
Observability instrumentation既定有効化、OTel span追加、serialized tool formatのOTel GenAI形式への整合、parallel tool callのspan context修正に加え、1.13.0で機能利用テレメトリ、1.15.0でGenAI semantic convention設定の明示的なmode / message event制御、1.16.0でservice metadata・resource attribute・OTLP exporterのプログラム設定、1.17.0でtool-loop compactionと観測性の整合が入った。 python-1.6.0、python-1.8.1、python-1.10.0、python-1.12.0、python-1.13.0、python-1.15.0 〜 python-1.17.0

@experimental 機能の扱い

リリース本文を見る限り、破壊的変更の多くは experimental と明記された領域に集中しています。ただし、python-1.11.0 ではSkills API、python-1.12.0 ではHarness Agent、mode/todo provider、ToolApprovalMiddleware、FileMemoryProviderなどがstableへ昇格しました。一方で、Responses hostingやAG-UIには通常の破壊的変更も入っています。

特に次の領域は、機能追加の速度が速いぶん、API形状やデフォルト挙動も変わりやすいです。

  • Skills
  • MCP
  • HarnessAgent
  • FileAccess / FileMemory
  • Foundryの一部API

@experimental が付いている機能は、「便利だから使ってよい」ではなく、次の前提で扱うべきだと思います。

  • マイナーバージョンアップでも破壊的変更が入りうる
  • 本番コードではラップ層を挟み、直接依存を薄くする
  • バージョンを固定し、更新時はリリースノートと差分を必ず確認する
  • サンプルコードの追従だけでなく、戻り値・例外・デフォルト挙動をテストで固定する
  • 公式にstableへ昇格したかどうかを確認する

@experimental は「まだ未完成だから使うな」という意味ではありません。
ただし、Production/StableなAPIと同じ移行耐性を期待すると危ないです。

主要なBREAKING変更

すべてのBREAKING変更を並べると長くなるため、利用者目線で特に注意したいものだけを抜き出します。

Version 変更 影響
python-1.0.0 Message(text=...) の削除、BaseContextProvider / BaseHistoryProvider alias削除 RC時代のコードをそのまま使っている場合に修正が必要。
python-1.0.1 FileCheckpointStorage の制限付きデシリアライズ カスタム型をcheckpointに保存している場合、allowed_checkpoint_types が必要。
python-1.1.0 CosmosCheckpointStorage も制限付きデシリアライズに変更 Cosmos DB checkpoint利用者は同様に許可リスト対応が必要。
python-1.2.2 Orchestration終端出力を AgentResponse に標準化 Workflow.as_agent() の戻り値に依存しているコードに影響。
python-1.3.0 experimental skills API のmulti-source化 Skills利用者はAPI構造の見直しが必要。
python-1.4.0 Skills file discovery / SkillFrontmatter変更、DevUIアクセス制御強化、A2A SDK v1.0移行 Skills、DevUI、A2Aを使う場合はまとめて確認が必要。
python-1.6.0 instrumentationが既定で有効化 本番環境のログ・トレース・コスト・個人情報混入に注意。
python-1.7.0 Python独自declarative actions削除、alias kindをC# canonical namesへ Declarative workflow利用者は移行が必要。
python-1.8.0 github-copilot-sdk v1.0.0化、experimental Skill API async化 GitHub Copilot連携、Skills利用者に影響。
python-1.9.0 MCP sampling guardrails、FileAccess tools変更、Declarative workflow fixes MCP / FileAccess / Declarative利用者に影響。
python-1.10.0 FileSkillsSource、FileAccess、FileMemory、HarnessAgent、SkillsProvider approval、Foundry Hosted Agent V2 protocol upgrade experimental領域とFoundry Hosted Agent利用者は特に注意。
python-1.11.0 Skillsキャッシュの分離、入れ子の SKILL.md 探索、replace_lines 、Durable Task multi-workflow、AG-UI interrupt/resume、hosting-telegram削除 Skills周辺に加え、Durable Task hostingとAG-UIの利用者は移行方法を確認する。
python-1.12.0 Responsesのconversation ID区別、AG-UI workflow participantの TOOL_CALL event、Harness compaction、create_harness_agent のstable昇格 Responses hosting、AG-UI、Harness Agent利用者はAPIとevent処理を確認する。
python-1.13.0 checkpointを初期入力とhuman-in-the-loop応答から完全にreplay可能にする checkpointを使うWorkflowやAG-UIでは、復元後の再実行とHITL再開の挙動をテストする。
python-1.14.0 Functional workflowはstateful workflow instanceへbuildしてから実行・Agent化する。Foundry Hosted AgentはAgent Server Responses 2.x storage modelへ移行する。 Functional workflowの生成・実行経路と、Foundryのsession・checkpoint・function approvalの保存先を検証する。
python-1.15.0 OpenTelemetry GenAI semantic-convention supportをstable / experimental modeと明示的なmessage event制御へ整理する。 OTel exporter、collector、ダッシュボードやアラートが期待するattribute / eventを、移行前後で比較する。
python-1.17.0 agent middleware入力をsequence-onlyへ戻し、experimental agent-hooks core extraを削除する。 middlewareの引数形と、agent-framework-core[agent-hooks] に依存していないかを確認する。
python-1.18.0 SecretString をmaskする値オブジェクトへ変更し、Labを core[all] から分離する。Copilot workspace file hookをopt-inにし、Foundry hostingのcheckpointデシリアライズを既定で制限する。 認証情報を文字列として操作するコード、Labの依存指定、Copilot file操作、Foundry checkpointに保存するカスタム型を移行前に確認する。
python-1.19.0 HTTP cookie永続化を明示化し、MCP skill archiveをZIPに限定する。provider-backed MCP sessionをinvocation単位へ分離し、Redis history storage keyをproviderとsession identityでスコープする。 HTTP clientとcookie jarの所有者、MCP archive、sampling callback、provider-backed MCP session、Redis履歴のkeyと既存データを確認する。
python-1.20.0 Foundry hostingをrequest-scoped agent factory、永続的でsandbox分離されたsession、durable Invocations runを中心とする設計へ変更する。Gemini Embedding設定の GOOGLE_* namespace移行、Declarative workflowのexperimental変更も含む。 Foundry hostingのagent生成・session・Responses history・background実行設定、Gemini Embeddingの設定名、Declarative workflowのstate属性参照とHTTP URL処理を確認する。

まとめ

python-1.0.0 から python-1.20.0 までを見ると、Agent Framework は、正式版化した直後からかなり速いペースで進化しています。

利用者目線では、特に次の流れが重要です。

  • まず安定版化に伴い、RC互換APIが整理された
  • Checkpointまわりは安全側へ倒された
  • Workflow / OrchestrationはAgentとして扱いやすくなった
  • Skills / MCP / HarnessAgent / FileAccessまわりは急速に拡張された
  • Skills、Harness Agent、Declarative workflow、AG-UIなど、stableへ昇格するAPIが増えた
  • stable昇格後も周辺機能にはexperimentalな変更が残っている
  • ツール実行はapprovalやguardrailsにより安全性重視へ寄っている
  • Foundry Hosted Agentまわりは運用機能が増える一方、protocol変更もある
  • 1.13.0ではsession永続化とcheckpoint replayの運用上の前提も変わった
  • 1.14.0ではFunctional workflowの実行前提とFoundry Hosted Agentのstorage modelが変わった
  • 1.15.0ではA2UI、Foundry Hosted Agentの回復機構、OTel GenAI semantic convention設定が変わった
  • 1.16.0では破壊的変更なしで、OTel exporterのプログラム設定、background agentの待機timeout、Foundry / AG-UIの継続実行時のsession snapshot保持が改善された
  • 1.17.0ではagent middlewareの入力とagent-hooks extraが整理され、Foundryの履歴選択、approval・Responses replay・Provider SDKまわりが更新された
  • 1.18.0ではvector storeの共通抽象と複数の実装、tool loopの実行時間上限が追加された。一方、SecretString、Lab依存関係、Copilot file hook、Foundry checkpoint復元には破壊的変更がある
  • 1.19.0ではvector storeと組み込みOrchestrationが拡張された。一方、HTTP cookie、MCP archive・session、Redis履歴ストアを使う場合は状態管理の移行が必要になる
  • 1.20.0ではFoundryのnative workflow hostingとvector store接続が拡張された。一方、Foundry hosting、Gemini Embedding、Declarative workflowには移行を要する変更がある

細かなバグ修正は多いですが、移行時に一番見るべきなのは、自分が使っている抽象がどれかです。

特に @experimental 領域を使っている場合は、マイナーバージョンアップでも破壊的変更が入る前提で、リリースノートと差分を確認した方がよいと思います。

比較対象に含めないリリース

GitHub Releasesには、Agent Framework全体のPython向け統合リリース以外に、特定パッケージだけを公開するリリースやプレリリースも含まれます。これらはバージョン体系、安定度、変更範囲が統合リリースと異なるため、同じ表やグラフでは比較しません。

2026-10-02時点で、対象期間内に公開され、統合リリースと混同しやすいPython関連リリースは次のとおりです。

Release 種別 概要 対象外とする理由
python-devui-1.0.0b260414 個別パッケージのbeta版 DevUIフロントエンドでstreaming時にメモリ使用量が増え続ける問題を修正 agent-framework-devui 単独のbeta版で、Framework全体の正式版ではない
python-hosting-a2a-1.0.0a260723 個別パッケージのalpha版 A2A hostingへprogressive adapter、Agent Card生成、skill discovery、型付き変換などを追加 agent-framework-hosting-a2a 単独のalpha版で、Framework全体の正式版ではない
python-github-copilot-1.0.0 個別パッケージの正式版 GitHub Copilot連携をstableへ昇格し、画像や文書などの添付データ転送に対応 agent-framework-github-copilot 単独のリリースで、統合リリースとは変更範囲が異なる

対象外としたリリースにも利用者へ影響する変更はあります。該当パッケージを直接利用している場合は、統合リリースとは別にリリースノートを確認してください。

参考

1
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?