Problembehandlung

Diese Seite behandelt häufige Probleme und Lösungen beim Arbeiten mit Agent Framework.

Note

Diese Seite wird umstrukturiert. Häufige Problembehandlungsszenarien werden hinzugefügt.

Häufige Probleme

Authentifizierungsfehler

Stellen Sie sicher, dass Sie die richtigen Anmeldeinformationen für Ihren KI-Anbieter konfiguriert haben. Überprüfen Sie für Azure OpenAI Folgendes:

  • Azure CLI wird installiert und authentifiziert (az login)
  • Der Benutzer hat die Rolle Cognitive Services OpenAI User oder Cognitive Services OpenAI Contributor.

Probleme bei der Paketinstallation

Stellen Sie sicher, dass Sie .NET 8.0 SDK oder höher verwenden. Führen Sie dotnet --version aus, um die installierte Version zu überprüfen.

Agent Framework unterstützt Python 3.11 bis 3.15. Python 3.10 wird in Python 1.24 nicht mehr unterstützt oder getestet, obwohl Paketmetadaten weiterhin die Installation zulassen. Verwenden Sie Python 3.11 oder höher, und führen Sie python --version aus, um den aktiven Interpreter zu überprüfen.

In Python 3.14 und 3.15 werden deklarative Power Fx-Ausdrücke nicht ausgewertet. Auf Python 3.15 wird pip install agent-framework Redis weggelassen, da RedisVL eine frühere Python-Version erfordert. Hyperlight 0.8, das AG-UI A2UI-Extra und DuckDB 2.x unterstützen Python 3.15. Wenn eine Integration nicht aufgelöst werden kann, überprüfen Sie den Requires-Python-Bereich, und verwenden Sie einen kompatiblen Interpreter. Ausführliche Informationen finden Sie im Leitfaden zu wichtigen Änderungen in Python 2026.

Stellen Sie sicher, dass Sie Go 1.26 oder höher verwenden. Führen Sie go version aus, um die installierte Version zu überprüfen. Wenn Abhängigkeiten nicht aufgelöst werden können, führen Sie go mod tidy aus und überprüfen Sie, dass Ihr Modul github.com/microsoft/agent-framework-go Pakete importiert, die im aktuellen SDK vorhanden sind.

Hilfe erhalten

Wenn Sie hier keine Lösung finden können, besuchen Sie unsere GitHub-Diskussionen für Community-Support.

Nächste Schritte