이 핸즈온랩은 교육 내용을 보여 드리기 위한 예시입니다. 실제 교육과정에서는 고객사의 산업과 직무를 반영한 실습 시나리오로 구성한 비공개 학습 사이트를 따로 제공합니다.
M3-6. 문제 해결 — 자주 겪는 오류와 진단 순서
한 줄 요약 — 진단은 Overview의 Agent status부터 시작합니다. 그다음은 게시 오류(소스 한도) · 트리거 미매칭 · 도구 인증 · 플로우 실패 네 가지로 나눠 봅니다 — 오류 코드·플로우 체커·추적 도구로 감이 아니라 로그로 진단하세요.
1. 첫 단계 — Overview의 Agent status (preview)
에이전트 Overview 페이지의 Copilot details 카드 아래에 Agent status 요약이 있습니다. 게시·런타임 준비 상태에 영향을 주는 문제를 한 곳에 모아 심각도별로 보여 줍니다.
| 심각도 | 의미 |
|---|---|
| Blocking | 게시나 정상 동작을 막는 문제 — 가장 먼저 해결 |
| Warning | 게시는 되지만 동작이나 규정 준수에 영향을 줌 |
| Info | 참고용 안내 — 준비 상태에는 영향 없음 |
Review를 누르면 문제별로 심각도 · 메시지 · 적용 상태(초안/게시본/양쪽) · 출처(External·Authentication·Models·Permissions 등) · 조치가 표로 정리됩니다. Blocking·Warning이 없으면 초록색 ready 배지가 표시됩니다.
정책으로 차단된 도구·커넥터·채널도 여기에 함께 표시됩니다 — Tools 페이지에서는 비활성 카드로 보이고, 정보 아이콘을 누르면 차단 사유를 확인할 수 있습니다 (M3-2 채널 통제 참조).
Agent status는 메이커용 진단 요약이며, 관리자용 거버넌스·컴플라이언스 리포트를 대체하지는 않습니다.
2. 게시 실패 — 지식 소스 한도
증상 — ErrorCode: TooManyPublicSiteSearchSources / “You’ve exceeded the limit of Bing sources (4)”
원인 — 공개 웹사이트 소스 한도를 넘었습니다.
| 위치 | 한도 |
|---|---|
| 생성형 오케스트레이션 (에이전트 수준) | 25 |
| 클래식 오케스트레이션 (에이전트 수준) | 4 |
| 생성형 답변 노드 (오케스트레이션 무관) | 4 |
해결 — Topics에서 오류 있는 토픽 → Create generative answers 노드의 소스를 4개 이하로 조정 → 저장 → 다른 토픽도 확인 → 다시 게시.
3. 토픽이 실행되지 않을 때 — 트리거 진단
- 테스트 채팅 + 토픽 추적으로 실제로 어느 토픽이 실행되는지 확인
- 클래식 — 트리거 구문이 부족하거나 다른 토픽과 겹치는지 검토 (M2-4)
- 생성형 — 토픽 설명이 모호하거나 다른 토픽·도구 설명과 겹치는지 검토
- 발화를 바꿔 가며 재현 — 실제 사용자 표현( M3-4 분석)으로 보강
4. 도구·커넥터 오류
- 대화 중 도구 문제가 생기면 에이전트가 오류 메시지(오류 코드 포함)로 응답합니다 — 오류 코드 목록 참조
- 연결(connection) 상태 확인 — 연결 만료나 권한 부족이 흔한 원인
- 인증이 없는 채널에서는 사용자 자격 증명 도구가 동작하지 않습니다 (M3-3)
- 데이터 정책·고급 커넥터 정책으로 차단된 도구는 Agent status와 Tools 페이지에 표시됩니다
- 도구를 바꾼 뒤에는 반드시 다시 테스트
5. 에이전트 플로우 실패
- 플로우 디자이너의 플로우 체커(flow checker) — 플로우 문제 대부분을 미리 알려 줌
- 실행 기록(run history) — 실패한 실행을 열어 실패 작업의 입력·출력 확인
- 용량 소진으로 새 실행이 차단되지 않았는지 확인 (M3-5) — 이때 에이전트 자체는 정상 동작하고 플로우만 막히므로 증상이 헷갈립니다
- CMK(고객 관리형 키) 환경에서는 사용자 자격 증명으로 실행하는 데 제약이 있음 — run-only 설정을 특정 연결로 지정
화면 구성 예시 — 실제 화면·명칭은 버전에 따라 다를 수 있습니다
6. 진단 순서 요약
문제 발생
→ Overview의 Agent status 확인 (Blocking → Warning 순)
→ 재현 (테스트 채팅 + 추적)
→ 계층 확인: 트리거? 노드 로직(변수 패널)? 지식(인용)? 도구(오류 코드)? 플로우(실행 기록)?
→ 해당 계층 수정 → 재테스트 → 재게시
핵심 정리
- 진단은 Overview → Agent status에서 시작 — Blocking부터 처리하면 절반은 해결됩니다
- 게시 실패의 가장 흔한 원인은 생성형 답변 노드 소스 한도 4개 초과
- 진단은 추적·변수 패널·오류 코드·실행 기록 — 로그를 먼저 보세요
- 수정 후 다시 테스트 → 다시 게시까지가 한 사이클입니다
M3 운영으로 · 다음 모듈: M4. 실습 Lab
출처: Review agent readiness and issue status (MS Learn) · Publish agent fails due to Bing sources (MS Learn) · Error codes (MS Learn) · Call an agent flow from an agent — Troubleshoot (MS Learn)