Microsoft Agent 365 SDK を使用して、Python で構築されたエージェントを展開する方法のクイックスタートとして、クイックスタート: Python Agent Framework サンプル エージェントの設定と実行 が公開されています。
このクイックスタートでは Agent Framework Sample Agent – Python が使用されていますが、2026/03/02 時点では、このサンプロを利用仕様とすると次のエラーが発生します。
uv run python start_with_generic_host.py
warning: The `tool.uv.dev-dependencies` field (used in `pyproject.toml`) is deprecated and will be removed in a future release; use `dependency-groups.dev` instead
???????????????????? [0/10] Installing wheels… warning: Failed to hardlink files; falling back to full copy. This may lead to degraded performance.
If the cache and target directories are on different filesystems, hardlinking may not be supported.
If this is intentional, set `export UV_LINK_MODE=copy` or use `–link-mode=copy` to suppress this warning.
Installed 10 packages in 1.06s
Import error: cannot import name ‘ChatAgent’ from ‘agent_framework’ (D:\git\Agent365_QuickStart\agent365-agentframework-python_2\.venv\Lib\site-packages\agent_framework\__init__.py)
Please ensure you’re running from the correct directory
この事象については python/agent-framework/sample-agent no longer works due to breaking changes in Agent Framework #221 としてイシューが起票されていますが、Agent Framework の 1.0.0b260210 の破壊的変更の影響となるようです。
このバージョンでは API の名称が ChatAgent -> Agent というように変更が行われていますが、この API 名変更の対応がサンプル側で実施されていないことによる影響があるようです。
現在、Python 向けのサンプルとしては、次の 2 種類が提供されています。
「2.」のサンプルは Agent Framework ではなく、OpenAI Agent SDK が使用されており、こちらのサンプルを使用した場合は、Agent Framework の破壊的変更の影響は受けずに、クイックスタートを一通り流すことができますので、「クイックスタートを実行して、どのような流れでエージェントを作成するのかを確認したい」ということであれば、本投稿時点では OpenAI Agent SDK 版のサンプルを使用したほうがよいかのではないでしょうか。
Agent Framework を使用したものについては、python/agent-framework/sample-agent no longer works due to breaking changes in Agent Framework #221 のイシューをトラッキングすれば状態は確認できるのかと。