

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# `EnableExplanations` 표현식
<a name="clarify-online-explainability-create-endpoint-enable"></a>

`EnableExplanations` 파라미터는 [https://jmespath.org/](https://jmespath.org/) 부울 표현식 문자열입니다. 설명 가능성 요청의 **각 레코드**에 대해 평가됩니다. 이 파라미터가 **참**인 것으로 평가되면 레코드에 대한 설명이 제공됩니다. 이 파라미터가 **거짓**으로 평가되면 설명이 생성되지 않습니다.

SageMaker Clarify는 각 레코드의 모델 컨테이너 출력을 JSON 호환 데이터 구조로 역직렬화한 다음 `EnableExplanations` 파라미터를 사용하여 데이터를 평가합니다.

**참고**  
모델 컨테이너 출력의 형식에 따라 두 가지 레코드 옵션이 있습니다.  
모델 컨테이너 출력이 CSV 형식인 경우 레코드는 JSON 배열로 로드됩니다.
모델 컨테이너 출력이 JSON 행 형식인 경우 레코드는 JSON 객체로 로드됩니다.

`EnableExplanations` 파라미터는 `InvokeEndpoint` 또는 `CreateEndpointConfig` 작업 중에 전달될 수 있는 JMESPath 표현식입니다. 제공한 JMESPath 표현식이 유효하지 않은 경우 엔드포인트 생성이 실패합니다. 표현식은 유효하지만 표현식 평가 결과가 예상치 못한 경우, 엔드포인트는 성공적으로 생성되지만 엔드포인트를 간접 호출할 때 오류가 생성됩니다. `InvokeEndpoint` API를 사용하여 `EnableExplanations` 표현식을 테스트한 다음 이를 엔드포인트 구성에 적용하세요.

다음은 유효한 `EnableExplanations` 표현식의 예제입니다. 예제에서 JMEsPath 표현식은 백틱 문자를 사용하여 리터럴을 포함합니다. 예를 들어, ``true``는 참을 의미합니다.


| 표현식(문자열 표현) | 모델 컨테이너 출력(문자열 표현) | 평가 결과(부울) | 의미 | 
| --- | --- | --- | --- | 
|  '`true`'  |  해당 사항 없음  |  True  |  온라인 설명 가능성 기능을 무조건 활성화하세요.  | 
|  '`false`'  |  해당 사항 없음  |  False  |  온라인 설명 가능성 기능을 무조건 비활성화하세요.  | 
|  '[1]>`0.5`'  |  '1,0.6'  |  True  |  모델 컨테이너는 각 레코드에 대해 예측 레이블과 확률을 출력합니다. 레코드의 확률(인덱스 1 기준)이 0.5보다 큰 경우 레코드를 설명합니다.  | 
|  'probability>`0.5`'  |  '\$1"predicted\$1label":1,"probability":0.6\$1'  |  True  |  모델 컨테이너는 각 레코드에 대해 JSON 데이터를 출력합니다. 확률이 0.5보다 큰 경우 레코드를 설명합니다.  | 
|  '\$1contains(probabilities[:-1], max(probabilities))'  |  '\$1"probabilities": [0.4, 0.1, 0.4], "labels":["고양이","개","물고기"]\$1'  |  False  |  다중 클래스 모델의 경우, 예측 레이블(최대 확률 값을 갖는 클래스)이 마지막 클래스인 경우 레코드를 설명합니다. 이 표현식은 말 그대로 최대 확률 값이 마지막 확률 목록을 제외한 나머지 확률 목록에 없음을 의미합니다.  | 