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 3.10–3.15. Python 3.10 pozostaje obsługiwana w tej wersji, ale jest objęta miękkim wycofaniem, ponieważ projekt Python 3.10 osiągnął koniec wsparcia. Użyj Python 3.11 lub nowszej dla nowych środowisk i 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 wersji Python 3.15 pip install agent-framework działa z ograniczonym zestawem funkcji: Redis i Hyperlight nie są zainstalowane, a opcjonalny pakiet AG-UI A2UI jest niedostępny. 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 w wersji 1.25 lub nowszej. 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