Keterampilan kognitif sentimen (v3)

Note

Pencarian Azure AI tersedia melalui portal Azure, REST API, dan Azure SDK. Ini juga mendukung Foundry IQ, lapisan pengetahuan terkelola yang mengubah konten perusahaan menjadi pangkalan pengetahuan yang dapat digunakan kembali dan sadar izin untuk agen di portal Microsoft Foundry.

Keterampilan Sentimen (v3) mengevaluasi teks yang tidak terstruktur dan untuk setiap rekaman, memberikan label sentimen (seperti "negatif", "netral" dan "positif") berdasarkan skor keyakinan tertinggi yang ditemukan oleh layanan pada tingkat kalimat dan dokumen. Keterampilan ini menggunakan model pembelajaran mesin yang disediakan oleh versi 3 Layanan Bahasa di Foundry Tools. Ini juga memaparkan kemampuan penambangan opini, yang memberikan informasi yang lebih terperinci tentang pendapat yang terkait dengan atribut produk atau layanan dalam teks.

Note

Keterampilan ini terikat dengan Foundry Tools dan memerlukan sumber daya yang dapat ditagih untuk transaksi yang melebihi 20 dokumen per pengindeks per hari. Eksekusi keterampilan bawaan dibebankan pada harga Foundry Tools Standard yang ada.

@odata.type

Microsoft.Skills.Text.V3.SentimentSkill

Batasan data

Ukuran maksimum catatan harus 5.000 karakter yang diukur dengan String.Length. Jika Anda perlu memecah data sebelum mengirimkannya ke keterampilan sentimen, gunakan keterampilan Pemisahan Teks.

Parameter keterampilan

Parameter peka huruf besar/kecil.

Nama Parameter Deskripsi
defaultLanguageCode (opsional) Kode bahasa untuk diterapkan ke dokumen yang tidak menentukan bahasa secara eksplisit.
Lihat daftar lengkap bahasa yang didukung.
modelVersion (opsional) Menentukan versi model yang akan digunakan saat memanggil analisis sentimen. Ini akan ditetapkan default ke versi terbaru jika tidak ditentukan. Kami sarankan Anda tidak menentukan nilai ini kecuali diperlukan.
includeOpinionMining Jika diatur ke true, memungkinkan fitur penambangan opini, yang memungkinkan analisis sentimen berbasis aspek disertakan dalam hasil output Anda. Default ke false.

Masukan keterampilan

Nama Input Deskripsi
text Teks yang akan dianalisis.
languageCode (opsional) String yang menunjukkan bahasa rekaman. Jika parameter ini tidak ditentukan, nilai defaultnya adalah "en".
Lihat daftar lengkap bahasa yang didukung.

Keluaran Keterampilan

Nama Output Deskripsi
sentiment Nilai string yang menunjukkan label sentimen dari seluruh teks yang dianalisis (baik positif, netral, atau negatif).
confidenceScores Jenis kompleks dengan tiga nilai ganda, satu untuk peringkat positif, satu untuk peringkat netral, dan satu untuk peringkat negatif. Nilai berkisar dari 0 hingga 1,00, yang mana 1,00 mewakili keyakinan setinggi mungkin dalam penetapan label tertentu.
sentences Kumpulan jenis kompleks yang memecah sentimen kalimat teks menurut kalimat. Di sinilah hasil penambangan opini ditampilkan dalam bentuk target dan penilaian jika includeOpinionMining ditetapkan ke true.

Contoh definisi

{
    "@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"
        }
    ]
}

Input contoh

{
    "values": [
        {
            "recordId": "1",
            "data": {
                "text": "I had a terrible time at the hotel. The staff was rude and the food was awful.",
                "languageCode": "en"
            }
        }
    ]
}

Contoh keluaran

{
    "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
                            }
                        ],
                    }
                ]
            }
        }
    ]
}

Kasus peringatan

Jika teks Anda kosong, peringatan dibuat dan tidak ada hasil sentimen yang ditampilkan. Jika bahasa tidak didukung, peringatan dibuat dan tidak ada hasil sentimen yang ditampilkan.

Baca juga