오류 코드 이해

아티클
02/13/2025

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

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

오류 목록

참고

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

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

ContentError

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

해결 방법: 이 메시지는 에이전트의 콘텐츠와 관련된 모든 문제를 포괄하는 오류입니다. 오류 메시지에서 자세한 내용을 확인할 수 있습니다.

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

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

DataLossPreventionViolation

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

해결 방법:

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

FlowActionException

오류 메시지:

"에이전트 정의에 따라 출력이 예상되었음에도 불구하고 흐름 {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}"

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

InvalidContent

오류 메시지: "에이전트에 총 {TotalComponents}의 구성 요소가 있지만 유효한 구성 요소가 없습니다."

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

InfiniteLoopInBotContent

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

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

LatestPublishedVersionNotFound

오류 메시지: "에이전트의 최신 게시된 버전을 검색할 수 없습니다."

해결 방법:에이전트를 게시하십시오.

OutgoingMessageSizeTooBig

오류 메시지: "보내는 메시지 크기가 너무 큽니다."

해결 방법: 노드를 검토하여 JSON.stringify() 정적 메서드와 같이 많은 양의 텍스트를 포함하는 변수를 사용하고 있지 않은지 확인합니다. 이 메서드 또는 많은 양의 텍스트가 포함된 변수를 사용하는 경우 필요한 텍스트 부분만 전달하도록 노드를 수정합니다. 예를 들어 적응형 카드를 사용하여 다른 토픽에 데이터를 전달하는 경우 필요한 속성만 전달하도록 변수를 업데이트합니다.

자세한 내용은 옴니채널에서 Copilot Studio를 사용할 때의 최대 채널 데이터 메시지 크기 제한을 참조하세요.

OpenAIRateLimitReached

오류 메시지: 오류가 발생했습니다.

해결 방법: 에이전트가 생성형 답변의 응답 수에 도달했습니다. 메시지 용량을 검토하고 지원 요청을 열어 생성형 답변 속도 제한을 늘려보세요.

RedirectToDisabledDialog

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

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

RedirectToNonExistentDialog

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

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

SystemError

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

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

