センチメント コグニティブ スキル (v2)
センチメント スキル (v2) は、正と負の連続体に沿って非構造化テキストを評価し、各レコードに対して、0 から 1 の数値スコアを返します。 1 に近いスコアは正の感情、0 に近いスコアは負の感情を示します。 このスキルでは、Azure AI サービスの Text Analytics によって提供される機械学習モデルが使用されます。
重要
センチメント スキル (v2) (Microsoft.Skills.Text.SentimentSkill) は廃止され、Microsoft.Skills.Text.V3.SentimentSkill に置き換えられました。 非推奨の Azure AI Search スキルに関するページに記載されている推奨事項に従い、サポートされているスキルに移行してください。
Note
処理の頻度を増やす、ドキュメントを追加する、または AI アルゴリズムを追加することによってスコープを拡大する場合は、課金対象の Azure AI サービス リソースをアタッチする必要があります。 Azure AI サービスの API を呼び出すとき、および Azure AI Search のドキュメント解析段階の一部として画像抽出するときに、料金が発生します。 ドキュメントからのテキストの抽出には、料金はかかりません。
組み込みスキルの実行は、既存の Azure AI サービスの従量課金制の価格で課金されます。 画像抽出の価格は、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
}
}
]
}
警告のケース
テキストが空の場合は、警告が生成され、センチメント スコアは返されません。 言語がサポートされていない場合は、警告が生成され、センチメント スコアは返されません。