오류 코드 이해

AIModelActionBadRequest

오류 메시지:

• 프롬프트의 출력이 {ActualType}으로 평가되었지만, {ExpectedType}으로 예상되었습니다.

• 프롬프트 {ParameterName} 에 대한 입력 매개 변수 {PromptName} 가 없습니다.

• 프롬프트 {ParameterName} 에 대한 입력 매개 변수 {PromptName} 는 비어 있지만 필수입니다.

• 예상: {ExpectedType}. 실제: {ActualType}.

해상도: 이 오류는 프롬프트 동작이 잘못된 입력을 받거나 예기치 않은 출력 형식을 반환하는 경우에 발생합니다. 문제를 해결하려면 오류에 따라 다음 작업 중 하나를 수행합니다.

• 형식 불일치: 프롬프트 구성을 확인하여 출력 스키마가 예상 변수 형식과 일치하는지 확인합니다.
• 필요한 입력이 누락되었습니다. 모든 필수 입력이 값이 있는 변수에 연결되어 있는지 확인합니다.
• 비어 있는 필수 값: 프롬프트를 호출하기 전에 변수에 값이 있는지 확인합니다.

자세한 내용은 프롬프트 작업 만들기를 참조하세요.

AIModelActionRequestTimeout

오류 메시지: 프롬프트 prompt-name 실행 시간이 초과되었습니다.

해결 방법: AI Builder 모델에 대한 호출이 100초를 초과하지 않는지 확인합니다.

AIPluginOperationNotFound

오류 메시지: 죄송합니다. 봇은 잠시 동안 통신할 수 없습니다. 이는 봇의 소유자가 해결해야 하는 문제입니다.

해결 방법: 에이전트를 다시 게시합니다. 이 오류는 에이전트가 가져오기 또는 솔루션 배포를 통해 게시될 때 발생할 수 있습니다.

AsyncResponsePayloadTooLarge

오류 메시지: 커넥터에서 반환된 출력이 너무 커서 에이전트에서 처리할 수 없습니다. 사용 가능한 커넥터 필터를 활용하거나 구성된 작업 출력 수를 제한하여 크기를 줄이십시오.

해결 방법: 에이전트의 실시간 커넥터 중 하나는 에이전트가 처리할 수 있는 것보다 큰 페이로드를 반환하는 것입니다. 페이로드 제한에 대한 자세한 내용은 Copilot Studio 웹앱 제한을 참조하세요.

인증 미구성됨

오류 메시지:

• 이 봇에 대해 인증이 구성되지 않았습니다.

• 봇은 로그인이 필요하지만 인증을 위해 구성되지 않았습니다. 봇에 대한 인증 방법을 업데이트하세요.

• 통합 인증은 채널 {channel}에서 지원되지 않습니다.

해상도: 이 오류는 에이전트가 사용자 인증이 필요한 작업 또는 기능을 사용하지만 인증이 구성되지 않은 경우에 발생합니다. 문제를 해결하려면,

1. 에이전트에서 설정 > 보안 > 인증으로 이동합니다.
2. 적절한 인증 방법 선택: Microsoft 365 사용자에 대해 Microsoft로 인증하거나 사용자 지정 OAuth 공급자에 대해 수동으로 인증 합니다.
3. 오류가 특정 채널을 언급하는 경우 채널이 사용 중인 인증 방법을 지원하는지 확인합니다. 일부 채널은 통합 인증을 지원하지 않습니다.

자세한 내용은 사용자 인증 구성을 참조하세요.

바인딩키찾을수없음오류

오류 메시지:

• 바인딩 '{0}'을(를) 찾을 수 없습니다. 이 흐름을 새로 고쳐 최신 바인딩을 가져옵니다.
• 입력 바인딩 '{0}'을(를) 찾을 수 없습니다. 이 흐름을 새로 고쳐 최신 바인딩을 가져옵니다.
• 출력 바인딩 '{0}'을(를) 찾을 수 없습니다. 이 흐름을 새로 고쳐 최신 바인딩을 가져옵니다.

해결 방법: 에이전트 흐름 입력 및 출력이 올바르게 설정되었는지 확인합니다. 이 문제를 해결하려면 입력 또는 출력을 새로 고쳐 보세요. 작동하지 않는 경우 에이전트 흐름을 다시 설정해 봅니다.

최신 입력 및 출력을 얻으려면 에이전트 흐름을 제거하고 읽습니다.

BingSearchFailed

오류 메시지: 이것은 우리 쪽의 시스템 문제입니다. 수정할 필요가 없습니다. 오류 세부 정보: 플랫폼 런타임 - BingSearchFailed.

해결 방법: 플랫폼 쪽 Bing 검색 실패로 인해 이 문제가 발생할 수 있습니다. 나중에 다시 시도하십시오. 문제가 계속되면 지원에 문의하세요.

연결 에이전트 인증 불일치

오류 메시지: 스키마 이름을 {AgentSchemaName} 가진 연결된 에이전트에 주 에이전트와 인증 불일치가 있습니다.

