오류 코드 이해

  • 아티클

중요

Power Virtual Agents 기능 및 특징은 생성 AI에 대한 막대한 투자와 Microsoft Copilot 전반의 향상된 통합에 따라 이제 Microsoft Copilot Studio의 일부가 되었습니다.

문서 및 교육 콘텐츠를 업데이트하는 동안 일부 문서와 스크린샷에서는 Power Virtual Agents을 참조할 수 있습니다.

Copilot이 대화 중에 문제를 발견하면 발생한 특정 문제에 대한 오류 코드가 포함된 메시지로 응답합니다. Copilot 사용자는 이 오류 코드를 관리자에게 알려야 합니다.

Copilot 제작자로서 테스트 창을 사용하여 Copilot을 테스트할 때 문제가 발생하는 경우 오류 코드 외에 문제에 대한 자세한 내용이 포함된 메시지를 볼 수 있습니다. 또는 토픽 검사기 패널을 사용하여 Copilot을 검증할 수 있습니다.

오류 목록

참고

일부 오류 메시지에 사용되는 대화 상자라는 용어는 토픽을 나타냅니다.

오류 코드 Description
ContentError 토픽 내용에 오류가 있습니다.
DataLossPreventionViolation 데이터 손실 방지 위반이 있습니다.
FlowActionException 클라우드 흐름 실행 중 오류가 발생했습니다.
FlowActionBadRequest 클라우드 흐름에 대한 요청 형식이 잘못되었습니다.
FlowActionTimedOut 클라우드 흐름을 실행하는 데 100초 이상 걸리고 시간이 초과되었습니다.
InvalidContent 코드 편집기에 잘못된 콘텐츠가 추가되었습니다.
InfiniteLoopInBotContent 노드가 너무 많이 실행되었습니다.
LatestPublishedVersionNotFound 게시된 Copilot 버전을 검색할 수 없습니다.
RedirectToDisabledDialog 토픽이 비활성화된 토픽으로 리디렉션되었습니다.
RedirectToNonExistentDialog 토픽이 더 이상 존재하지 않는 다른 토픽으로 리디렉션되었습니다.
SystemError Microsoft Copilot Studio에서 시스템 오류가 발생했습니다.

ContentError

오류 메시지: 이 오류는 오류 컨텍스트를 기반으로 동적 메시지를 생성합니다.

해결 방법: 이것은 Copilot의 콘텐츠와 관련된 문제에 대한 포괄적인 오류입니다. 자세한 내용은 오류 메시지를 참조하세요.

일반적인 문제는 다음과 같습니다.

  • 노드에 필수 속성이 누락되었습니다.
  • 코드 편집기를 통해 잘못된 YAML이 추가되었습니다.
  • Power Fx 수식에 오류가 있습니다.

DataLossPreventionViolation

오류 메시지: "이 환경에서는 사용자가 Copilot을 사용하기 전에 로그인해야 합니다. 관리 > 보안 > 인증으로 이동하여 사용자가 로그인하도록 요구하는 옵션을 선택하세요."

해결 방법:

  • 환경의 DLP(데이터 손실 방지) 정책에 따라 사용자 로그인이 필요합니다. 사용자 인증 구성을 참조하세요.
  • Copilot에 사용되는 하나 이상의 커넥터가 동일한 데이터 그룹에 속하지 않습니다. Microsoft Copilot Studio커넥터를 참조하십시오.
  • Copilot에 사용되는 하나 이상의 커넥터가 테넌트 관리자에 의해 차단되었습니다.

FlowActionException

오류 메시지:

  • "Copilot 정의에 따라 출력이 예상되었음에도 흐름 {FlowName} ({FlowId})에서 출력이 수신되지 않았습니다."
  • "흐름 {FlowName}({FlowId})에서 이름이 {ItemKey}인 출력 매개 변수가 응답 데이터에서 누락되었습니다. 흐름을 새로 고치거나 흐름이 이 값을 반환하는지 확인하십시오."
  • "흐름 {FlowName}({FlowId})에서 이름이 {ItemKey}인 출력 매개 변수가 출력 스키마에서 누락되었습니다. 흐름를 새로 고치세요."

해결 방법: 흐름 오류 확인.

FlowActionBadRequest

오류 메시지:

  • "흐름 {FlowName}({FlowId})에서 이름이 {KeyName}인 매개 변수는 {ItemTypeKind} 유형으로 선언됩니다. 이 유형은 Power Automate를 호출할 때 지원되지 않습니다. 현재는 텍스트, 부울 및 숫자만 지원됩니다."
  • "흐름 {FlowName}({FlowId})의 이름이 {ItemKey}인 매개 변수가 '흐름 호출' 작업에서 누락되었습니다."
  • "{FlowName}({FlowId}) 흐름에서 이름이 {KeyName}인 매개 변수는 {ResolveType} 유형으로 평가되며, 예상 유형은 {ExpectedType}입니다."
  • "흐름 {FlowName}({FlowId})는 응답 코드 {ResponseCode}, 오류 코드: {FlowErrorCode}로 실행하지 못했습니다."

해결 방법: 흐름에 전달하는 모든 변수의 기본 유형이 매개 변수의 유형과 일치하는지 확인합니다.

FlowActionTimedOut

오류 메시지: "ID가 {FlowId}인 흐름이 시간 초과되었습니다. 오류 코드: {FlowErrorCode}"

해결 방법:흐름에 오류가 있는지 확인 하여 클라우드 흐름이 Copilot에게 반환되기 전에 실행하는 데 100초 이상 걸린 이유를 이해하세요. 백엔드 시스템에서 반환하는 쿼리와 데이터를 최적화해 보세요. 결과가 Copilot으로 전송된 후에도 일부 클라우드 흐름 논리가 계속 실행될 수 있는 경우 클라우드 흐름에서 'Microsoft Copilot Studio에 값 반환' 단계 뒤에 이러한 작업을 배치하세요.

InvalidContent

오류 메시지: "총 {TotalComponents} 구성 요소가 Copilot에 존재하지만 유효한 구성 요소가 없습니다."

해결 방법:코드 편집기 열기를 통해 콘텐츠 문제를 검토합니다.

InfiniteLoopInBotContent

오류 메시지: "{DialogId}.{TriggerId}.{ActionId} 작업이 {MaxTurnCount}회 이상 연속으로 실행되었습니다. 이는 대화 실행 주기를 나타내므로 대화 실행이 종료됩니다."

해결 방법: 토픽이 올바르게 종료되고 에스컬레이션 시스템 토픽과 같이 올바르게 끝나는 다른 토픽으로 연결되는지 확인하세요.

LatestPublishedVersionNotFound

오류 메시지: "마지막으로 게시된 Copilot 버전을 검색할 수 없습니다."

해결 방법:Copilot을 게시하세요.

RedirectToDisabledDialog

오류 메시지: "ID가 {DialogId}인 대화 상자는 정의에서 비활성화되어 있습니다. 사용하기 전에 대화 상자를 활성화하십시오."

해결 방법: 토픽을 다시 활성화하거나 리디렉션 노드를 제거합니다.

RedirectToNonExistentDialog

오류 메시지: "ID가 {DialogId}인 대화 상자를 정의에서 찾을 수 없습니다. 대화 상자가 있고 ID가 올바른지 확인하십시오."

해결 방법:새 토픽 만들기로 리디렉션하거나 리디렉션 노드를 제거합니다.

SystemError

오류 메시지: 이 오류는 오류 메시지를 생성하지 않습니다.

해결 방법:고객 지원팀에 문의하세요.