Troubleshooting

本頁涵蓋使用 Agent Framework 時常見的問題與解決方案。

備註

本頁面正在重組中。 常見的故障排除情境也會被加入。

常見問題

身份驗證錯誤

確保你為你的 AI 供應商設定正確的憑證。 針對 Azure OpenAI,請驗證:

  • Azure CLI 已安裝並認證(az login)
  • 使用者擁有 Cognitive Services OpenAI User OR Cognitive 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 討論區 尋求社群支援。

下一步