本頁涵蓋使用 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.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 討論區 尋求社群支援。