감정 인식 기술(v3)
감정 기술(v3)은 구조화되지 않은 텍스트를 평가하고, 각 레코드에 대해 문장 및 문서 수준에서 서비스에서 찾은 가장 높은 신뢰도 점수를 기반으로 감정 레이블(예: "부정", "중립" 및 "긍정")을 제공합니다. 이 기술은 Azure AI 서비스의 Language Service 버전 3에서 제공하는 기계 학습 모델을 사용합니다. 제품 또는 서비스의 특성과 관련된 의견에 대한 보다 세부적인 정보를 텍스트로 제공하는 오피니언 마이닝 기능도 제공합니다.
참고 항목
이 기술은 Azure AI 서비스에 바인딩되며 하루에 인덱서당 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개이고, 하나는 양수 등급이고, 다른 하나는 중립 등급이고, 다른 하나는 음수 등급인 복합 형식입니다. 값 범위는 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
}
],
}
]
}
}
]
}
경고 사례
텍스트가 비어 있으면 경고가 생성되고 감정 결과가 반환되지 않습니다. 언어가 지원되지 않으면 경고가 생성되고 감정 결과가 반환되지 않습니다.