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.10 à 3.15. Python 3.10 reste pris en charge pour cette version, mais son utilisation est déconseillée, car la version amont de Python 3.10 a atteint sa fin de vie. Utilisez Python 3.11 ou version ultérieure pour les nouveaux environnements et 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 module complémentaire AG-UI A2UI et DuckDB 2.x prennent en charge Python 3.15 dans Agent Framework 1.23. 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.