Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cette page traite des problèmes courants et des solutions lors de l’utilisation d’Agent Framework.
Note
Cette page est en cours de restructuration. Des scénarios de résolution des problèmes courants seront ajoutés.
Problèmes courants
Erreurs d’authentification
Vérifiez que vous disposez des informations d’identification correctes configurées pour votre fournisseur IA. Pour Azure OpenAI, vérifiez :
- Azure CLI est installé et authentifié (
az login) - L’utilisateur a le rôle
Cognitive Services OpenAI UserouCognitive Services OpenAI Contributor
Problèmes d’installation de package
Vérifiez que vous utilisez le Kit de développement logiciel (SDK) .NET 8.0 ou version ultérieure. Exécutez dotnet --version pour vérifier votre version installée.
Agent Framework prend en charge Python 3.11 à 3.15. Python 3.10 n’est plus pris en charge ou testé à partir de Python 1.24, bien que les métadonnées du package autorisent toujours l’installation. Utilisez Python 3.11 ou version ultérieure, puis exécutez python --version pour vérifier l’interpréteur actif.
Sur Python 3.14 et 3.15, les expressions Power Fx déclaratives ne sont pas évaluées. Sous Python 3.15, pip install agent-framework omet Redis, car RedisVL nécessite une version antérieure de Python. Hyperlight 0.8, le extra AG-UI A2UI et DuckDB 2.x prennent en charge Python 3.15. Si une intégration ne peut pas être résolue, vérifiez sa Requires-Python plage de versions et utilisez un interpréteur compatible.
Pour plus d’informations, consultez le guide des modifications significatives Python 2026.
Vérifiez que vous utilisez Go 1.26 ou version ultérieure. Exécutez go version pour vérifier votre version installée. Si les dépendances ne parviennent pas à être résolues, exécutez et vérifiez go mod tidy que votre module importe github.com/microsoft/agent-framework-go des packages qui existent dans le Kit de développement logiciel (SDK) actuel.
Obtenir de l’aide
Si vous ne trouvez pas de solution ici, visitez nos discussions GitHub pour obtenir un support communautaire.