해상도: 오케스트레이터 에이전트와 연결된 스바겐트는 서로 다른 인증 구성을 가지고 있습니다. 다중 에이전트 오케스트레이션이 작동하려면 두 에이전트가 호환되는 인증 설정을 사용해야 합니다. 문제를 해결하려면,

1. 두 에이전트를 모두 열고 설정 > 보안 > 인증으로 이동합니다.
2. 두 에이전트가 동일한 인증 방법을 사용하는지 확인합니다(예: 둘 다 Microsoft에서 인증 사용).
3. 수동 인증을 사용하는 경우 두 에이전트가 동일한 OAuth 공급자 및 설정을 사용하도록 구성되어 있는지 확인합니다.

다음 인증 호환성 규칙이 적용됩니다.

• 연결된 에이전트에 인증이 구성 되지 않은 경우 오케스트레이터 인증이 허용됩니다.
• 연결된 에이전트에 인증이 필요한 경우 오케스트레이터는 동일한 인증 방법을 사용해야 합니다.
• 오케스트레이터의 수동 인증(일반 OAuth2)은 인증이 필요한 연결된 에이전트와 호환되지 않습니다. 두 에이전트 모두 동일한 수동 인증 구성을 사용해야 하거나 연결된 에이전트에 인증 요구 사항이 없어야 합니다.

자세한 내용은 사용자 인증 구성 및 에이전트를 다른 에이전트의 작업으로 사용(미리 보기)을 참조하세요.

연결된 에이전트 봇을 찾을 수 없습니다

오류 메시지: 스키마 이름이 {AgentSchemaName}인 연결된 에이전트를 찾을 수 없습니다.

해상도: 이 오류는 오케스트레이터 에이전트가 연결된 하위 에이전트를 찾을 수 없는 경우 다중 에이전트 오케스트레이션에서 발생합니다. 문제를 해결하려면,

1. 연결된 에이전트가 오케스트레이터 에이전트와 동일한 환경에 있는지 확인합니다.
2. 연결된 에이전트의 스키마 이름이 오케스트레이터 구성에서 올바르게 철자되었는지 확인합니다.
3. 연결된 에이전트에 대한 액세스 권한이 있는지 확인합니다.
4. 연결된 에이전트가 최근에 만들어진 경우 몇 분 정도 기다린 다음 다시 시도합니다.

자세한 내용은 에이전트를 다른 에이전트의 작업으로 사용(미리 보기)을 참조하세요.

연결된 에이전트 봇이 게시되지 않음

오류 메시지: 스키마 이름을 {AgentSchemaName} 가진 연결된 에이전트를 호출하려면 게시해야 합니다.

해결 방법: 오케스트레이터 에이전트가 연결된 서브에이전트를 호출하려면 먼저 해당 서브에이전트가 게시되어 있어야 합니다. 문제를 해결하려면,

1. Copilot Studio에서 연결된 에이전트를 엽니다.
2. 에이전트를 게시합니다.
3. 오케스트레이터 에이전트로 돌아가서 다시 테스트합니다.

자세한 내용은 에이전트를 다른 에이전트의 작업으로 사용(미리 보기)을 참조하세요.

ConnectedAgentChainingNotSupported

오류 메시지: 에이전트 체인이 검색되었습니다. 스키마 이름이 {AgentSchemaName}인 에이전트에 연결할 수 없습니다. 에이전트가 이미 다른 에이전트와 연결되어 있습니다.

해상도: 다중 수준 에이전트 체인은 지원되지 않습니다. 오케스트레이터 에이전트는 하위 에이전트에 연결할 수 있지만, 해당 하위 에이전트는 자체적으로 연결된 에이전트를 가질 수 없습니다. 문제를 해결하려면,

1. 에이전트 아키텍처를 검토하고 계층 구조를 평면화합니다.
2. 깊이 중첩된 에이전트에서 오케스트레이터 또는 첫 번째 수준 연결된 에이전트로 기능을 이동합니다.
3. 연결된 에이전트 대신 토픽 또는 작업을 사용하는 것이 좋습니다.

자세한 내용은 에이전트를 다른 에이전트의 작업으로 사용(미리 보기)을 참조하세요.

ConnectedAgentGptComponentNotFound

오류 메시지: 스키마 이름을 {AgentSchemaName}가진 연결된 에이전트에 대한 GPT 구성 요소를 찾을 수 없습니다.

해상도: 연결된 에이전트에 필요한 설명이나 지침이 없습니다. 오케스트레이터는 연결된 에이전트를 호출할 시기를 알 수 있는 정보가 필요합니다. 문제를 해결하려면,

1. Copilot Studio에서 연결된 에이전트를 엽니다.
2. 에이전트의 개요 페이지로 이동합니다.
3. 에이전트에 명확한 설명 및 지침이 구성되어 있는지 확인합니다.
4. 변경한 후 연결된 에이전트를 게시합니다.
5. 오케스트레이터 에이전트로 돌아가서 다시 테스트합니다.

