Azure / Azure/azure-sdk-for-python
[azure-ai-agentserver-agentframework] Dependency conflict with agent-framework-core 1.0.1 GA
- Dominant language
- Python
- Stars
- 5.6k
- Forks
- 3.4k
- Avg merge
- 1d 21h
- Merged PRs (30d)
- 193
Description
## Description
The `azure-ai-agentserver-agentframework` package (v1.0.0b17, released 2026-03-16) pins its dependencies to pre-release versions of `agent-framework`, making it incompatible with the GA 1.0.1 release (published 2026-04-10).
**Cross-reference:** microsoft/agent-framework#5273
## Dependency Conflict
`azure-ai-agentserver-agentframework==1.0.0b17` requires:
- `agent-framework-core<=1.0.0rc3,>=1.0.0rc2`
- `agent-framework-azure-ai<=1.0.0rc3,>=1.0.0rc2`
The GA release changed:
- `agent-framework-core` → **1.0.1** (outside the `<=1.0.0rc3` upper bound)
- `agent-framework-azure-ai` → **renamed** to `agent-framework-foundry==1.0.1`
## Reproduction
```
# requirements.txt
agent-framework-core==1.0.1
agent-framework-foundry==1.0.1
azure-ai-agentserver-agentframework==1.0.0b17
azure-ai-agentserver-core==1.0.0b17
azure-identity>=1.19.0
```
```bash
pip install -r requirements.txt
```
### Error
```
ERROR: Cannot install agent-framework-core==1.0.1 and
azure-ai-agentserver-agentframework==1.0.0b17 because these package versions
have conflicting dependencies.
The conflict is caused by:
The user requested agent-framework-core==1.0.1
agent-framework-foundry 1.0.1 depends on agent-framework-core<2 and >=1.0.1
azure-ai-agentserver-agentframework 1.0.0b17 depends on agent-framework-core<=1.0.0rc3 and >=1.0.0rc2
ERROR: ResolutionImpossible
```
## Impact
Anyone deploying hosted agents to Microsoft Foundry Agent Service (via `azd up` / `azd deploy` or the `from_agent_framework(agent).run()` pattern) **cannot upgrade** to the Agent Framework GA release. This blocks:
- Adoption of `agent-framework-foundry` (`FoundryChatClient`, the replacement for `AzureAIAgentClient`)
- `agent-framework-core>=1.0.1` GA features
- Updated env var conventions (`FOUNDRY_PROJECT_ENDPOINT`, `FOUNDRY_MODEL`)
## Expected Fix
A new release of `azure-ai-agentserver-agentframework` that:
1. Updates the `agent-framework-core` constraint to `>=1.0.1,<2`
2. Replaces the `agent-framework-azure-ai` dependency with `agent-framework-foundry>=1.0.1,<2`
3. Updates any internal imports from `agent_framework.azure` to `agent_framework_foundry`
The same changes likely apply to `azure-ai-agentserver-core` if it has similar pinned constraints.
## Workaround
Stay on pre-release versions:
```
agent-framework-core==1.0.0rc3
agent-framework-azure-ai==1.0.0rc3
azure-ai-agentserver-agentframework==1.0.0b17
azure-ai-agentserver-core==1.0.0b17
```
## Environment
- OS: Windows 11
- Python: 3.13
- azure-ai-agentserver-agentframework: 1.0.0b17 (latest on PyPI)
- agent-framework-core: 1.0.1 (GA target)
- azd: latest with `azure.ai.agents` extension v0.1.22-preview
Contributor guide
Assessment
This issue has not been assessed yet.