本页介绍使用代理框架时的常见问题和解决方案。
注释
正在重构此页面。 将添加常见的故障排除方案。
常见问题
身份验证错误
确保你已为 AI 提供程序配置正确的凭据。 对于 Azure OpenAI，请验证：
- Azure CLI 已安装并经过身份验证 （
az login） - 用户具有
Cognitive Services OpenAI User或Cognitive Services OpenAI Contributor角色
包安装问题
确保使用的是 .NET 8.0 SDK 或更高版本。 运行 dotnet --version 以检查已安装的版本。
代理框架支持 Python 3.10 到 3.15。 此版本仍支持 Python 3.10，但它已软弃用，因为上游 Python 3.10 已终止生命周期。 将 Python 3.11 或更高版本用于新环境，并运行python --version以验证活动解释器。
在 Python 3.14 和 3.15 上，不会计算声明性 Power Fx 表达式。 在 Python 3.15 上，pip install agent-framework可成功运行，但功能集有所缩减：未安装 Redis 和 Hyperlight，且不提供 AG-UI A2UI 附加功能。 如果某个集成无法被识别，请检查其 Requires-Python 范围并使用兼容的解释器。 有关详细信息，请参阅 Python 2026 重大更改指南。
确保使用的是 Go 1.25 或更高版本。 运行 go version 以检查已安装的版本。 如果依赖项无法解析，请运行 go mod tidy，并确认你的模块导入的是当前 SDK 中存在的 github.com/microsoft/agent-framework-go 包。
获取帮助
如果在此处找不到解决方案，请访问 GitHub 讨论 以获取社区支持。