자세한 내용은 에이전트를 다른 에이전트의 작업으로 사용(미리 보기)을 참조하세요.

ConnectorPowerFxError (연결기 파워Fx 오류)

오류 메시지: Power Fx 식 평가 실패: {ErrorDetails}

해상도: 커넥터 작업에 사용되는 Power Fx 식이 올바르게 평가되지 않았습니다. 문제를 해결하려면,

1. 커넥터 작업이 포함된 항목을 엽니다.
2. 작업의 입력 매개 변수에서 Power Fx 식을 검토합니다.
3. 샘플 데이터를 사용하여 식을 테스트하여 문제를 확인합니다.
4. 수식 입력줄의 오류 표시기를 사용하여 특정 문제를 찾습니다.

일반적인 원인은 다음과 같습니다.

• 구문 오류입니다.
• 텍스트를 변환하지 않고 숫자와 비교하는 것과 같은 형식 불일치를 입력합니다.
• Null 또는 빈 값입니다. 처리를 위해 , IsBlank()또는 Coalesce(). 등의 IfError()함수를 사용합니다.
• 함수 사용이 잘못되었습니다.

자세한 내용은 Copilot Studio에서 Power Fx 사용을 참조하세요.

사용자가 제공하지 않은 동의

오류 메시지: SSO 연결에 대한 동의가 제공되지 않습니다.

해결 방법: 에이전트와 상호 작용하는 사용자는 에이전트의 SSO(Single Sign-On) 연결 프롬프트를 사용하여 연결을 확인해야 합니다.

ContentError

오류 메시지: 이 오류는 오류의 컨텍스트에 따라 동적 메시지를 생성합니다.

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

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

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

ConversationStateTooLarge

오류 메시지: 대화 상태 크기가 최대 허용 한도를 초과합니다.

해상도: 대화는 허용된 크기 제한을 초과하여 너무 많은 데이터를 해당 상태로 누적합니다. 문제를 해결하려면,

1. 토픽을 검토하고 대화 중에 변수에 저장된 데이터의 양을 줄여 변수 데이터를 줄입니다.
2. 더 이상 필요하지 않은 경우 사용하지 않는 변수를 공백으로 설정하여 지웁니다.
3. 복잡한 대화를 더 작고 집중적인 상호 작용으로 분리하여 대화 흐름을 간소화합니다.
4. 대화 변수에 큰 JSON 개체, 배열 또는 텍스트 블록을 저장하지 않습니다.

이 오류를 방지하려면 다음을 수행합니다.

• 토픽 간에 유지해야 하는 데이터에만 변수를 사용합니다.
• Power Automate 흐름을 사용하여 외부 원본에서 큰 데이터를 저장하고 검색할 것을 권장하며, 이 데이터를 대화 상태에 저장하지 않도록 하십시오.

자세한 내용은 Copilot Studio 할당량 및 제한을 참조하세요.

DataLossPreventionViolation

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

Resolution

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

DataverseFileAttachment429

오전 메시지: SharePoint 지금 요청을 제한하고 있습니다. 나중에 다시 시도하세요. 오류 세부 정보: DataverseFiles429.

해결 방법: 서비스 제한으로 인해 이 오류가 발생할 수 있습니다. 기다렸다가 다시 시도합니다.

DataverseSearchFailed

오류 메시지: 이것은 우리 쪽의 시스템 문제입니다. 수정할 필요가 없습니다. 오류 세부 정보: 플랫폼 런타임 - DataverseSearchFailed.

해결 방법: 사용자 연결 오류와 같은 Dataverse 지식 검색 실패로 인해 이 문제가 발생할 수 있습니다. 문제를 해결하려면,

1. 에이전트 기술 자료 설정을 열고 Dataverse 연결을 다시 인증합니다.
2. 사용자에게 Dataverse 지식 원본에 대한 유효한 라이선스 및 권한이 있는지 확인합니다.
3. 재인증 후에도 문제가 지속되면 지원팀에 문의하세요.

DataverseStructured401

오류 메시지: 검색에 인증 문제가 발생했습니다. 이 문제는 일반적으로 자체적으로 해결됩니다. 사용자 측에서 수정할 사항은 없습니다. 오류 세부 정보: Dataverse401.

해결 방법: 이 오류는 에이전트의 ID 또는 사용자 계정에 대한 누락된 권한을 나타낼 수 있습니다. 문제를 해결하려면,

1. 에이전트의 서비스 주체에게 필요한 Dataverse 지식 검색 권한을 부여합니다.
2. 지식 원본 환경이 에이전트의 환경과 일치하는지 확인합니다.
3. 권한 업데이트 후 다시 시도합니다.

자세한 내용은 엔터프라이즈 기술 자료 문제 해결을 참조하세요.

DataverseStructured429

오류 메시지: Dataverse는 현재 요청을 제한하고 있습니다. 나중에 다시 시도하세요. 오류 세부 정보: Dataverse429.

해결 방법: 서비스가 제한되거나 시간이 초과되었습니다. 되풀이를 줄이려면 다음을 수행합니다.

