Agent 365 문제 해결 가이드

이 가이드를 Agent 365 개발 라이프사이클 전체에 걸쳐 발생하는 문제를 진단하고 해결하는 데 사용하세요. 이 문서를 문제 해결의 시작점으로 사용하시고, 자세한 해결 방법은 구체적인 섹션에서 확인하세요.

문제 해결 단계

이 표의 각 링크는 특정 영역에 대한 문제 해결 단계를 제공합니다. 내용은 Agent 365 SDK 개발 라이프사이클의 단계별로 분류되어 있습니다.

단계 문제 해결 콘텐츠
에이전트 빌드 및 실행 Agent 365 CLI
Agent 365 CLI용 맞춤 클라이언트 앱 등록
모의 툴 서버
에이전트 가시성
에이전트 테스트
개발 터널로 에이전트 테스트
토픽 추가 및 관리
에이전트 블루프린트 설정 에이전트 블루프린트 설정
배포 Azure에 에이전트 배포
Amazon Web Services (AWS)에 에이전트 배포
Google Cloud Platform (GCP)에 에이전트 배포
Microsoft 365 관리 센터에 에이전트 게시 Microsoft 관리 센터에 에이전트 게시
에이전트 인스턴스 생성 에이전트 인스턴스 생성

진단 명령어 참조

구체적인 문제에 들어가기 전에, 다음 명령어를 사용해 Agent 365 설정의 현재 상태를 확인해 보세요:

CLI 및 구성 확인

이 명령들을 사용해 CLI와 구성을 검증하세요.

# Verify CLI is installed and check version
a365 --version

# Display current configuration
Get-Content a365.config.json | ConvertFrom-Json

# Display generated configuration (after setup)
Get-Content a365.generated.config.json | ConvertFrom-Json

Azure 리소스 확인

이 명령어들을 사용해 Azure 리소스와 앱 상태를 점검하세요.

# Set these variables with appropriate data for your app
$resource-group = <your-resource-group>
$app-name = <your-app-name>

# Authenticate with Azure
az login

# List resources in your resource group
az resource list --resource-group $resource-group --output table

# Check Web App status
az webapp show --name $app-name --resource-group $resource-group --query state

# View Web App logs (real-time)
az webapp log tail --name $app-name --resource-group $resource-group

에이전트 청사진 확인

에이전트 청사진이 존재하고 올바르게 설정되어 있는지 확인하세요.

# Check if blueprint ID is set
Get-Content a365.generated.config.json | Select-String "agentBlueprintId"

Microsoft Entra에서 블루프린트를 검증하세요

  1. https://entra.microsoft.com > 앱 등록>모든 애플리케이션으로 이동하세요.
  2. agentBlueprintId을 검색합니다.

예방 모범 사례

이러한 권고사항을 활용해 흔한 문제를 예방하고 문제 해결을 간소화하세요.

시작하기 전

전제 조건 체크리스트:

✅ .NET 8.0 SDK 설치됨
✅ Azure CLI 설치 및 인증 완료
✅ Entra에 할당된 필수 권한
✅ 사용자 지정 클라이언트 앱 생성 및 설정
✅ 테넌트 활성화됨 (Microsoft Agent 365 Frontier)

검증 명령어:

# Check .NET
dotnet --version

# Check Azure CLI
az --version
az account show

# Check CLI installation
a365 --version

개발 중

구성 저장:

  • 구성 파일을 백업해 두세요.
  • 설정 선택사항을 기록하세요.
  • 블루프린트(blueprint) ID 및 관리형 ID 등 생성된 ID를 저장하세요.

CLI를 최신 상태로 유지:

dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli

점진적으로 테스트하세요:

  • 주요 단계마다 테스트하세요.
  • 다음 단계로 넘어가기 전에 성공을 확인하세요.
  • 계속 작동하는 설정을 유지하세요.

배포 전

사전 배포 체크리스트:

✅에이전트가 Agents Playground에서 로컬로 동작합니다.
✅ 모든 환경 변수 문서화됨.
✅ 구성 파일이 소스 컨트롤에 커밋되었습니다.
✅ MCP 서버 설정 및 테스트 완료.
✅ 가시성 활성화 및 검증 완료.

추가 도움말 얻기

샘플 코드를 검토하거나 문제를 보고하거나 기존 문제를 검색하려면 다음 저장소를 사용하세요:

  • Last updated on