はじめに
Microsoft Agent Framework は、AIエージェントを構築するためのMicrosoft製オープンソースSDKです。
この記事では、そのPython向け実装である Agent Framework for Python を扱います。
python-1.0.0 が 2026-04-02 にリリースされ、その後 2026-07-30 には python-1.13.0 まで進んでいます。
短期間で機能追加も多く、破壊的変更もそれなりにあります。
この記事では、python-1.0.0 から python-1.13.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.13.0
|
破壊的変更と機能追加が集中。1.11.0でSkills API、1.12.0でHarness関連APIの一部がstableへ昇格し、1.13.0でarchive-backed MCP Skillsの探索が加わった |
| Foundry Hosted Agent |
python-1.1.0 , python-1.7.0 , python-1.10.0 , python-1.12.0 , python-1.13.0
|
Hosted Agent V2、session helper、protocol upgrade、Foundry hosting packageのbeta昇格に加え、Responses session永続化を確認したい |
| DevUI / A2A / AG-UI / Declarative |
python-1.4.0 , python-1.7.0 , python-1.9.0 , python-1.11.0 〜 python-1.13.0
|
アクセス制御、SDK v1.0移行、AG-UI変更・stable昇格、A2A helper追加、Declarative stable昇格に加え、checkpoint replay変更がある |
| Durable Task hosting |
python-1.10.0 〜 python-1.13.0
|
worker、multi-workflow・sub-workflow、workflow内HITLのresponse URL対応に加え、checkpoint replayの変更を確認したい |
| 本番運用・観測性 |
python-1.6.0 , python-1.8.1 , python-1.10.0 , python-1.12.0 , python-1.13.0
|
instrumentationやOTel関連に加え、tool spanやsession snapshotの修正、機能利用テレメトリがある |
この記事は 2026-08-02 時点で確認した情報をもとにしています。
対象はAgent Framework全体のPython向け正式版リリース python-1.0.0 〜 python-1.13.0 です。
バージョンを固定してインストールする
バージョンを固定してインストールする場合は、次のように指定します。
pip install agent-framework==1.13.0
別のバージョンを確認したい場合は、1.13.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で示されている設計上の特徴です。
全体の流れ
まず、各リリースを「移行コスト」と「導入メリット」で並べると次のようになります。
ここでのスコアは厳密な評価ではなく、リリースノートを読むための目安です。
ただし完全な主観だけにはしないため、次の式で機械的に計算しました。
移行コスト = 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] |
座標は全リリース中の最大値で正規化し、表示上限を 0.9 として小数第2位へ丸めています。最大移行コストと最大導入メリットは、どちらも 1.11.0 です。
このスコアは、どのリリースを重点的に読むべきかを把握するための目安です。
実際に導入・アップデートする際は、自分が使っている機能に関係するリリースノートと差分を必ず確認してください。
赤：メジャーリリース 青：マイナーリリース 緑：パッチリリース
この整理で見ると、python-1.3.0 と python-1.8.0 は移行コストに対して導入メリットが大きいリリースです。
一方、python-1.10.0 から python-1.12.0 は導入メリットも大きいですが、破壊的変更が多く、既存コードを持っている場合は慎重に確認したいリリースです。python-1.13.0 は機能追加と修正が多い一方、BREAKING項目はcheckpoint replayに集中しています。checkpointを使うWorkflowやAG-UIを運用している場合は、重点的に確認するとよいです。
後方互換性の観点では、ざっくり次のように見ています。
| 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利用者は復元・再実行の挙動を確認したい。 |
リリース単位で見ると細かな修正は多いですが、利用者目線では次の流れが重要です。
| 観点 | 何が変わったか | 主な該当バージョン |
|---|---|---|
| 安定版化 | 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 embedding などが追加され、接続先やAgent間連携が広がった。 |
python-1.1.0 〜 python-1.8.0
|
| 評価・観測性の強化 |
evaluate_workflow のground-truth対応、OpenTelemetry連携、instrumentation既定有効化、MCP OTel spanなど、運用時に追跡しやすくなった。 |
python-1.1.1 , python-1.2.0 , python-1.6.0 , python-1.8.1
|
| 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可能になった。 | python-1.13.0 |
| Foundry Hosted Agentの進化 | Hosted Agent V2、Toolbox、MCP、conversation session helper、Adaptive evalsなど、Foundry上で運用するための部品が増えた。 |
python-1.1.0 , python-1.2.0 , python-1.7.0 , python-1.10.0
|
バージョン別の使い勝手まとめ
細かな修正を全部並べると読みにくくなるため、ここでは「利用者にとって何が変わるか」に絞ります。
| 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へ変わるため、既存の復元・再実行テストを確認する。 |
自分の確認対象を絞る
すべての変更を読むのは大変なので、自分が使っている機能から確認対象を絞るのがよいです。
特に影響が大きそうなのは、次の利用者です。
-
Workflow / OrchestrationをAgentとして使う人:
python-1.2.2のAgentResponse標準化、workflow.as_agent()周辺の変更を確認する。 -
Checkpointを永続化している人:
python-1.0.1とpython-1.1.0の制限付きデシリアライズに注意する。 -
Skills / MCP / HarnessAgentを使う人:
python-1.3.0以降、特にpython-1.8.0〜python-1.13.0は変更が多い。Skills APIは1.11.0、Harness関連APIの一部は1.12.0でstableへ昇格したが、周辺機能にはexperimentalな破壊的変更が残る。archive-backed MCP Skillsを使う場合は1.13.0も確認する。 -
Checkpointを使うWorkflowを運用する人:
python-1.13.0でcheckpoint replayの前提が変わる。初期入力とhuman-in-the-loop応答を含めた再実行・復元テストを確認する。 - Foundry Hosted Agentを使う人: Hosted Agent V2、Toolbox、MCP、conversation session helper、V2 protocol upgradeを追う必要がある。
-
DevUI / A2A / AG-UI / Declarativeを使う人:
python-1.4.0、python-1.7.0、python-1.9.0、python-1.11.0、python-1.12.0、python-1.13.0の変更が移行に影響しやすい。checkpointを使うAG-UI Workflowでは、1.13.0のreplay変更も確認する。 -
観測性や本番運用を重視する人:
python-1.6.0以降、instrumentationやOTel関連の挙動を確認する。
注意すべき変更領域
破壊的変更の件数だけを見ると、agent-framework-core 周辺、とくに Skills / MCP / HarnessAgent / FileAccess / FileMemory に変更が集中しています。
この領域は便利な機能追加も多い一方で、まだ設計が動いている印象があります。
| 領域 | 注意点 | 主な該当バージョン |
|---|---|---|
agent-framework-core |
Message、checkpoint、orchestration output、Skills、MCP、FileAccess、HarnessAgentなど、利用者が直接触る抽象に破壊的変更が多い。1.13.0ではcheckpoint replayの前提も変わった。 |
python-1.0.0、python-1.2.2、python-1.3.0、python-1.8.0 〜 python-1.13.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の探索が追加された。 |
python-1.3.0、python-1.4.0、python-1.8.0 〜 python-1.13.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の前提も変わった。 |
python-1.0.1、python-1.1.0、python-1.13.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を完全に永続化できる。 |
python-1.1.0、python-1.2.0、python-1.7.0、python-1.10.0、python-1.12.0、python-1.13.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に影響する。 |
python-1.4.0、python-1.11.0、python-1.12.0、python-1.12.1、python-1.13.0
|
| Durable Task hosting | multi-workflowとsub-workflow対応に続き、workflow内部から発生したHITL requestのresponse URL addressingが追加された。1.13.0ではsub-workflow stateを含むcheckpoint復元の修正もある。 |
python-1.10.0 〜 python-1.13.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で機能利用テレメトリが追加された。 |
python-1.6.0、python-1.8.1、python-1.10.0、python-1.12.0、python-1.13.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.0.0 から python-1.13.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の運用上の前提も変わった
細かなバグ修正は多いですが、移行時に一番見るべきなのは、自分が使っている抽象がどれかです。
特に @experimental 領域を使っている場合は、マイナーバージョンアップでも破壊的変更が入る前提で、リリースノートと差分を確認した方がよいと思います。
比較対象に含めないリリース
GitHub Releasesには、Agent Framework全体のPython向け統合リリース以外に、特定パッケージだけを公開するリリースやプレリリースも含まれます。これらはバージョン体系、安定度、変更範囲が統合リリースと異なるため、同じ表やグラフでは比較しません。
2026-08-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 単独のリリースで、統合リリースとは変更範囲が異なる |
対象外としたリリースにも利用者へ影響する変更はあります。該当パッケージを直接利用している場合は、統合リリースとは別にリリースノートを確認してください。