1. 지수 백오프를 사용하여 다시 시도합니다.
2. 가능한 경우 지식 원본 크기를 줄입니다.
3. 시간에 따라 큰 쿼리 로드를 분산합니다.

자세한 내용은 Microsoft Graph 제한 지침 참조하세요.

DataverseStructured500

오류 메시지: 구성 문제가 아닙니다. 해당 서비스에서 조사해야 합니다. 오류 세부 정보: Dataverse500.

해결 방법: 서비스 쪽 문제로 인해 이 오류가 발생할 수 있습니다. 나중에 다시 시도하십시오. 문제가 계속되면 지원에 문의하세요.

DataverseStructured503

오류 메시지: 구성 문제가 아닙니다. 소유 서비스는 조사해야 합니다. 오류 세부 정보: Dataverse503.

해결 방법: 임시 서비스를 사용할 수 없으면 이 오류가 발생할 수 있습니다. 나중에 다시 시도하십시오.

EnforcementMessageC2

오류 메시지: 이 에이전트는 현재 사용할 수 없습니다. 사용 제한에 도달했습니다. 나중에 다시 시도하세요.

해결 방법: 에이전트가 메시지 용량에 도달하거나 종량제 미터가 한도에 도달하면 이 메시지가 나타납니다. 이 문제를 해결하려면 선불 용량을 더 추가하거나 종량제 청구 계획을 만듭니다. 그러면 에이전트 채팅이 5분 이내에 작업을 다시 시작해야 합니다. 자세한 내용은 초과분 적용을 참조하세요.

ExecutionTimeout

오류 메시지: 이 도구 호출 시간이 초과되었습니다. 작업을 완료하는 데 너무 오래 걸렸습니다. 오류 세부 정보: 시간 제한 · 실행.

해결 방법: 장기 실행 실행 경로로 인해 이 오류가 발생할 수 있습니다. 문제를 해결하려면,

1. 큰 워크플로를 더 작은 단계로 분할합니다.
2. 쿼리 및 변환 논리를 최적화합니다.
3. 위험 경로에서 불필요한 작업을 제거합니다.
4. 비효율성에 대한 루프 및 분기 조건의 유효성을 검사합니다.

FlowActionBadRequest

오류 메시지:

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

해결 방법: 흐름에 전달하는 변수의 기본 형식 이 매개 변수 형식과 일치하는지 확인합니다. 자세한 내용은 채널의 FlowActionBadRequest 에이전트 오류를 참조하세요.

FlowActionException

오류 메시지:

• 에이전트 정의에 따라 출력이 예상되더라도 흐름 {FlowName}({FlowId})에서 출력을 받지 못했습니다.
• 흐름 {FlowName}({FlowId})에 이름이 {ItemKey}인 출력 매개 변수가 응답 데이터에서 누락되었습니다. 흐름을 새로 고치거나 흐름이 이 값을 반환하는지 확인합니다.
• 흐름 {FlowName}({FlowId})에 이름이 {ItemKey}인 출력 매개 변수가 출력 스키마에서 누락되었습니다. 흐름을 새로 고치세요.

해결 방법: 흐름에서 오류를 확인합니다.

FlowActionTimedOut

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

해결 방법: 클라우드 흐름이 에이전트로 반환되기까지 100초 이상 걸리는 이유를 이해하려면 흐름에서 오류를 확인합니다. 백 엔드 시스템에서 반환하는 쿼리 및 데이터를 최적화해 봅니다. 결과가 에이전트로 전송된 후에도 일부 클라우드 흐름 논리가 계속 실행될 수 있는 경우 클라우드 흐름의 "Copilot Studio로 값 반환" 단계 후에 이러한 작업을 수행합니다.

FlowMakerConnectionBlocked

오류 메시지: 이름의 {FlowName} 흐름이 허용되지 않는 작성자 연결을 사용하고 있습니다. 오류 코드: {FlowMakerConnectionBlocked}

해결 방법: 관리자는 에이전트 흐름에서 호출된 연결에서 maker 자격 증명을 사용할 수 없습니다. Power Automate에서 흐름을 열고실행 전용 권한을 사용하여 클라우드 흐름을 공유합니다.

FoundryIQSearchFailed

오류 메시지: 이것은 우리 쪽의 시스템 문제입니다. 수정할 필요가 없습니다. 오류 세부 정보: 플랫폼 런타임 - FoundryIQSearchFailed.

해결 방법: 플랫폼 쪽 Foundry IQ 검색 실패로 인해 이 문제가 발생할 수 있습니다. 나중에 다시 시도하십시오. 문제가 계속되면 지원에 문의하세요.

GenAISearchandSummarizeRateLimitReached

오류 메시지: 검색 및 요약에 대한 사용 제한에 도달했습니다. 나중에 다시 시도하세요.

해결 방법: 에이전트는 원본을 검색하고 요약하기 위해 생성 AI 제한 에 도달하면 이 메시지를 반환합니다. 자세한 내용은 에이전트의 제한 오류 해결을 참조하세요.

