Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Op deze pagina worden veelvoorkomende problemen en oplossingen behandeld bij het werken met Agent Framework.
Opmerking
Deze pagina wordt geherstructureerd. Veelvoorkomende scenario's voor probleemoplossing worden toegevoegd.
Veelvoorkomende problemen
Authenticatiefouten
Zorg ervoor dat u de juiste inloggegevens hebt ingesteld voor uw AI-provider. Controleer voor Azure OpenAI het volgende:
- Azure CLI is geïnstalleerd en geverifieerd (
az login) - Gebruiker heeft de
Cognitive Services OpenAI UserofCognitive Services OpenAI Contributorrol
Installatieproblemen met pakketten
Zorg ervoor dat u .NET 8.0 SDK of hoger gebruikt. Voer deze opdracht uit dotnet --version om de geïnstalleerde versie te controleren.
Agent Framework ondersteunt Python 3.10 tot en met 3.15. Python 3.10 blijft ondersteund voor deze release, maar het is soft-deprecated omdat de upstreamversie van Python 3.10 het einde van de levensduur heeft bereikt. Gebruik Python 3.11 of hoger voor nieuwe omgevingen en voer python --version uit om de actieve interpreter te controleren.
Op Python 3.14 en 3.15 worden declaratieve Power Fx-expressies niet geëvalueerd. Op Python 3.15 werkt pip install agent-framework met een beperkte functieset: Redis en Hyperlight zijn niet geïnstalleerd en de AG-UI A2UI-extra is niet beschikbaar. Als een integratie niet kan worden afgehandeld, controleert u het Requires-Python bereik en gebruikt u een compatibel interpreterprogramma. Zie de handleiding voor belangrijke wijzigingen in Python 2026 voor meer informatie.
Zorg ervoor dat u Go 1.25 of hoger gebruikt. Voer deze opdracht uit go version om de geïnstalleerde versie te controleren. Als afhankelijkheden niet kunnen worden opgelost, voer go mod tidy uit en controleer of uw module github.com/microsoft/agent-framework-go-pakketten importeert die in de huidige SDK bestaan.
Hulp krijgen
Als u hier geen oplossing kunt vinden, gaat u naar onze GitHub-discussies voor ondersteuning van de community.