EnableExplanations 式 - Amazon SageMaker AI

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

EnableExplanations 式

EnableExplanations パラメータは JMESPath ブール式の文字列です。説明可能性リクエストの各レコードについて評価されます。このパラメータが 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"]}'

誤

マルチクラスモデルの場合: 予測ラベル (最大確率値を持つクラス) が最後のクラスであれば、レコードを説明します。文字どおり、この式は、最後のものを除いて、最大確率値が確率のリストに含まれていないことを意味します。