Python Agent Framework sample fails to import with currently resolved SDK dependencies

Open
#270 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
68/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Active
Tech stack
python
Domain
backend

Research direction

Start in the python/agent-framework/sample-agent directory by reproducing the uv installation and python -c "import agent" command, then inspect the sample's imports and dependency declarations. Update the sample for APIs available in the resolved Agent Framework dependencies and verify that importing the application and constructing the agent succeed with a smoke test.

Written by the indexing model from the issue text.

Description

Title: Python Agent Framework sample fails to import with currently resolved SDK dependencies

Description:

Summary

The Python Agent Framework sample uses SDK APIs that are unavailable in the dependency versions resolved during setup.

I encountered this in a local copy of the sample. I also checked upstream main on September 9, 2026 and confirmed that it contains the same imports and unconstrained Agent Framework dependency.

Sample: https://github.com/microsoft/Agent365-Samples/tree/main/python/agent-framework/sample-agent

Environment
  • macOS, Apple Silicon ARM64
  • Python 3.11.15
  • agent-framework-core==1.17.0
  • agent-framework-openai==1.14.2
  • agent-framework-azure-ai==1.0.0rc6
  • microsoft-agents-a365-tooling-extensions-agentframework==1.0.0
Steps to Reproduce

From an unmodified copy of the sample directory:

uv venv --python 3.11
source .venv/bin/activate
uv pip install -e .
python -c "import agent"

Dependency resolution can change over time; the versions above describe the environment where I observed the failure.

Actual Behavior

Importing the sample fails before startup or credential validation:

ImportError: cannot import name 'ChatAgent' from 'agent_framework'

After updating that import and its constructor locally, the next import fails:

ImportError: cannot import name 'AzureOpenAIChatClient' from 'agent_framework.azure'
Expected Behavior

Following the documented installation steps should produce an application that imports successfully with the resolved dependencies.

Suggested Resolution

Update the sample to APIs compatible with the Agent 365 integration and provide a tested dependency set. An import and agent-construction smoke test would help catch future SDK incompatibilities.

Dominant language
Python
Stars
41
Forks
23
Avg merge
7h 43m
Merged PRs (30d)
3

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from microsoft/Agent365-python

All issues in microsoft/Agent365-python

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.