Probleemoplossing

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 User of Cognitive Services OpenAI Contributor rol

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.

Volgende stappen 

FAQ