翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

`EnableExplanations` パラメータは [https://jmespath.org/](https://jmespath.org/) ブール式の文字列です。説明可能性リクエストの**各レコード**について評価されます。このパラメータが **true** と評価されると、レコードが説明されます。このパラメータが **false** と評価された場合、説明は生成されません。

SageMaker Clarify は、各レコードのモデルコンテナ出力を JSON 互換のデータ構造に逆シリアル化し、`EnableExplanations` パラメータを使用してデータを評価します。

**注意事項**  
モデルコンテナ出力の形式に応じて、レコードには 2 つのオプションがあります。  
モデルコンテナの出力が CSV 形式の場合、レコードは JSON 配列としてロードされます。
モデルコンテナの出力が JSON Lines 形式の場合、レコードは JSON オブジェクトとしてロードされます。

`EnableExplanations` パラメータは JMESPath 式で、`InvokeEndpoint` または `CreateEndpointConfig` 操作中に渡すことができます。指定した JMESPath 式が有効でない場合、エンドポイントの作成は失敗します。式は有効でも、式の評価結果が予想外のものであれば、エンドポイントは正常に作成されますが、エンドポイントが呼び出されるとエラーが生成されます。`InvokeEndpoint` API を使用して `EnableExplanations` 式をテストし、エンドポイント設定に適用します。

有効な `EnableExplanations` 式の例を次に示します。この例では、JMESPath 式はバックティック文字を使用してリテラルを囲んでいます。例えば、``true`` は true を意味します。


| エクスプレッション (文字列表現) | モデルコンテナ出力 (文字列表現) | 評価結果 (ブール値) | 意味 | 
| --- | --- | --- | --- | 
| '`true`' | (N/A) | 正 | オンライン説明可能性を無条件に有効にします。 | 
| '`false`' | (N/A) | 誤 | オンライン説明可能性を無条件に無効にします。 | 
| '[1]>`0.5`' | '1,0.6' | 正 | モデルコンテナは、レコードごとに予測ラベルと確率を出力します。確率 (インデックス 1) が 0.5 より大きいレコードを説明します。 | 
| 'probability>`0.5`' | '{"predicted\_label":1,"probability":0.6}' | 正 | モデルコンテナはレコードごとに JSON データを出力します。確率が 0.5 より大きい場合、そのレコードを説明します。 | 
| '\!contains(probabilities[:-1], max(probabilities))' | '{"probabilities": [0.4, 0.1, 0.4], "labels":["cat","dog","fish"]}' | 誤 | マルチクラスモデルの場合: 予測ラベル (最大確率値を持つクラス) が最後のクラスであれば、レコードを説明します。文字どおり、この式は、最後のものを除いて、最大確率値が確率のリストに含まれていないことを意味します。 |