에이전트가 대화 중에 문제가 발생하면 에이전트는 발생한 특정 문제에 대한 오류 코드가 포함된 메시지로 응답합니다. 에이전트 사용자는 이 오류 코드를 관리자에게 제공해야 합니다.
에이전트 제작자는 에이전트를 테스트하는 테스트 창을 사용할 때 문제가 발생하는 경우 오류 코드 외에도 문제에 대한 자세한 컨텍스트가 포함된 메시지를 볼 수 있습니다. 또는 토픽 검사기 패널을 사용하여 에이전트의 유효성을 검사할 수 있습니다.
오류 목록
참고
일부 오류 메시지에 사용되는 대화 상자라는 용어는 토픽을 나타냅니다.
| 오류 코드 | 설명 |
|---|---|
| AsyncResponsePayloadTooLarge | 커넥터의 출력과 관련된 오류가 있습니다. |
| ContentError | 토픽 내용에 오류가 있습니다. |
| 데이터 손실 방지 위반 | 데이터 손실 방지 위반이 있습니다. |
| EnforcementMessageC2 | 선불 용량이 부족했습니다. |
| FlowActionException | 클라우드 흐름 실행 중 오류가 발생했습니다. |
| FlowActionBadRequest | 클라우드 흐름에 대한 요청 형식이 잘못되었습니다. |
| FlowActionTimedOut | 클라우드 흐름을 실행하는 데 100초 이상 걸리고 시간이 초과되었습니다. |
| GenAISearchandSummarizeRateLimitReached | 생성 AI에 대한 사용 제한에 도달했습니다. |
| GenAIToolPlannerRateLimit에 도달했습니다 | 생성 오케스트레이션에 대한 사용 제한에 도달했습니다. |
| InvalidContent | 코드 편집기에 잘못된 콘텐츠가 추가되었습니다. |
| InfiniteLoopInBotContent | 노드가 너무 많이 실행되었습니다. |
| LatestPublishedVersionNotFound | 에이전트의 게시된 버전을 검색할 수 없습니다. |
| 발신 메시지 크기가 너무 큽니다 | 에이전트에서 보낸 메시지가 너무 커서 처리할 수 없습니다. |
| 처리하기에 너무 많은 데이터 | 사용자의 요청이 너무 커서 처리할 수 없습니다. |
| OpenAI 사용 한도에 도달했습니다 | 에이전트의 용량 제한에 도달했습니다. |
| 비활성화된 대화 상자로 리디렉션 | 토픽이 비활성화된 토픽으로 리디렉션되었습니다. |
| 존재하지 않는 대화 상자로 리디렉션 | 토픽이 더 이상 존재하지 않는 다른 토픽으로 리디렉션되었습니다. |
| SystemError | Copilot Studio에서 시스템 오류가 발생했습니다. |
비동기 응답 페이로드가 너무 큼
오류 메시지: 커넥터에서 반환된 출력이 너무 커서 에이전트에서 처리할 수 없었다. 사용 가능한 커넥터 필터를 활용하거나 구성된 작업 출력 수를 제한하여 크기를 줄이십시오.
해상도: 에이전트의 실시간 커넥터 중 하나는 에이전트가 처리할 수 있는 것보다 큰 페이로드를 반환하는 것입니다. 페이로드 제한에 대한 자세한 내용은 Copilot Studio 웹앱 제한을 참조하세요.
ContentError
오류 메시지: 이 오류는 오류 컨텍스트를 기반으로 동적 메시지를 생성합니다.
해결 방법: 이 메시지는 에이전트의 콘텐츠와 관련된 모든 문제를 포괄하는 오류입니다. 오류 메시지에서 자세한 내용을 확인할 수 있습니다.
일반적인 문제는 다음과 같습니다.
- 노드에 필수 속성이 누락되었습니다.
- 코드 편집기를 통해 잘못된 YAML이 추가되었습니다.
- Power Fx 수식에 오류가 있습니다.
데이터 손실 방지 위반
오류 메시지: 이 환경에서는 사용자가 에이전트를 사용하기 전에 로그인해야 합니다. 보안 > 인증 관리 > 로 이동하여 사용자가 로그인해야 하는 옵션을 선택합니다.
해결 방법:
- 환경의 DLP(데이터 손실 방지) 정책에 따라 사용자 로그인이 필요합니다. 로그인으로 사용자 인증 추가 시스템 토픽을 참조하세요.
- 에이전트에서 사용되는 하나 이상의 커넥터가 동일한 데이터 그룹에 없습니다. Copilot Studio 커넥터를 참조하십시오.
- 에이전트에 사용되는 하나 이상의 커넥터가 테넌트 관리자에 의해 차단되었습니다.
EnforcementMessageC2
오류 메시지: 이 에이전트는 현재 사용할 수 없습니다. 사용 제한에 도달했습니다. 나중에 다시 시도하세요.
해상도: 이 메시지는 에이전트가 메시지 용량에 도달했거나 종량제 미터가 한도에 도달하면 반환됩니다. 선불 용량을 더 추가하거나 종량제 청구 계획을 설정하세요. 5분 이내에 에이전트 채팅이 다시 작동합니다. 자세한 내용은 초과분 적용으로 이동하세요.
FlowActionException (플로우 액션 예외)
오류 메시지:
- 에이전트 정의에 따라 출력이 예상되더라도 흐름 {FlowName}({FlowId})에서 출력을 받지 못했습니다.
- 흐름 {FlowName}({FlowId})에 이름이 {ItemKey}인 출력 매개 변수가 응답 데이터에서 누락되었습니다. 흐름을 새로 고치거나 흐름이 이 값을 반환하는지 확인합니다.
- 흐름 {FlowName}({FlowId})에 이름이 {ItemKey}인 출력 매개 변수가 출력 스키마에서 누락되었습니다. 흐름을 새로 고치세요.
해결 방법: 흐름 오류 확인.
FlowAction잘못된요청
오류 메시지:
- 흐름 {FlowName}({FlowId})에 이름이 {KeyName}인 매개 변수는 {ItemTypeKind} 형식으로 선언됩니다. 이 유형은 Power Automate를 호출할 때 지원되지 않습니다. 현재는 텍스트, 부울 및 숫자만 지원됩니다.
- 흐름 {FlowName}({FlowId})에 이름이 {ItemKey}인 매개 변수가 '흐름 호출' 작업에 없습니다.
- 흐름 {FlowName}({FlowId})에 이름이 {KeyName}인 매개 변수가 {ResolveType}(예상 형식 {ExpectedType})으로 평가되었습니다.
- 흐름 {FlowName}({FlowId})이(가) 응답 코드 {ResponseCode}( 오류 코드: {FlowErrorCode})로 실행되지 못했습니다.
해결 방법: 흐름에 전달하는 모든 변수의 기본 유형이 매개 변수의 유형과 일치하는지 확인합니다.
FlowActionTimedOut
오류 메시지: ID가 {FlowId}인 흐름의 시간이 초과되었습니다. 오류 코드: {FlowErrorCode}
해결 방법: 흐름에 오류가 있는지 확인하여 클라우드 흐름이 에이전트에 반환되기 전에 실행하는 데 100초 이상 걸린 이유를 이해합니다. 백엔드 시스템에서 반환하는 쿼리와 데이터를 최적화해 보세요. 결과가 에이전트로 전송된 후에도 일부 클라우드 흐름 로직을 계속 실행할 수 있는 경우 클라우드 흐름의 'Copilot Studio에 값 반환' 단계 뒤에 이러한 작업을 배치합니다.
GenAISearchandSummarizeRateLimitReached
오류 메시지: 검색 및 요약에 대한 사용 제한에 도달했습니다. 나중에 다시 시도하세요.
해상도: 이 메시지는 에이전트가 원본을 검색하고 요약하기 위해 생성 AI 제한 에 도달하면 반환됩니다.
GenAIToolPlanner 사용 한도 초과
오류 메시지: 생성 오케스트레이션에 대한 사용 제한에 도달했습니다. 나중에 다시 시도하세요.
해상도: 이 메시지는 에이전트가 생성 오케스트레이션 제한에 도달하면 반환됩니다.
유효하지 않은 콘텐츠
오류 메시지: 에이전트에는 총 {TotalComponents} 구성 요소가 있지만 유효한 구성 요소는 없습니다.
해결 방법: 코드 편집기 열기를 통해 콘텐츠 문제를 검토합니다.
InfiniteLoopInBotContent
오류 메시지: 작업 {DialogId}. {TriggerId}. {ActionId}이(가) 한 행에 {MaxTurnCount}번 이상 실행되었습니다. 이는 대화 상자 실행 주기를 나타내므로 대화 실행이 종료됩니다.
해결 방법: 토픽이 올바르게 종료되고 에스컬레이션 시스템 토픽과 같이 올바르게 끝나는 다른 토픽으로 연결되는지 확인하세요.
최신 게시 버전을 찾을 수 없습니다
오류 메시지: 에이전트의 최신 게시된 버전을 검색할 수 없습니다.
해결 방법:에이전트를 게시하십시오.
발신 메시지 크기가 너무 큽니다
오류 메시지: 보내는 메시지 크기가 너무 큽합니다.
해결 방법: 노드를 검토하여 JSON.stringify() 정적 메서드와 같이 많은 양의 텍스트를 포함하는 변수를 사용하고 있지 않은지 확인합니다. 이 메서드 또는 많은 양의 텍스트가 포함된 변수를 사용하는 경우 필요한 텍스트 부분만 전달하도록 노드를 수정합니다. 예를 들어 적응형 카드를 사용하여 다른 토픽에 데이터를 전달하는 경우 필요한 속성만 전달하도록 변수를 업데이트합니다.
자세한 내용은 옴니채널에서 Copilot Studio를 사용할 때의 최대 채널 데이터 메시지 크기 제한을 참조하세요.
OpenAIRateLimitReached
오류 메시지: 오류가 발생했습니다.
해결 방법: 에이전트가 생성형 답변의 응답 수에 도달했습니다. 메시지 용량을 검토하고 지원 요청을 열어 생성형 답변 속도 제한을 늘려보세요.
비활성 대화상자로 리디렉션
오류 메시지: ID가 {DialogId}인 대화 상자가 정의에서 비활성화되었습니다. 대화 상자를 사용하기 전에 설정하세요.
해결 방법: 토픽을 다시 활성화하거나 리디렉션 노드를 제거합니다.
존재하지 않는 대화 상자로 리디렉션
오류 메시지: ID가 {DialogId}인 대화 상자가 정의에 없습니다. 대화 상자가 있고 ID가 올바른지 확인하세요.
해결 방법: 새 토픽 만들기로 리디렉션하거나 리디렉션 노드를 제거합니다.
시스템 오류
오류 메시지: 이 오류는 오류 메시지를 생성하지 않습니다.
해결 방법:고객 지원팀에 문의하세요.
다루기에 과도한 데이터
오류 메시지: 요청으로 인해 처리할 데이터가 너무 많아집니다. 작업에서 반환되는 데이터의 양을 평가하세요.
해결 방법: 이는 OpenAI로 전송되는 요청이 허용된 최대 요청 크기를 초과하고 있음을 나타냅니다. 요청을 구성하는 요소에는 사용자 입력, 이전 작업의 출력, 호출된 도구, 대화 기록 등이 있습니다. 사용 중인 도구를 검토하고, 가능한 경우 필요한 필드로만 출력 범위를 축소합니다. 자세한 내용은 Power Automate 흐름 만들기 및 작업으로 Power Automate 흐름 호출하기를 참조하세요.