GenAIToolPlannerRateLimitReached

오류 메시지: 생성 오케스트레이션에 대한 사용 제한에 도달했습니다. 나중에 다시 시도하세요.

해결 방법: 에이전트가 생성 오케스트레이션 제한에 도달하면 이 메시지를 반환합니다. 자세한 내용은 에이전트의 제한 오류 해결을 참조하세요.

HTTP400BadRequest

오류 메시지: 잘못된 요청입니다.

해결 방법: 잘못된 형식의 페이로드 또는 잘못된 매개 변수로 인해 이 오류가 발생할 수 있습니다. 문제를 해결하려면,

1. 모든 필수 매개 변수가 있는지 확인합니다.
2. 데이터 형식이 작업 스키마와 일치하는지 확인합니다.
3. 정상으로 알려진 샘플 데이터로 테스트합니다.
4. 복잡한 페이로드에 대한 JSON 서식의 유효성을 검사합니다.

HTTP 401 권한 없음

오류 메시지: 권한이 없습니다.

해결 방법: 이 오류는 인증 자격 증명이 없거나 만료되어 발생할 수 있습니다. 문제를 해결하려면,

1. 커넥터가 Copilot Studio 올바르게 구성되었는지 확인합니다.
2. OAuth 토큰이 만료되었는지 확인하고 연결을 다시 인증합니다.
3. API 키 또는 연결 설정의 유효성을 검사합니다.
4. 배포하기 전에 연결을 테스트합니다.
5. 서비스 주체 인증을 사용하는 경우 자격 증명이 회전되지 않았는지 확인합니다.

HTTP 403 접근 금지

오류 메시지: 사용할 수 없습니다.

해결 방법: 이 오류는 대상 시스템의 사용 권한이 누락되어 발생할 수 있습니다. 문제를 해결하려면,

1. 사용자 또는 앱에 필요한 역할 및 권한이 있는지 확인합니다.
2. 앱 등록 권한 및 관리자 동의 요구 사항을 확인합니다.
3. 리소스 수준 공유 및 위임 설정을 확인합니다.
4. 테넌트 및 환경 범위 지정이 올바른지 확인합니다.

HTTP 404 찾을 수 없음

오류 메시지: 찾을 수 없습니다.

해결 방법: 리소스 식별자가 없거나 잘못되면 이 오류가 발생할 수 있습니다. 문제를 해결하려면,

1. 리소스 ID 또는 URL이 올바른지 확인합니다.
2. 리소스가 여전히 있는지 확인합니다.
3. 환경 및 테넌트 선택이 올바른지 확인합니다.
4. 수동으로 입력한 ID보다 동적 리소스 선택을 선호합니다.

HTTP 408 요청 시간 초과

오류 메시지: 이 도구 호출 시간이 초과되었습니다. 작업을 완료하는 데 너무 오래 걸렸습니다. 오류 세부 정보: 시간 제한 · 실행.

해결 방법: 클라이언트 또는 네트워크 시간 제한을 초과하면 이 오류가 발생할 수 있습니다. 문제를 해결하려면,

1. 네트워크 안정성 및 대기 시간을 확인합니다.
2. 가능한 경우 페이로드 크기를 줄입니다.
3. 점진적 백오프를 적용한 재시도를 추가합니다.
4. 장기 실행 작업에는 비동기 패턴을 사용합니다.

HTTP422UnprocessableEntity

오류 메시지: 처리할 수 없는 엔터티입니다.

해결 방법: 의미 체계 유효성 검사 실패로 인해 이 오류가 발생할 수 있습니다. 문제를 해결하려면,

1. 필드 수준 형식 및 허용되는 값의 유효성을 검사합니다.
2. 도구 호출 전에 데이터 유효성 검사를 추가합니다.
3. 비즈니스 규칙 제약 조건을 확인합니다.
4. 정상으로 알려진 샘플 데이터를 사용하여 다시 시도합니다.

HTTP429TooManyRequests

오류 메시지: 요청이 너무 많습니다.

해결 방법: 제한 제한으로 인해 이 오류가 발생할 수 있습니다. 문제를 해결하려면,

1. 호출 사이에 지연을 추가합니다.
2. 지수 백오프 방식의 재시도를 구현하세요.
3. 일괄 처리 작업의 동시성을 제한합니다.
4. 헤더가 Retry-After 있는 경우 이를 존중합니다.
5. 분석에서 사용량 및 속도 제한을 모니터링합니다.

HTTP 500 내부 서버 오류

오류 메시지: 이 도구를 일시적으로 사용할 수 없습니다. 서비스가 응답하지 않았거나 현재 사용할 수 없습니다. 오류 세부 정보: 서비스 가용성 · 5xx.

해결 방법: 서비스 쪽 문제로 인해 이 오류가 발생할 수 있습니다. 문제를 해결하려면,

