이 페이지에서는 에이전트 프레임워크로 작업할 때 발생하는 일반적인 문제 및 해결 방안에 대해 설명합니다.
비고
이 페이지는 재구성 중입니다. 일반적인 문제 해결 시나리오가 추가됩니다.
일반적인 문제
인증 오류
AI 공급자에 대해 올바른 자격 증명을 구성했는지 확인합니다. Azure OpenAI의 경우 다음을 확인합니다.
- Azure CLI가 설치 및 인증됨(
az login) - 사용자가
Cognitive Services OpenAI User또는Cognitive Services OpenAI Contributor역할을 가지고 있습니다.
패키지 설치 문제
.NET 8.0 SDK 이상을 사용하고 있는지 확인합니다. 실행 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 extra는 사용할 수 없습니다. 통합이 확인되지 않으면 해당 Requires-Python 범위를 확인하고 호환되는 인터프리터를 사용합니다. 자세한 내용은 Python 2026 중요 변경 가이드를 참조하세요.
Go 1.25 이상을 사용하고 있는지 확인합니다. 실행 go version 하여 설치된 버전을 확인합니다. 종속성 확인에 실패하면 go mod tidy를 실행하고 모듈이 현재 SDK에 있는 github.com/microsoft/agent-framework-go 패키지를 가져오는지 확인합니다.
도움말 보기
여기에서 솔루션을 찾을 수 없는 경우 커뮤니티 지원을 위해 GitHub 토론을 방문하세요.