Error	봇 응답	해상도
2000	"사용자가 무한 루프에 갇혔습니다. `{Topic Name}`이(가) 논리적 결론에 도달했는지 확인하세요."	토픽이 제대로 종료되는지 확인하거나 에스컬레이션 시스템 토픽과 같이 올바르게 끝나는 다른 토픽으로 연결되는지 확인하세요.
2001	"봇 콘텐츠가 올바르지 않습니다."	토픽에 오류가 있는지 확인하세요.
2002	"CDS에 문제가 발생했습니다."	Dataverse에 액세스하는 동안 문제가 발생했습니다. 구성에 오류가 있는지 확인하세요. 그렇지 않으면 서비스 문제가 있을 수 있으므로 나중에 다시 시도하세요.
2003	"`{Topic Name}`의 `{Flow Name}`에 문제가 있습니다. 내용을 확인해 주세요."	오류에 대한 흐름을 확인하고 흐름 실행 기록에서 실패한 실행을 찾습니다.
2004	"`{Topic Name}`의 `{Skill Name}`에 문제가 있습니다. 내용을 확인해 주세요."	기술에 문제가 발생했습니다. 기술과 토픽에 오류가 있는지 확인하세요.
2005	"문제가 발생했습니다. 내용을 확인해 주세요."	Power Automate 흐름 템플릿에 문제가 있습니다. 흐름에 오류가 있는지 확인하세요.
2006	"봇을 찾을 수 없습니다."	봇 또는 해당 환경이 삭제되었기 때문에 봇을 찾을 수 없습니다. 새 봇을 구성하려면 에이전트 생성 및 삭제를 참조하세요. 새로운 환경을 구성하려면 Power Platform 환경 작업을 참조하세요.
2007	"봇에 작업할 수 있는 콘텐츠가 너무 많습니다."	메시지 길이 또는 토픽 수를 줄인 다음 다시 시도하세요. 콘텐츠 제한에 대해 자세히 알아보세요.
2008	"사용자의 토큰을 찾을 수 없습니다."	봇의 인증 구성에 오류가 있는지 확인하세요.
2009	"이 봇을 사용하려면 Copilot Studio에 게시하세요."	이 봇을 사용하려면 Copilot Studio에 게시하세요.
2010	"봇 콘텐츠를 검색할 수 없습니다."	콘텐츠가 삭제되었기 때문에 찾을 수 없습니다. 새 에이전트를 구성하려면 에이전트 생성 및 삭제를 참조하세요. 새로운 환경을 구성하려면 Power Platform 환경 작업을 참조하세요.
2011	"`{Topic Name}`에서 `{Skill Name}`을(를) 찾을 수 없습니다. 내용을 확인해 주세요."	기술이 삭제되었기 때문에 찾을 수 없습니다. 새 기술을 만들려면 Bot Framework 기술 구성을 참조하세요.
2012	"`{Topic Name}`에서 `{Flow Name}`을(를) 찾을 수 없습니다. 내용을 확인해 주세요."	Power Automate 흐름이 삭제되었기 때문에 찾을 수 없습니다. 새 흐름을 만들려면 흐름 만들기를 참조하세요.
2014	"번역 서비스가 응답하지 않습니다."	나중에 다시 시도하세요. 문제가 지속되면 고객 지원팀에 문의하세요.
2015	"`{Skill Name}` 호출에 대한 권한이 없습니다. 문제에 대한 기술 및 기술 사용법을 확인하세요."	기술의 구성을 확인하고 봇이 기술의 허용 목록에 추가되었는지 확인하세요.
2016	"죄송합니다. 봇을 찾을 수 없습니다."	Azure Bot Service 채널에 문제가 있습니다. 채널이 삭제되었거나 잘못 구성되었을 수 있습니다.
2017	"죄송합니다. 봇에 액세스할 수 없습니다."	Azure Bot Service 채널에 액세스할 수 없습니다. 인증 문제에 대한 채널 구성을 확인하세요.
2018	"사용자가 너무 빠르게 입력하고 있습니다."	메시지를 너무 빨리 보냈습니다. Copilot Studio 내 할당량 및 제한에 대해 자세히 알아보세요.
2019	"환경을 찾을 수 없습니다." 삭제되었을 수 있습니다."	환경이 삭제되었습니다. 새로운 환경을 구성하려면 Power Platform 환경 작업을 참조하세요.
2020	"오류가 발생하여 `{Flow Name}`이(가) `{Topic Name}`에서 동작하지 않습니다. 나중에 다시 시도하세요. 문제가 지속하면 흐름 설정과 실행 기록을 확인하세요."	Power Automate 흐름이 작동하지 않습니다. 나중에 다시 시도하세요. 문제가 지속되면 오류가 있는지 흐름을 확인하세요.
2021	"현재 차례에서 실행된 대화 상자 수가 최대값 `{Dialog Limit}`을(를) 초과했습니다."	기본적으로 최대 토픽 수는 50개입니다. 토픽 수를 줄인 다음 다시 시도하세요.
2022	"봇이 이번 차례에 `{Message Limit}`개가 넘는 메시지를 보냈습니다."	턴당 메시지를 30개 미만으로 제한합니다.
2023	"Composer 대화를 실행하는 중에 문제가 발생했습니다."	오류가 있는지 Composer 대화 상자를 확인하세요.
2024	"이 환경에서는 사용자가 봇을 사용하기 전에 로그인해야 합니다. 관리 > 보안 > 인증으로 이동하여 사용자가 로그인해야 하는 옵션을 선택하세요."	환경의 DLP(데이터 손실 방지) 정책에 따라 사용자가 로그인해야 합니다. 사용자에게 로그인을 요구하는 방법을 알아보려면 사용자 인증 구성을 참조하세요.
2025	"`{Topic Name}` 토픽에 빈 노드가 하나 이상 있습니다. 내용을 확인해 주세요."	빈 노드에 컨텐츠를 추가하거나 토픽에서 제거하세요.
2025	"`{Topic Name}`이(가) 꺼져 있는 토픽으로 리디렉션되고 있습니다. `{Topic Name}`(으)로 돌아가서 콘텐츠를 검사하세요."	토픽이 꺼져 있는 다른 토픽으로 리디렉션되고 있습니다. 다른 토픽 켜거나 리디렉션 노드를 제거하세요.
2025	"리디렉션하려는 토픽이 더 이상 존재하지 않습니다. `{Topic Name}`(으)로 돌아가서 콘텐츠를 검사하세요."	리디렉션하려는 토픽이 더 이상 존재하지 않습니다. 리디렉션 노드로 제거하거나 리디렉션할 새 토픽을 만드세요.
2026	"Power Automate 흐름에 문제가 있습니다. 내용을 확인해 주세요."	흐름에 오류가 있는지 확인하세요.
2030	"Power Automate 흐름 실행 기록을 확인하고 해당 흐름이 성공적으로 실행되었는지 확인하세요."
2101	"봇과 사용자의 대화가 너무 길거나 사용자의 메시지가 너무 깁니다."	봇과의 대화를 다시 시작하거나 더 짧은 메시지를 사용해 보세요.
2102	"사용자가 처리하기에 너무 큰 메시지를 보냈습니다."	처리하기에 너무 큰 메시지를 보냈습니다. 메시지를 줄인 다음 다시 시도하세요.
3000	"예기치 않은 오류"	시스템 오류가 발생했습니다. 자세한 내용은 고객 지원팀에 문의하세요.
3001	"현재 흐름 `{Flow Name}`에서 Power Automate를 사용할 수 없습니다. 나중에 다시 시도하세요."	Power Automate가 응답하지 않습니다. 봇과의 대화를 다시 시작하고 다시 시도하세요. 문제가 지속되면 고객 지원팀에 문의하세요.
3002	"Power Automate에 문제가 발생하여 흐름 `{Flow Name}`에 대한 요청이 수락되지 않았습니다. 나중에 다시 시도하세요."	Power Automate에 문제가 발생하여 흐름에 대한 요청이 수락되지 않았습니다. 흐름에 대한 응답이 있기까지 2분 이상 걸릴 수 있습니다.
3003	"흐름 `{Flow Name}`에 연결하는 중에 네트워크 문제가 발생했습니다. 나중에 다시 시도하세요."	나중에 다시 시도하세요. 문제가 지속되면 고객 지원팀에 문의하세요.

Error	봇 응답	해상도
2100	"사용자가 너무 빠르게 입력하고 있습니다."	봇과의 상호 작용은 스팸을 완화하기 위해 비율이 제한됩니다. 천천히 입력하면서 다시 시도하세요.

다음을 통해 공유