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

2025-05-19

センチメント スキル (v2) は、正と負の連続体に沿って非構造化テキストを評価し、各レコードに対して、0 から 1 の数値スコアを返します。 1 に近いスコアは正の感情、0 に近いスコアは負の感情を示します。このスキルでは、Azure AI サービスの Text Analytics によって提供される機械学習モデルが使用されます。

重要

センチメントスキル (v2) (Microsoft.Skills.Text.SentimentSkill) は廃止され、Microsoft.Skills.Text.V3.SentimentSkill に置き換えられました。非推奨の Azure AI Search スキルに関するページに記載されている推奨事項に従い、サポートされているスキルに移行してください。

注

処理の頻度を増やす、ドキュメントを追加する、または AI アルゴリズムを追加することによってスコープを拡大する場合は、課金対象の Azure AI サービスリソースをアタッチする必要があります。 Azure AI サービスの API を呼び出すとき、および Azure AI Search のドキュメント解析段階の一部として画像抽出するときに、料金が発生します。ドキュメントからのテキストの抽出には、料金はかかりません。

組み込みスキルの実行は、既存の Azure AI サービス Standard 価格で課金されます。画像抽出の価格は、Azure AI Search の価格ページで説明されています。

@odata.type

Microsoft.Skills.Text.SentimentSkill

データ制限

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

スキルのパラメーター

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

パラメーター名	説明
`defaultLanguageCode`	(省略可能) 言語を明示的に指定しないドキュメントに適用する言語コード。サポートされる言語の完全な一覧を参照してください。

スキルの入力

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

スキルの出力

出力の名前	説明
`score`	分析されたテキストのセンチメントを表す 0 から 1 の値。 0 に近い値は負のセンチメント、0.5 に近い値は中立のセンチメント、1 に近い値は正のセンチメントを持ちます。

定義例

{
    "@odata.type": "#Microsoft.Skills.Text.SentimentSkill",
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        },
        {
            "name": "languageCode",
            "source": "/document/languagecode"
        }
    ],
    "outputs": [
        {
            "name": "score",
            "targetName": "mySentiment"
        }
    ]
}

サンプル入力

{
    "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": {
                "score": 0.01
            }
        }
    ]
}

警告のケース

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

次の方法で共有

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