Troubleshooting

На этой странице рассматриваются распространенные проблемы и решения при работе с Agent Framework.

Замечание

Эта страница реструктурируется. Будут добавлены распространенные сценарии устранения неполадок.

Распространенные проблемы

Ошибки аутентификации

Убедитесь, что у вас есть правильные учетные данные, настроенные для поставщика ИИ. Для Azure OpenAI проверьте следующее:

• Azure CLI устанавливается и проходит проверку подлинности (az login)
• Пользователь имеет Cognitive Services OpenAI User или Cognitive Services OpenAI Contributor роль

Проблемы с установкой пакета

Убедитесь, что вы используете пакет SDK для .NET 8.0 или более поздней версии. Запустите dotnet --version , чтобы проверить установленную версию.

Agent Framework поддерживает Python 3.11–3.15. Python 3.10 больше не поддерживается и не тестируется в версии 1.24, хотя метаданные пакета по-прежнему допускают установку. Используйте Python 3.11 или более позднюю версию и запустите python --version, чтобы проверить активный интерпретатор.

В Python 3.14 и 3.15 декларативные выражения Power Fx не оцениваются. В Python версии 3.15 pip install agent-framework не включает Redis, так как RedisVL требует более ранней версии Python. Hyperlight 0.8, дополнение AG-UI A2UI и DuckDB 2.x поддерживают Python 3.15. Если интеграцию не удается разрешить, проверьте её Requires-Python диапазон и используйте совместимый интерпретатор. Дополнительные сведения см. в руководстве по Python 2026 по значительным изменениям.

Убедитесь, что вы используете Go 1.26 или более позднюю версию. Запустите go version , чтобы проверить установленную версию. Если зависимости не удаётся разрешить, запустите go mod tidy и убедитесь, что ваш модуль импортирует github.com/microsoft/agent-framework-go пакеты, имеющиеся в текущем SDK.

Получение помощи

Если вы не можете найти решение здесь, посетите наши обсуждения GitHub для поддержки сообщества.

Дальнейшие действия

FAQ