microsoft-foundry / microsoft-foundry/foundry-samples

`azd deploy` fails: pip dependency conflict for `msft-docs-agent`

Open
#641 3 comments 0 reactions 10 assignees View on GitHub

@TaoChenOSU is already working on this.

Since Aug 15, 2026.

bug
Dominant language
Bicep
Stars
445
Forks
494
Avg merge
11h 35m
Merged PRs (30d)
38

Description

Description:
When running azd up, the deployment fails during the azd deploy step while building the msft-learn-mcp-agent service for agent msft-docs-agent. The container build fails at pip install -r requirements.txt with a dependency resolution error, as shown in the following image:
Image

Steps to Reproduce:

  1. Initialize the project: azd init --template Azure-Samples/ai-foundry-starter-basic.
  2. Initialize AI agent: azd ai agent init -m https://github.com/microsoft-foundry/foundry-samples/blob/main/samples-classic/python/getting-started-agents/hosted-agents/msft-docs-agent/agent.yaml and select location southcentralus.
  3. Run azd up.

Environment:

  • Azd version: azd version 1.24.0-beta.1-daily.6102867 (commit 751a3e746824e073c958d1b3f447aa16fb115b1a) (daily).
  • AI Agent Extension version: 0.1.20-preview
  • Agent: msft-docs-agent.
  • OS: Windows
  • Location: southcentralus.

Expected Behavior:
azd deploy completes successfully.

@JeffreyCA and @rajeshkamal5050 for notification.

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.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.