センチメント コグニティブ スキル (V3)

V3 センチメント のスキルは、非構造化テキストを評価し、各レコードについて、文章とドキュメントレベルでサービスによって検出された最高の信頼スコアに基づいて、センチメント ラベル ("ネガティブ"、"中立"、"ポジティブ" など) を提供します。 このスキルでは、Cognitive Services の Text Analytics のバージョン 3 によって提供される機械学習モデルが使用されます。 また、Text Analytics API のオピニオン マイニング機能も公開されており、テキストに含まれる製品やサービスの属性に関連する意見に関するより詳細な情報を提供します。

注意

このスキルは Cognitive Services にバインドされており、1 日にインデクサーあたり 20 ドキュメントを超えるトランザクションには課金対象リソースが必要です。 組み込みスキルの実行は、既存の Cognitive Services の従量課金制の価格で課金されます。

@odata.type

Microsoft.Skills.Text.V3.SentimentSkill

データ制限

レコードの最大サイズは、String.Length によって測定されるため、5,000 文字にする必要があります。 データをセンチメント スキルに送信する前に分割する必要がある場合は、テキスト分割スキルを使用します。

スキルのパラメーター

パラメーターの大文字と小文字は区別されます。

パラメーター名 説明
defaultLanguageCode (省略可能) 言語を明示的に指定しないドキュメントに適用する言語コード。
サポートされる言語の完全な一覧を参照
modelVersion (省略可能) Text Analytics サービスを呼び出すときに使用するモデルのバージョン。 指定しない場合、既定では直近のバージョンになります。 絶対に必要な場合以外は、この値を指定しないことをお勧めします。 詳細については、「Text Analytics API でのモデルのバージョン管理」を参照してください。
includeOpinionMining true に設定されている場合、 TextAnalytics の意見マイニング機能が有効になります。これにより、アスペクト ベースのセンチメント分析を出力結果に含めることができます。 既定値は false です。

スキルの入力

入力名 説明
text 分析されるテキスト。
languageCode (省略可能) レコードの言語を示す文字列。 このプロパティが指定されていない場合の既定値は "en" です。
サポートされる言語の完全な一覧を参照してください。

スキルの出力

出力名 説明
sentiment 分析されたテキスト全体のセンチメント ラベル (ポジティブ、中立、またはネガティブ) を表す文字列値。
confidenceScores 3 つの double 値を持つ複合型。ポジティブ、中立、またはネガティブの各評価に 1 つずつです。 値の範囲は 0 から 1.00 です。1.00 は、指定されたラベルの割り当てで可能な限り高い信頼度を表します。
sentences 文章によってテキスト文のセンチメントを分割する複合型のコレクション。 また、includeOpinionMiningtrue に設定されている場合は、ターゲットと評価の形式でオピニオン マイニングの結果が返されます。

定義例

{
    "@odata.type": "#Microsoft.Skills.Text.V3.SentimentSkill",
    "context": "/document",
    "includeOpinionMining": true,
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        },
        {
            "name": "languageCode",
            "source": "/document/languageCode"
        }
    ],
    "outputs": [
        {
            "name": "sentiment",
            "targetName": "sentiment"
        },
        {
            "name": "confidenceScores",
            "targetName": "confidenceScores"
        },
        {
            "name": "sentences",
            "targetName": "sentences"
        }
    ]
}

サンプル入力

{
    "values": [
        {
            "recordId": "1",
            "data": {
                "text": "I had a terrible time at the hotel. The staff was rude and the food was awful.",
                "languageCode": "en"
            }
        }
    ]
}

サンプル出力

{
    "values": [
        {
            "recordId": "1",
            "data": {
                "sentiment": "negative",
                "confidenceScores": {
                    "positive": 0.0,
                    "neutral": 0.0,
                    "negative": 1.0
                },
                "sentences": [
                    {
                        "text": "I had a terrible time at the hotel.",
                        "sentiment": "negative",
                        "confidenceScores": {
                            "positive": 0.0,
                            "neutral": 0.0,
                            "negative": 1.0
                        },
                        "offset": 0,
                        "length": 35,
                        "targets": [],
                        "assessments": [],
                    },
                    {
                        "text": "The staff was rude and the food was awful.",
                        "sentiment": "negative",
                        "confidenceScores": {
                            "positive": 0.0,
                            "neutral": 0.0,
                            "negative": 1.0
                        },
                        "offset":36,
                        "length": 42,
                        "targets": [
                            {
                                "text": "staff",
                                "sentiment": "negative",
                                "confidenceScores": {
                                    "positive": 0.0,
                                    "neutral": 0.0,
                                    "negative": 1.0
                                },
                                "offset": 40,
                                "length": 5,
                                "relations": [
                                    {
                                        "relationType": "assessment",
                                        "ref": "#/documents/0/sentences/1/assessments/0",
                                    }
                                ]
                            },
                            {
                                "text": "food",
                                "sentiment": "negative",
                                "confidenceScores": {
                                    "positive": 0.0,
                                    "neutral": 0.0,
                                    "negative": 1.0
                                },
                                "offset": 63,
                                "length": 4,
                                "relations": [
                                    {
                                        "relationType": "assessment",
                                        "ref": "#/documents/0/sentences/1/assessments/1",
                                    }
                                ]
                            }
                        ],
                        "assessments": [
                            {
                                "text": "rude",
                                "sentiment": "negative",
                                "confidenceScores": {
                                    "positive": 0.0,
                                    "neutral": 0.0,
                                    "negative": 1.0
                                },
                                "offset": 50,
                                "length": 4,
                                "isNegated": false
                            },
                            {
                                "text": "awful",
                                "sentiment": "negative",
                                "confidenceScores": {
                                    "positive": 0.0,
                                    "neutral": 0.0,
                                    "negative": 1.0
                                },
                                "offset": 72,
                                "length": 5,
                                "isNegated": false
                            }
                        ],
                    }
                ]
            }
        }
    ]
}

警告のケース

テキストが空の場合は、警告が生成され、センチメント結果は返されません。 言語がサポートされていない場合は、警告が生成され、センチメント 結果は返されません。

関連項目