Troubleshooting

Tato stránka popisuje běžné problémy a řešení při práci s rozhraním Agent Framework.

Poznámka:

Tato stránka se restrukturalizuje. Přidají se běžné scénáře řešení potíží.

Běžné problémy

Chyby ověřování

Ujistěte se, že máte pro svého poskytovatele AI nakonfigurované správné přihlašovací údaje. V případě Azure OpenAI ověřte:

• Rozhraní příkazového řádku Azure je nainstalované a ověřené (az login)
• Uživatel má roli Cognitive Services OpenAI User nebo Cognitive Services OpenAI Contributor.

Problémy s instalací balíčku

Ujistěte se, že používáte sadu .NET 8.0 SDK nebo novější. Spusťte příkaz dotnet --version pro kontrolu nainstalované verze.

Agent Framework podporuje Python 3.10 až 3.15. Python 3.10 zůstává pro tuto verzi podporován, ale je označen jako zastaralý, protože upstreamový Python 3.10 dosáhl konce životnosti. Pro nová prostředí použijte Python 3.11 nebo novější a spusťte python --version, abyste ověřili aktivní interpret.

Na Python 3.14 a 3.15 se deklarativní výrazy Power Fx nevyhodnocují. V Pythonu 3.15 pip install agent-framework funguje s omezenou sadou funkcí: Redis a Hyperlight nejsou nainstalované a doplněk AG-UI A2UI není k dispozici. Pokud se integraci nepodaří vyřešit, zkontrolujte její Requires-Python rozsah a použijte kompatibilní interpretr. Podrobnosti najdete v průvodci významnými změnami v Python 2026.

Ujistěte se, že používáte Go 1.25 nebo novější. Spusťte příkaz go version pro kontrolu nainstalované verze. Pokud se nepodaří vyřešit závislosti, spusťte go mod tidy a ověřte, že modul importuje github.com/microsoft/agent-framework-go balíčky, které existují v aktuální sadě SDK.

Získání nápovědy

Pokud tady nemůžete najít řešení, navštivte naše diskuze na GitHubu , kde najdete podporu komunity.

Další kroky

Nejčastější dotazy