Jev の返り値：Choice・Score・Noul を読む

まず質問 ID を確認する

一回の呼び出しで複数の独立した質問を送れます。answers は department などの ID で整理されます。順番に頼らず、ID、type、必要な項目を検査します。

Choice：選択と分布

choice は選んだキー、probabilities は各候補の確率、confidence は別の項目です。最大確率も confidence も、検証済み正解率ではありません。

Score：定義した尺度

score は criteria の尺度上の値で、probabilities は分布、legend は段階の説明です。段階の意味を確認してからコードで動作へ結び付けます。

Noul：文の確率

noul は文が成立する 0～1 の値です。confidence 項目はありません。文を否定形にすると方向が変わるため、文面とテスト例を一緒に管理します。

安全な動作に変える

検証したしきい値を超えた結果だけを取り消せる処理に使います。項目不足、不確実性、エラーは人の確認へ送ります。返金や削除には権限検査も必要です。

練習

Choice の confidence が 0.64 で、自分のデータから決めたしきい値が 0.80 なら人へ回します。この数値は説明用であり、実測値でも推奨値でもありません。

公式の返り値を項目別に見る

項目と数値は公式クイックスタートの問い合わせ例から抜粋しました。当サイトの実行結果ではありません。次の動作はコードが決めます。

{
  "answers": {
    "department": {
      "type": "choice",
      "choice": "technical",
      "confidence": 0.78,
      "probabilities": {
        "technical": 0.85,
        "sales": 0.0,
        "billing": 0.15
      }
    },
    "is_urgent": {
      "type": "noul",
      "noul": 1.0
    }
  }
}

公式資料