หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
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.11 through 3.15. Python 3.10 is no longer
supported or tested in Python 1.24, although package metadata still permits
installation. Use Python 3.11 or later, 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 omits Redis because RedisVL requires
an earlier Python version. Hyperlight 0.8, the AG-UI A2UI extra, and DuckDB 2.x
support Python 3.15. 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.26 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.