Hibaelhárítás

Ez a lap az Ügynök-keretrendszer használatakor felmerülő gyakori problémákat és megoldásokat ismerteti.

Megjegyzés:

Ezt a lapot átstrukturáltuk. A rendszer hozzáadja a gyakori hibaelhárítási forgatókönyveket.

Gyakori problémák

Hitelesítési hibák

Győződjön meg arról, hogy a megfelelő hitelesítő adatok vannak konfigurálva az AI-szolgáltatóhoz. Az Azure OpenAI esetében ellenőrizze a következőt:

• Az Azure CLI telepítése és hitelesítése (az login)
• A felhasználónak Cognitive Services OpenAI User vagy Cognitive Services OpenAI Contributor szerepköre van.

Csomagtelepítéssel kapcsolatos problémák

Győződjön meg arról, hogy .NET 8.0 SDK-t vagy újabb verziót használ. Futtassa a dotnet --version parancsot a telepített verzió ellenőrzéséhez.

Az Agent Framework támogatja a Python 3.10-3.15-ös verziót. A Python 3.10 továbbra is támogatott ebben a kiadásban, de enyhén elavultnak minősül, mert a Python 3.10 elérte az életciklusa végét. Az új környezetekhez használja a Python 3.11-et vagy újabb verziót, és futtassa a python --version parancsot az aktív értelmező ellenőrzéséhez.

A Python 3.14-ben és 3.15-ben a deklaratív Power Fx-kifejezések kiértékelése nem történik meg. Python 3.15-ön a pip install agent-framework csökkentett funkciókészlettel sikeres: a Redis és a Hyperlight nincs telepítve, és az AG-UI A2UI extra nem érhető el. Ha egy integráció nem oldódik fel, ellenőrizze a Requires-Python tartományát, és használjon kompatibilis interpretert. További részletekért tekintse meg a Python 2026-os jelentős változásokról szóló útmutatót.

Győződjön meg arról, hogy a Go 1.25-ös vagy újabb verzióját használja. Futtassa a go version parancsot a telepített verzió ellenőrzéséhez. Ha a függőségek feloldása sikertelen, futtassa go mod tidy és ellenőrizze a modul importálási github.com/microsoft/agent-framework-go csomagjait, amelyek az aktuális SDK-ban léteznek.

Segítség kérése

Ha itt nem talál megoldást, látogasson el a GitHub-vitafórumokra a közösségi támogatás érdekében.

Következő lépések

FAQ