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.10 до 3.15. Python 3.10 по-прежнему поддерживается для этого выпуска, но не рекомендуется, так как Python 3.10 в вышестоящем проекте достиг окончания срока поддержки. Используйте Python версии 3.11 или более поздней версии для новых сред и выполните python --version, чтобы проверить активный интерпретатор.

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

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

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

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

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

FAQ