本页介绍使用代理框架时的常见问题和解决方案。
注释
正在重构此页面。 将添加常见的故障排除方案。
常见问题
身份验证错误
确保你已为 AI 提供程序配置正确的凭据。 对于 Azure OpenAI，请验证：
- Azure CLI 已安装并经过身份验证 （
az login） - 用户具有
Cognitive Services OpenAI User或Cognitive Services OpenAI Contributor角色
包安装问题
确保使用的是 .NET 8.0 SDK 或更高版本。 运行 dotnet --version 以检查已安装的版本。
代理框架支持 Python 3.11 到 3.15。 尽管包元数据仍允许安装，但 Python 1.24 中不再支持也不再测试 Python 3.10。 使用 Python 3.11 或更高版本，然后运行python --version以验证活动解释器。
在 Python 3.14 和 3.15 上，不会计算声明性 Power Fx 表达式。 在 Python 3.15 上，pip install agent-framework省略 Redis，因为 RedisVL 需要较早的 Python 版本。 Hyperlight 0.8、AG-UI A2UI extra 和 DuckDB 2.x 支持 Python 3.15。 如果某个集成无法解析，检查其 Requires-Python 范围并使用兼容的解释器。
有关详细信息，请参阅 Python 2026 重大更改指南。
确保使用的是 Go 1.26 或更高版本。 运行 go version 以检查已安装的版本。 如果依赖项无法解析，请运行 go mod tidy，并确认你的模块导入的是当前 SDK 中存在的 github.com/microsoft/agent-framework-go 包。
获取帮助
如果在此处找不到解决方案，请访问 GitHub 讨论 以获取社区支持。