CanRobot · 캔로봇
Microsoft Frontier Transformation Engineer TITAN Microsoft Certified Trainer Microsoft MVP 2025

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는 메이커용 진단 요약이며, 관리자용 거버넌스·컴플라이언스 리포트를 대체하지는 않습니다.

Agent status 심각도 3단계

2. 게시 실패 — 지식 소스 한도

증상 — ErrorCode: TooManyPublicSiteSearchSources / “You’ve exceeded the limit of Bing sources (4)”

원인 — 공개 웹사이트 소스 한도 초과:

위치 한도
생성형 오케스트레이션 (에이전트 수준) 25
클래식 오케스트레이션 (에이전트 수준) 4
생성형 답변 노드 (오케스트레이션 무관) 4

해결 — Topics에서 오류 있는 토픽 → Create generative answers 노드의 소스를 4개 이하로 조정 → 저장 → 다른 토픽도 확인 → 재게시.

3. 토픽이 안 뜬다 — 트리거 진단

  1. 테스트 채팅 + 토픽 추적으로 실제 어느 토픽이 트리거되는지 확인
  2. 클래식 — 트리거 구문이 부족하거나 다른 토픽과 겹치는지 검토 (M2-4)
  3. 생성형 — 토픽 설명이 모호하거나 다른 토픽·도구 설명과 겹치는지 검토
  4. 발화를 바꿔가며 재현 — 실제 사용자 표현( M3-4 분석)으로 보강

4. 도구·커넥터 오류

  • 대화 중 도구 문제가 생기면 에이전트가 오류 메시지(오류 코드 포함)로 응답합니다 — 오류 코드 목록 참조
  • 연결(connection) 상태 확인 — 만료·권한 부족이 흔한 원인
  • 무인증 채널 + 사용자 자격 증명 도구 조합은 동작하지 않습니다 (M3-3)
  • 데이터 정책·고급 커넥터 정책으로 차단된 도구는 Agent status와 Tools 페이지에 표시됩니다
  • 도구를 바꾼 뒤에는 반드시 재테스트

5. 에이전트 플로우 실패

  1. 플로우 디자이너의 플로우 체커(flow checker) — 대부분의 플로우 문제를 사전에 지적
  2. 실행 기록(run history) — 실패한 실행을 열어 실패 작업의 입력·출력 확인
  3. 용량 소진으로 새 실행이 차단되지 않았는지 확인 (M3-5) — 이때 에이전트 자체는 정상 동작하고 플로우만 막히므로 증상이 헷갈립니다
  4. CMK(고객 관리형 키) 환경은 사용자 자격 증명 실행 제약 — run-only 설정을 특정 연결로 지정

플로우 체커 화면 구성 예시 — 실제 화면·명칭은 버전에 따라 다를 수 있습니다

6. 진단 순서 요약

문제 발생
  → Overview의 Agent status 확인 (Blocking → Warning 순)
  → 재현 (테스트 채팅 + 추적)
  → 계층 확인: 트리거? 노드 로직(변수 패널)? 지식(인용)? 도구(오류 코드)? 플로우(실행 기록)?
  → 해당 계층 수정 → 재테스트 → 재게시

진단 순서

핵심 정리

  1. 진단의 출발점은 Overview → Agent status — Blocking부터 처리하면 절반은 끝납니다
  2. 게시 실패 1순위 원인 = 생성형 답변 노드 소스 한도 4 초과
  3. 진단은 추적·변수 패널·오류 코드·실행 기록 — 로그를 먼저 보세요
  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)