API バージョンとスコアの計算

現在、このプラグインは MSAzure text analytics API (v2) を使用していますが、現在は廃止されています。継続的な機能と互換性を確保するために、新しい v3 API に移行しています。

v2 API 応答形式:

               {
               "documents": [
               {
               "id": "1",
               "score": 0.14829033613204956
               }
               ],
               "errors": []
               }
            

v3 API 応答形式:

               {
               "documents": [
               {
               "id": "1",
               "sentiment": "negative",
               "confidenceScores": {
               "positive": 0.02,
               "neutral": 0.0,
               "negative": 0.97
               },
               "sentences": [
               {
               "sentiment": "negative",
               "confidenceScores": {
               "positive": 0.02,
               "neutral": 0.0,
               "negative": 0.97
               },
               "offset": 0,
               "length": 44,
               "text": "I love this hotel, but the service was slow."
               }
               ],
               "warnings": []
               }
               ],
               "errors": [],
               "modelVersion": "2025-01-01"
               }
            

v3 API のスコア計算

v3 API 応答形式では単一のスコアではなく信頼スコアが提供されるため、正規化されたスコアは次の式で計算されます。

スコア = (1 × 正) + (0.5 × ニュートラル) + (0.01 × 負)

この式により、次のことが保証されます。

• 信頼性が正の場合、スコアは 1 に近づきます
• 信頼度が中立の場合、スコアは 0.5 付近の中心となります
• 負の信頼度はスコアをわずかに 0 に近づけ、否定的な感情を考慮するための重み付け (0.01) を最小限に抑えます

3 つの信頼スコアの合計は常に 1 になるため、この式は -1 から 1 の範囲の一貫した値を生成し、Azure API からの感情情報の完全な組み合わせを表します。