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.11 až 3.15. Python 3.10 už není v Pythonu 1.24 podporován ani testován, i když metadata balíčků stále umožňují instalaci. Použijte Python 3.11 nebo novější a spuštěním python --version ověřte aktivní interpret.

Na Python 3.14 a 3.15 se deklarativní výrazy Power Fx nevyhodnocují. V Pythonu 3.15 pip install agent-framework vynechá Redis, protože RedisVL vyžaduje starší verzi Pythonu. Hyperlight 0.8, doplněk AG-UI A2UI a DuckDB 2.x podporují Python 3.15. 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.26 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