Umiejętności poznawcze tonacji (wersja 3)
Umiejętność tonacji (wersja 3) ocenia tekst bez struktury i dla każdego rekordu, udostępnia etykiety tonacji (takie jak "negatywne", "neutralne" i "pozytywne") na podstawie najwyższego wskaźnika ufności znalezionego przez usługę na poziomie zdania i dokumentu. Ta umiejętność korzysta z modeli uczenia maszynowego udostępnianych przez wersję 3 usługi językowej w usługach Azure AI. Uwidacznia również możliwości wyszukiwania opinii, które zapewniają bardziej szczegółowe informacje o opiniach związanych z atrybutami produktów lub usług w tekście.
Uwaga
Ta umiejętność jest powiązana z usługami azure AI i wymaga rozliczanego zasobu dla transakcji, które przekraczają 20 dokumentów na indeksator dziennie. Wykonanie wbudowanych umiejętności jest naliczane za istniejące usługi Azure AI z płatnością zgodnie z rzeczywistym użyciem.
@odata.type
Microsoft.Skills.Text.V3.SentimentSkill
Limity danych
Maksymalny rozmiar rekordu powinien wynosić 5000 znaków mierzonych przez String.Lengthwartość . Jeśli musisz podzielić dane przed wysłaniem ich do umiejętności tonacji, użyj umiejętności Dzielenie tekstu.
Parametry umiejętności
W parametrach jest rozróżniana wielkość liter.
| Nazwa parametru | opis |
|---|---|
defaultLanguageCode |
(opcjonalnie) Kod języka, który ma być stosowany do dokumentów, które nie określają jawnie języka. Zobacz pełną listę obsługiwanych języków. |
modelVersion |
(opcjonalnie) Określa wersję modelu do użycia podczas wywoływania analizy tonacji. Zostanie ona domyślnie ustawiona na najnowszą wersję, jeśli nie zostanie określona. Zalecamy, aby nie określać tej wartości, chyba że jest to konieczne. |
includeOpinionMining |
Jeśli ustawiono truewartość , włączy funkcję wyszukiwania opinii, która umożliwia uwzględnianie analiz tonacji opartych na aspektach w wynikach danych wyjściowych. Wartość domyślna to false. |
Dane wejściowe umiejętności
| Nazwa danych wejściowych | opis |
|---|---|
text |
Tekst do przeanalizowania. |
languageCode |
(opcjonalnie) Ciąg wskazujący język rekordów. Jeśli ten parametr nie zostanie określony, wartość domyślna to "en". Zobacz pełną listę obsługiwanych języków. |
Dane wyjściowe umiejętności
| Nazwa danych wyjściowych | opis |
|---|---|
sentiment |
Wartość ciągu reprezentująca etykietę tonacji całego analizowanego tekstu (dodatniego, neutralnego lub negatywnego). |
confidenceScores |
Typ złożony z trzema podwójnymi wartościami, jeden dla oceny dodatniej, jeden dla oceny neutralnej i jeden dla oceny ujemnej. Wartości wahają się od 0 do 1,00, gdzie wartość 1,00 reprezentuje najwyższy możliwy poziom zaufania do danego przypisania etykiety. |
sentences |
Kolekcja złożonych typów, które rozkłada tonację zdania tekstowego według zdania. Jest to również miejsce, w którym wyniki wyszukiwania opinii są zwracane w formie celów i ocen, jeśli includeOpinionMining ustawiono wartość true. |
Przykładowa definicja
{
"@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"
}
]
}
Przykładowe dane wejściowe
{
"values": [
{
"recordId": "1",
"data": {
"text": "I had a terrible time at the hotel. The staff was rude and the food was awful.",
"languageCode": "en"
}
}
]
}
Przykładowe dane wyjściowe
{
"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
}
],
}
]
}
}
]
}
Przypadki ostrzegawcze
Jeśli tekst jest pusty, zostanie wygenerowane ostrzeżenie i nie zostaną zwrócone żadne wyniki tonacji. Jeśli język nie jest obsługiwany, zostanie wygenerowane ostrzeżenie i nie zostaną zwrócone żadne wyniki tonacji.