Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This page covers common issues and solutions when working with Agent Framework.
Note
This page is being restructured. Common troubleshooting scenarios will be added.
Common Issues
Authentication Errors
Ensure you have the correct credentials configured for your AI provider. For Azure OpenAI, verify:
- Azure CLI is installed and authenticated (
az login) - User has the
Cognitive Services OpenAI UserorCognitive Services OpenAI Contributorrole
Package Installation Issues
Ensure you're using .NET 8.0 SDK or later. Run dotnet --version to check your installed version.
Agent Framework supports Python 3.10 through 3.15. Python 3.10 remains
supported for this release, but it's soft-deprecated because upstream Python
3.10 reached end of life. Use Python 3.11 or later for new environments,
and run python --version to verify the active interpreter.
On Python 3.14 and 3.15, Declarative Power Fx expressions aren't evaluated. On
Python 3.15, pip install agent-framework succeeds with a reduced feature set:
Redis and Hyperlight aren't installed, and the AG-UI A2UI extra isn't
available. If an integration fails to resolve, check its Requires-Python
range and use a compatible interpreter. For details, see the
Python 2026 significant changes guide.
Ensure you're using Go 1.25 or later. Run go version to check your installed version. If dependencies fail to resolve, run go mod tidy and verify your module imports github.com/microsoft/agent-framework-go packages that exist in the current SDK.
Getting Help
If you can't find a solution here, visit our GitHub Discussions for community support.