1. 일시적 오류가 일반적이므로 요청을 다시 시도합니다.
2. 커넥터 및 서비스 상태 대시보드에서 활성 인시던트가 있는지 확인합니다.
3. 지수 백오프를 사용하여 재시도 정책을 추가합니다.
4. 문제가 지속되면 요청 타임스탬프 및 상관 관계 세부 정보를 수집하고 지원에 문의하세요.

HTTP 502 잘못된 게이트웨이

오류 메시지: 이 도구를 일시적으로 사용할 수 없습니다. 서비스가 응답하지 않았거나 현재 사용할 수 없습니다. 오류 세부 정보: 서비스 가용성 · 5xx.

해결 방법: 업스트림 종속성에서 잘못된 응답으로 인해 이 오류가 발생할 수 있습니다. 문제를 해결하려면,

1. 잠시 기다렸다가 잠시 후에 다시 시도하세요.
2. 엔드포인트 URL 및 커넥터 구성의 유효성을 검사합니다.
3. 지수 백오프를 사용하여 재시도를 추가합니다.
4. 문제가 지속되면 공급업체 상태 페이지 및 커넥터 설명서를 확인합니다.

HTTP 503 서비스를 사용할 수 없음

오류 메시지: 이 도구를 일시적으로 사용할 수 없습니다. 서비스가 응답하지 않았거나 현재 사용할 수 없습니다. 오류 세부 정보: 서비스 가용성 · 5xx.

해결 방법: 이 오류는 임시 서비스 중단 또는 오버로드로 인해 발생할 수 있습니다. 문제를 해결하려면,

1. 나중에 더 긴 백오프를 사용하여 다시 시도합니다.
2. 계획된 유지 관리 또는 인시던트에 대한 서비스 상태를 확인합니다.
3. 서비스가 안정화될 때까지 비임계 작업을 연기합니다.
4. 반복되는 오류에 대한 회로 차단기 스타일 컨트롤을 구현합니다.

HTTP 504 게이트웨이 시간 초과

오류 메시지: 이 도구를 일시적으로 사용할 수 없습니다. 서비스가 응답하지 않았거나 현재 사용할 수 없습니다. 오류 세부 정보: 서비스 가용성 · 5xx.

해결 방법: 느린 업스트림 처리 또는 네트워크 대기 시간으로 인해 이 오류가 발생할 수 있습니다. 문제를 해결하려면,

1. 작업을 다시 시도하고 백 엔드 서비스가 시간 제한에도 불구하고 작업을 완료했는지 확인합니다.
2. 페이로드 크기를 줄이고 비용이 많이 드는 쿼리를 최적화합니다.
3. 대규모 작업을 더 작은 일괄 처리로 분할합니다.
4. 지원되는 경우 구성된 시간 제한을 늘입니다.

InfiniteLoopInBotContent

오류 메시지: 작업 {DialogId}. {TriggerId}. {ActionId}이(가) 한 행에 {MaxTurnCount}번 이상 실행되었습니다. 이는 대화 상자 실행 주기를 나타내므로 대화 실행이 종료됩니다.

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

잘못된 인증 토큰

오류 메시지: InvalidAuthenticationToken.

해결 방법: 잘못된 형식 또는 부실 토큰 데이터로 인해 이 오류가 발생할 수 있습니다. 문제를 해결하려면,

1. 연결을 제거하고 다시 만듭니다.
2. 커넥터를 다시 인증합니다.
3. 해당하는 경우 브라우저 또는 앱 캐시를 지웁다.
4. 흐름을 다시 시도합니다.

InvalidContent

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

해결 방법: 코드 편집기를 열어 콘텐츠에 영향을 주는 문제를 검토합니다.

LatestPublishedVersionNotFound

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

해결 방법: 에이전트를 게시합니다.

MsalUiException

오류 메시지: MsalUiException.

해결 방법: 자동 토큰 획득에 실패하고 대화형 로그인이 필요한 경우 이 오류가 발생할 수 있습니다. 문제를 해결하려면,

1. 로그아웃하고 다시 로그인하여 토큰을 새로 고칩니다.
2. 대화형 인증 프롬프트를 완료합니다.
3. 인증이 완료된 후 도구 호출을 다시 시도합니다.

오픈AI증오

오류 메시지: 책임 있는 AI 제한으로 인해 콘텐츠가 필터링되었습니다.

책임 있는 AI 검사는 증오로 간주되는 콘텐츠를 차단합니다. 증오 콘텐츠는 이러한 그룹의 특정 차별화 특성에 따라 개인 또는 ID 그룹에 대해 차별적인 언어를 공격하거나 사용하는 모든 콘텐츠를 나타냅니다.

이 제한은 다음에 대한 콘텐츠를 포함하지만 이에 국한되지 않습니다.

• 인종, 민족, 국적
• 성 정체성 그룹 및 표현
• 성적 취향
• 종교
• 개인 외모 및 신체 크기
• 장애 상태
• 괴롭힘 및 왕따

해결 방법: 이러한 상황을 방지하려면 에이전트 사용자와 함께 책임 있는 AI 지침을 강화합니다. 에이전트 콘텐츠 조정 정책을 업데이트할 수도 있습니다.

