microsoft / microsoft/Agent365-python

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.

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

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.

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.

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.

Assessment

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.