センチメント コグニティブ スキル (v3)
センチメント のスキル (v3) は、非構造化テキストを評価し、各レコードについて、文章とドキュメントレベルでサービスによって検出された最高の信頼スコアに基づいて、センチメント ラベル ("ネガティブ"、"中立"、"ポジティブ" など) を提供します。 このスキルでは、Azure AI サービスの言語サービスのバージョン 3 によって提供される機械学習モデルが使用されます。 また、オピニオン マイニング機能も公開されており、テキストに含まれる製品やサービスの属性に関連する意見に関するより詳細な情報を提供します。
Note
このスキルは Azure AI サービスにバインドされており、1 日にインデクサーあたり 20 ドキュメントを超えるトランザクションには課金対象リソースが必要です。 組み込みスキルの実行は、既存の Azure AI サービスの従量課金制の価格で課金されます。
@odata.type
Microsoft.Skills.Text.V3.SentimentSkill
データ制限
レコードの最大サイズは、String.Length によって測定されるため、5,000 文字にする必要があります。 データをセンチメント スキルに送信する前に分割する必要がある場合は、テキスト分割スキルを使用します。
スキルのパラメーター
パラメーターの大文字と小文字は区別されます。
| パラメーター名 | 説明 |
|---|---|
defaultLanguageCode |
(省略可能) 言語を明示的に指定しないドキュメントに適用する言語コード。 サポートされる言語の完全な一覧を参照してください。 |
modelVersion |
(省略可能) 感情分析を呼び出すときに使用するモデルのバージョンを指定します。 指定しない場合、既定では直近のバージョンになります。 必要な場合以外は、この値を指定しないことをお勧めします。 |
includeOpinionMining |
true に設定されている場合、オピニオン マイニング機能が有効になります。これにより、アスペクト ベースのセンチメント分析を出力結果に含めることができます。 既定値は false です。 |
スキルの入力
| 入力名 | 説明 |
|---|---|
text |
分析されるテキスト。 |
languageCode |
(省略可能) レコードの言語を示す文字列。 このプロパティが指定されていない場合の既定値は "en" です。 サポートされる言語の完全な一覧を参照してください。 |
スキルの出力
| 出力の名前 | 説明 |
|---|---|
sentiment |
分析されたテキスト全体のセンチメント ラベル (ポジティブ、中立、またはネガティブ) を表す文字列値。 |
confidenceScores |
3 つの double 値を持つ複合型。ポジティブ、中立、またはネガティブの各評価に 1 つずつです。 値の範囲は 0 から 1.00 です。1.00 は、指定されたラベルの割り当てで可能な限り高い信頼度を表します。 |
sentences |
文章によってテキスト文のセンチメントを分割する複合型のコレクション。 また、includeOpinionMining が true に設定されている場合は、ターゲットと評価の形式でオピニオン マイニングの結果が返されます。 |
定義例
{
"@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
}
],
}
]
}
}
]
}
警告のケース
テキストが空の場合は、警告が生成され、センチメント結果は返されません。 言語がサポートされていない場合は、警告が生成され、センチメント 結果は返されません。