Troubleshooting

Den här sidan beskriver vanliga problem och lösningar när du arbetar med Agent Framework.

Anmärkning

Den här sidan håller på att omstruktureras. Vanliga felsökningsscenarier läggs till.

Vanliga problem

Autentiseringsfel

Kontrollera att du har rätt autentiseringsuppgifter konfigurerade för DIN AI-provider. För Azure OpenAI kontrollerar du:

  • Azure CLI installeras och autentiseras (az login)
  • Användaren har Cognitive Services OpenAI User rollen eller Cognitive Services OpenAI Contributor

Problem med paketinstallation

Kontrollera att du använder .NET 8.0 SDK eller senare. Kör dotnet --version för att kontrollera den installerade versionen.

Agent Framework stöder Python 3.11 till 3.15. Python 3.10 stöds eller testas inte längre i Python 1.24, även om paketmetadata fortfarande tillåter installation. Använd Python 3.11 eller senare och kör python --version för att verifiera den aktiva tolken.

På Python 3.14 och 3.15 utvärderas inte deklarativa Power Fx-uttryck. På Python 3.15 pip install agent-framework utelämnar Redis eftersom RedisVL kräver en tidigare Python version. Hyperlight 0.8, AG-UI A2UI extra och DuckDB 2.x stöder Python 3.15. Om det inte går att lösa en integration kontrollerar du dess Requires-Python intervall och använder en kompatibel interpreter. Mer information finns i guiden om betydande ändringar för Python 2026.

Kontrollera att du använder Go 1.26 eller senare. Kör go version för att kontrollera den installerade versionen. Om beroenden inte kan lösas, kör go mod tidy och verifiera att modulen importerar github.com/microsoft/agent-framework-go paket som ingår i det aktuella SDK:et.

Få hjälp

Om du inte hittar någon lösning här kan du besöka våra GitHub-diskussioner för communitystöd.

Nästa steg

FAQ