오픈AI제일브레이크

오류 메시지: 책임 있는 AI 제한으로 인해 콘텐츠가 필터링되었습니다.

보안 검사는 탈옥 시도의 콘텐츠를 차단합니다. 탈옥 시도는 시스템 프롬프트를 무시하고 의도한 에이전트 동작을 변경하려고 시도하는 사용자 프롬프트 공격입니다. 이러한 공격에는 시스템 규칙을 변경하고, 모델, 역할 플레이 및 인코딩 공격을 혼동하기 위한 대화 모형을 포함하려는 시도가 포함됩니다. 자세한 내용은 Azure AI 콘텐츠 안전의 프롬프트 쉴드를 참조하세요.

해결 방법: 이러한 상황을 방지하려면 에이전트 사용자와 함께 책임 있는 AI 지침을 강화합니다. 에이전트 콘텐츠 조정 정책을 업데이트할 수도 있습니다.

OpenAI 직간접 공격

오류 메시지: 책임 있는 AI 제한으로 인해 콘텐츠가 필터링되었습니다.

에이전트 작성자 또는 사용자가 직접 제공하지 않는 정보(예: 외부 문서)에서 공격이 감지되었습니다. 공격자는 다음과 같은 방식으로 악의적으로 시스템의 통제권을 얻기 위해 사용자가 제공한 근거 데이터에 지침을 삽입하려고 합니다:

• 콘텐츠 조작
• 침입
• 시스템에서 무단 데이터 반출 또는 데이터 제거
• 시스템 기능 차단
• 사기 행위
• 코드 실행 및 다른 시스템 감염

자세한 내용은 문서에 대한 프롬프트 쉴드를 참조하세요.

해결 방법: 테스트 중이고 테스트가 공격이 될 의도가 없는 경우 에이전트가 수행할 수 있는 작업과 지침이 일치하는지 확인합니다. 그렇지 않으면 에이전트 사용자와 함께 책임 있는 AI 지침을 강화하여 이러한 상황을 방지합니다.

OpenAIRateLimitReached

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

해결 방법: 에이전트가 최대 생성 응답 응답 수에 도달했습니다. 메시지 용량을 검토하고 에이전트의 제한 오류 해결 정보를 검토합니다.

OpenAISelfHarm

오류 메시지: 책임 있는 AI 제한으로 인해 콘텐츠가 필터링되었습니다.

책임 있는 AI는 자해와 관련된 차단된 콘텐츠를 확인합니다. 자해는 의도적으로 상처를 입히거나, 부상을 입히거나, 몸을 손상시키거나, 자신을 죽이기 위한 신체적 행동과 관련된 언어를 설명합니다.

이 제한은 다음에 대한 콘텐츠를 포함하지만 이에 국한되지 않습니다.

• 섭식 장애
• 괴롭힘과 협박

해결 방법: 이러한 상황을 방지하려면 에이전트 사용자와 함께 책임 있는 AI 지침을 강화합니다. 에이전트 콘텐츠 조정 정책을 업데이트할 수도 있습니다.

OpenAISexual

오류 메시지: 책임 있는 AI 제한으로 인해 콘텐츠가 필터링되었습니다.

책임 있는 AI는 성적인 것으로 간주되는 차단된 콘텐츠를 확인합니다. 성적 콘텐츠는 해부학적 장기 및 생식기, 낭만적 인 관계, 성적 행위 및 폭행이나 성폭력 행위로 묘사 된 것을 포함하여 에로틱하거나 애정 어린 용어로 묘사되는 행위와 관련된 언어를 설명합니다.

이 제한은 다음에 대한 콘텐츠를 포함하지만 이에 국한되지 않습니다.

• 저속한 콘텐츠
• 매춘
• 누드 및 포르노
• 남용
• 아동 착취, 아동 학대, 아동 그루밍

해결 방법: 이러한 상황을 방지하려면 에이전트 사용자와 함께 책임 있는 AI 지침을 강화합니다. 에이전트 콘텐츠 조정 정책을 업데이트할 수도 있습니다.

오픈AI폭력

오류 메시지: 책임 있는 AI 제한으로 인해 콘텐츠가 필터링되었습니다.

폭력적이라고 간주되어 책임 있는 AI 검사가 콘텐츠를 차단했습니다. 폭력적인 콘텐츠는 누군가 또는 무언가를 다치게 하거나, 다치거나, 손상시키거나, 죽이려는 신체적 행동과 관련된 언어를 설명합니다. 또한 무기, 총 및 관련 엔터티에 대해서도 설명합니다.

이 제한은 다음에 대한 콘텐츠를 포함하지만 이에 국한되지 않습니다.

• 무기
• 괴롭힘과 협박
• 테러리스트와 폭력적인 극단주의
• 스토킹

해결 방법: 이러한 상황을 방지하려면 에이전트 사용자와 함께 책임 있는 AI 지침을 강화합니다. 에이전트 콘텐츠 조정 정책을 업데이트할 수도 있습니다.

