本頁涵蓋使用 Agent Framework 時常見的問題與解決方案。
備註
本頁面正在重組中。 常見的故障排除情境也會被加入。
常見問題
身份驗證錯誤
確保你為你的 AI 供應商設定正確的憑證。 針對 Azure OpenAI，請驗證：
- Azure CLI 已安裝並認證（
az login） - 使用者擁有
Cognitive Services OpenAI UserORCognitive Services OpenAI Contributor角色
套件安裝問題
請確保你使用的是 .NET 8.0 SDK 或更新版本。 執行 dotnet --version 檢查已安裝的版本。
Agent Framework 支援 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 討論區 尋求社群支援。