M3-6. 문제 해결 — 자주 만나는 오류와 진단 순서

한 줄 요약 — 문제의 대부분은 게시 오류(소스 한도) · 트리거 미매칭 · 도구 인증 · 플로우 실패 네 갈래입니다. 오류 코드·플로우 체커·추적 도구로 감이 아니라 로그로 진단하세요.

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

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

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

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

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

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

3. 도구·커넥터 오류

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

4. 에이전트 플로우 실패

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

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

5. 진단 순서 요약

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

핵심 정리

1. 게시 실패 1순위 원인 = 생성형 답변 노드 소스 한도 4 초과
2. 진단은 추적·변수 패널·오류 코드·실행 기록 — 로그를 먼저 보세요
3. 수정 후 재테스트 → 재게시까지가 한 사이클입니다

M3 운영으로 · 다음 모듈: M4. 실습 Lab

출처: Publish agent fails due to Bing sources (MS Learn) · Error codes (MS Learn) · Call an agent flow from an agent — Troubleshoot (MS Learn)