OperationTimeout

오류 메시지: 이 도구 호출 시간이 초과되었습니다. 작업을 완료하는 데 너무 오래 걸렸습니다. 오류 세부 정보: 시간 제한 · 실행.

해결 방법: 종속 서비스의 작업 수준 시간 제한으로 인해 이 오류가 발생할 수 있습니다. 문제를 해결하려면,

1. 쿼리 범위를 좁히고 필터링을 추가합니다.
2. 일시적인 타임아웃에 대해 백오프가 적용된 재시도를 추가합니다.
3. 큰 결과 집합에는 페이지를 나누어 표시하세요.
4. 대상 서비스 성능 및 요청 제한을 검토합니다.

OutgoingMessageSizeTooBig

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

Resolution: 파일을 전송하는 데 사용하는 채널에 따라 Direct Line 또는 Facebook과 같은 오류 메시지가 표시될 수 있습니다. "요청 콘텐츠 길이가 262,144바이트의 제한을 초과했습니다." 채널 Copilot Studio 아닌 이러한 제한을 적용합니다.

이 시나리오에서는 몇 가지 옵션을 고려합니다. 한 가지 옵션은 리소스에 대한 링크를 인터넷 첨부 파일로 제공하는 것입니다. 또 다른 옵션은 노드를 검토하여 정적 메서드와 같이 JSON.stringify() 많은 양의 텍스트가 포함된 변수를 사용하지 않도록 하는 것입니다. 이 메서드 또는 많은 양의 텍스트가 포함된 변수를 사용하는 경우 필요한 텍스트 부분만 전달하도록 노드를 수정합니다. 예를 들어 적응형 카드를 사용하여 다른 토픽에 데이터를 전달하는 경우 필요한 속성만 전달하도록 변수를 업데이트합니다.

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

할당량 초과

오류 메시지: QuotaExceeded.

해결 방법: 매월, 일별 또는 동시성 자격이 소진되면 이 오류가 발생할 수 있습니다. 문제를 해결하려면,

1. 관리 분석에서 사용량을 확인합니다.
2. 불필요한 도구 호출을 줄입니다.
3. 가능한 경우 작업을 통합합니다.
4. 필요한 경우 라이선스 또는 할당량 계획을 검토하고 업그레이드합니다.

RedirectToDisabledDialog

오류 메시지: ID가 {DialogId}인 대화 상자가 정의에서 비활성화되었습니다. 대화 상자를 사용하기 전에 설정하세요.

해결 방법: 토픽을 다시 사용하도록 설정 하거나 리디렉션 노드를 제거합니다.

RedirectToNonExistentDialog

오류 메시지: ID가 {DialogId}인 대화 상자가 정의에 없습니다. 대화 상자가 있고 ID가 올바른지 확인하세요.

해결 방법: 리디렉션 노드로 리디렉션하거나 제거할 새 토픽을 만듭니다.

SharePoint429

오전 메시지: SharePoint 지금 요청을 제한하고 있습니다. 나중에 다시 시도하세요. 오류 세부 정보: SharePoint429.

해결 방법: 서비스 제한으로 인해 이 오류가 발생할 수 있습니다. 기다렸다가 다시 시도합니다.

SharePoint500

오류 메시지: 구성 문제가 아닙니다. 소유 서비스는 조사해야 합니다. 오류 세부 정보: SharePoint500.

해결 방법: 서비스 쪽 문제로 인해 이 오류가 발생할 수 있습니다. 나중에 다시 시도하십시오. 문제가 계속되면 지원에 문의하세요.

SharePoint503

오류 메시지: 구성 문제가 아닙니다. 소유 서비스는 조사해야 합니다. 오류 세부 정보: SharePoint503.

해결 방법: 임시 서비스를 사용할 수 없으면 이 오류가 발생할 수 있습니다. 나중에 다시 시도하십시오.

SharePoint 검색 실패

오류 메시지: 이것은 우리 쪽의 시스템 문제입니다. 수정할 필요가 없습니다. 오류 세부 정보: 플랫폼 런타임 - SharePointSearchFailed.

Resolution: 플랫폼 쪽 SharePoint 검색 실패로 인해 이 문제가 발생할 수 있습니다. 나중에 다시 시도하십시오. 문제가 계속되면 지원에 문의하세요.

SystemError

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

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

TooMuchDataToHandle

오류 메시지: 요청으로 인해 처리할 데이터가 너무 많아집니다. 작업에서 반환되는 데이터의 양을 평가하세요.

해결 방법: 이 오류는 OpenAI로 전송된 요청이 허용되는 최대 요청 크기를 초과했음을 나타냅니다. 요청에는 사용자 입력, 이전 작업의 출력, 호출된 도구 및 대화 기록이 포함됩니다. 사용하는 도구를 검토합니다. 가능한 경우 출력 범위를 필요한 필드로만 지정합니다. 자세한 내용은 Power Automate 흐름 만들기 및 작업으로 Power Automate 흐름 호출하기를 참조하세요.