Troubleshooting

Na tej stronie omówiono typowe problemy i rozwiązania podczas pracy z platformą Agent Framework.

Uwaga / Notatka

Ta strona jest przebudowywana. Zostaną dodane typowe scenariusze rozwiązywania problemów.

Typowe problemy

Błędy uwierzytelniania

Upewnij się, że masz poprawne poświadczenia skonfigurowane dla dostawcy sztucznej inteligencji. W przypadku usługi Azure OpenAI sprawdź:

• Azure CLI został zainstalowany i uwierzytelniony (az login)
• Użytkownik ma rolę Cognitive Services OpenAI User lub Cognitive Services OpenAI Contributor

Problemy z instalacją pakietu

Upewnij się, że używasz zestawu .NET 8.0 SDK lub nowszego. Uruchom polecenie , dotnet --version aby sprawdzić zainstalowaną wersję.

Program Agent Framework obsługuje Python w wersjach od 3.11 do 3.15. Python 3.10 nie jest już obsługiwana ani testowana w Python 1.24, chociaż metadane pakietu nadal zezwalają na instalację. Użyj Python 3.11 lub nowszej, a następnie uruchom polecenie python --version , aby zweryfikować aktywny interpreter.

W przypadku Python 3.14 i 3.15 wyrażenia deklaratywne Power Fx nie są obliczane. W Pythonie 3.15 pip install agent-framework pomija Redis, ponieważ usługa RedisVL wymaga wcześniejszej wersji Pythona. Hyperlight 0.8, dodatek AG-UI A2UI i DuckDB 2.x obsługują Python 3.15. Jeśli integracja nie powiedzie się, sprawdź jej Requires-Python zakres i użyj zgodnego interpretera. Aby uzyskać szczegółowe informacje, zobacz przewodnik dotyczący istotnych zmian w Python 2026.

Upewnij się, że używasz języka Go 1.26 lub nowszego. Uruchom polecenie , go version aby sprawdzić zainstalowaną wersję. Jeśli nie uda się rozwiązać zależności, uruchom go mod tidy i sprawdź, czy moduł importuje pakiety github.com/microsoft/agent-framework-go, które istnieją w obecnym SDK.

Uzyskiwanie pomocy

Jeśli nie możesz znaleźć rozwiązania tutaj, odwiedź nasze dyskusje w witrynie GitHub , aby uzyskać pomoc techniczną dla społeczności.

Następne kroki

Często zadawane pytania