Keterampilan Kognitif yang Tidak Digunakan Lagi dalam Pencarian Azure AI

Catatan

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.

Dokumen ini menjelaskan keterampilan kognitif yang dianggap tidak digunakan lagi (dihentikan). Gunakan panduan berikut untuk konten:

Nama Keterampilan: Nama keterampilan yang tidak digunakan lagi; memetakan ke @odata.type atribut .
Versi API terakhir yang tersedia: Versi terakhir Pencarian Azure AI public API di mana set keterampilan yang berisi keterampilan yang tidak digunakan lagi yang sesuai dapat dibuat/diperbarui. Pengindeks dengan keterampilan terlampir dengan keterampilan ini akan terus berjalan bahkan dalam versi API di masa mendatang hingga tanggal "Akhir dukungan", di mana mereka mulai gagal.
Akhir dukungan: Sehari setelah itu keterampilan yang sesuai dianggap tidak didukung dan berhenti bekerja. Kumpulan keterampilan yang dibuat sebelumnya masih harus terus berfungsi, tetapi pengguna disarankan untuk bermigrasi jauh dari keterampilan yang tidak digunakan lagi.
Rekomendasi: Jalur migrasi untuk menggunakan keterampilan yang didukung. Pengguna disarankan mengikuti rekomendasi untuk terus menerima dukungan.

Jika Anda menggunakan Microsoft.Skills.Text.EntityRecognitionSkill (Keterampilan kognitif Pengenalan Entitas (v2)), artikel ini membantu Anda meningkatkan set keterampilan untuk menggunakan Microsoft.Skills.Text.V3.EntityRecognitionSkill yang umumnya tersedia dan memperkenalkan fitur baru.

Jika Anda menggunakan Microsoft.Skills.Text.SentimentSkill (Keterampilan kognitif sentimen (v2)), artikel ini membantu Anda meningkatkan set keterampilan untuk menggunakan Microsoft.Skills.Text.V3.SentimentSkill yang umumnya tersedia dan memperkenalkan fitur baru.

Jika Anda menggunakan Microsoft.Skills.Text.NamedEntityRecognitionSkill (Keterampilan kognitif Pengenalan Entitas Bernama (v2)), artikel ini membantu Anda meningkatkan set keterampilan untuk menggunakan Microsoft.Skills.Text.V3.EntityRecognitionSkill yang umumnya tersedia dan memperkenalkan fitur baru.

Microsoft.Skills.Text.EntityRecognitionSkill

Versi API terakhir yang tersedia

30-04-2021-Pratinjau

Akhir dukungan

Sabtu, 31 Agustus 2024

Rekomendasi

Gunakan Microsoft.Skills.Text.V3.EntityRecognitionSkill sebagai gantinya. Keterampilan ini menyediakan sebagian besar fungsi dari EntityRecognitionSkill dengan kualitas lebih tinggi. Ini juga memiliki informasi yang lebih banyak di bidang output yang kompleks.

Untuk bermigrasi ke Microsoft.Skills.Text.V3.EntityRecognitionSkill, buat satu atau beberapa perubahan berikut pada definisi keterampilan Anda. Anda dapat memperbarui definisi keterampilan menggunakan API Update Skillset.

(Diperlukan) Ubah @odata.type dari "#Microsoft.Skills.Text.EntityRecognitionSkill" ke "#Microsoft.Skills.Text.V3.EntityRecognitionSkill".
(Opsional) Parameter includeTypelessEntities tidak lagi didukung karena keterampilan baru hanya mengembalikan entitas dengan jenis yang diketahui, jadi jika definisi keterampilan Anda sebelumnya mereferensikannya, sekarang harus dihapus.

(Opsional) Jika Anda menggunakan namedEntities output, ada beberapa perubahan kecil pada nama properti.

value berganti nama menjadi text
confidence berganti nama menjadi confidenceScore

Jika Anda perlu menghasilkan nama properti yang sama persis, tambahkan ShaperSkill untuk membentuk ulang output dengan nama yang diperlukan. Misalnya, ShaperSkill ini mengganti nama properti menjadi nilai lamanya.

{
    "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
    "name": "NamedEntitiesShaper",
    "description": "NamedEntitiesShaper",
    "context": "/document/namedEntitiesV3",
    "inputs": [
        {
            "name": "old_format",
            "sourceContext": "/document/namedEntitiesV3/*",
            "inputs": [
                {
                    "name": "value",
                    "source": "/document/namedEntitiesV3/*/text"
                },
                {
                    "name": "offset",
                    "source": "/document/namedEntitiesV3/*/offset"
                },
                {
                    "name": "category",
                    "source": "/document/namedEntitiesV3/*/category"
                },
                {
                    "name": "confidence",
                    "source": "/document/namedEntitiesV3/*/confidenceScore"
                }
            ]
        }
    ],
    "outputs": [
        {
            "name": "output",
            "targetName": "namedEntities"
        }
    ]
}

(Opsional) Jika Anda menggunakan entities output untuk menautkan entitas ke entitas terkenal, fitur ini sekarang menjadi keterampilan baru, Microsoft.Skills.Text.V3.EntityLinkingSkill. Tambahkan keterampilan penautan entitas ke set keterampilan Anda untuk menghasilkan entitas tertaut. Ada juga beberapa perubahan kecil pada nama properti output entities antara EntityRecognitionSkill dan EntityLinkingSkill yang baru.

wikipediaId berganti nama menjadi id
wikipediaLanguage berganti nama menjadi language
wikipediaUrl berganti nama menjadi url
Properti type dan subtype tidak lagi dikembalikan.

{
    "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
    "name": "LinkedEntitiesShaper",
    "description": "LinkedEntitiesShaper",
    "context": "/document/linkedEntitiesV3",
    "inputs": [
        {
            "name": "old_format",
            "sourceContext": "/document/linkedEntitiesV3/*",
            "inputs": [
                {
                    "name": "name",
                    "source": "/document/linkedEntitiesV3/*/name"
                },
                {
                    "name": "wikipediaId",
                    "source": "/document/linkedEntitiesV3/*/id"
                },
                {
                    "name": "wikipediaLanguage",
                    "source": "/document/linkedEntitiesV3/*/language"
                },
                {
                    "name": "wikipediaUrl",
                    "source": "/document/linkedEntitiesV3/*/url"
                },
                {
                    "name": "bingId",
                    "source": "/document/linkedEntitiesV3/*/bingId"
                },
                {
                    "name": "matches",
                    "source": "/document/linkedEntitiesV3/*/matches"
                }
            ]
        }
    ],
    "outputs": [
        {
            "name": "output",
            "targetName": "entities"
        }
    ]
}

(Opsional) Jika Anda tidak secara eksplisit menentukan categories, EntityRecognitionSkill V3 dapat mengembalikan jenis kategori yang berbeda selain yang didukung oleh EntityRecognitionSkill. Jika perilaku ini tidak diinginkan, pastikan untuk secara eksplisit mengatur parameter categories ke ["Person", "Location", "Organization", "Quantity", "Datetime", "URL", "Email"].

Contoh Definisi Migrasi

Migrasi sederhana

(Sebelum) definisi keterampilan EntityRecognition

{   
    "@odata.type": "#Microsoft.Skills.Text.EntityRecognitionSkill",
    "categories": [ "Person" ],
    "defaultLanguageCode": "en",
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        }
    ]
}

(Setelah) definisi keterampilan EntityRecognition V3

{
    "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
    "categories": [ "Person" ],
    "defaultLanguageCode": "en",
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        }
    ]
}

Migrasi yang rumit

(Sebelum) definisi keterampilan EntityRecognition

{
    "@odata.type": "#Microsoft.Skills.Text.EntityRecognitionSkill",
    "categories": [ "Person", "Location", "Organization" ],
    "defaultLanguageCode": "en",
    "minimumPrecision": 0.1,
    "includeTypelessEntities": true,
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        },
        {
            "name": "namedEntities",
            "targetName": "namedEntities"
        },
        {
            "name": "entities",
            "targetName": "entities"
        }
    ]
}

(Setelah) definisi keterampilan EntityRecognition V3

{
    "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
    "categories": [ "Person", "Location", "Organization" ],
    "defaultLanguageCode": "en",
    "minimumPrecision": 0.1,
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        },
        {
            "name": "namedEntities",
            "targetName": "namedEntitiesV3"
        }
    ]
},
{
    "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
    "name": "NamedEntitiesShaper",
    "description": "NamedEntitiesShaper",
    "context": "/document/namedEntitiesV3",
    "inputs": [
        {
            "name": "old_format",
            "sourceContext": "/document/namedEntitiesV3/*",
            "inputs": [
                {
                    "name": "value",
                    "source": "/document/namedEntitiesV3/*/text"
                },
                {
                    "name": "offset",
                    "source": "/document/namedEntitiesV3/*/offset"
                },
                {
                    "name": "category",
                    "source": "/document/namedEntitiesV3/*/category"
                },
                {
                    "name": "confidence",
                    "source": "/document/namedEntitiesV3/*/confidenceScore"
                }
            ]
        }
    ],
    "outputs": [
        {
            "name": "output",
            "targetName": "namedEntities"
        }
    ]
},
{
    "@odata.type": "#Microsoft.Skills.Text.V3.EntityLinkingSkill",
    "defaultLanguageCode": "en",
    "minimumPrecision": 0.1,
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "entities",
            "targetName": "linkedEntities"
        }
    ]
},
{
    "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
    "name": "LinkedEntitiesShaper",
    "description": "LinkedEntitiesShaper",
    "context": "/document/linkedEntitiesV3",
    "inputs": [
        {
            "name": "old_format",
            "sourceContext": "/document/linkedEntitiesV3/*",
            "inputs": [
                {
                    "name": "name",
                    "source": "/document/linkedEntitiesV3/*/name"
                },
                {
                    "name": "wikipediaId",
                    "source": "/document/linkedEntitiesV3/*/id"
                },
                {
                    "name": "wikipediaLanguage",
                    "source": "/document/linkedEntitiesV3/*/language"
                },
                {
                    "name": "wikipediaUrl",
                    "source": "/document/linkedEntitiesV3/*/url"
                },
                {
                    "name": "bingId",
                    "source": "/document/linkedEntitiesV3/*/bingId"
                },
                {
                    "name": "matches",
                    "source": "/document/linkedEntitiesV3/*/matches"
                }
            ]
        }
    ],
    "outputs": [
        {
            "name": "output",
            "targetName": "entities"
        }
    ]
}

Microsoft.Skills.Text.SentimentSkill

Versi API terakhir yang tersedia

30-04-2021-Pratinjau

Akhir dukungan

Sabtu, 31 Agustus 2024

Rekomendasi

Gunakan Microsoft.Skills.Text.V3.SentimentSkill sebagai gantinya. Keterampilan ini memberikan model yang lebih baik dan termasuk opsi untuk menambahkan penambangan opini atau sentimen berbasis aspek. Karena keterampilannya secara signifikan lebih kompleks, outputnya juga sangat berbeda.

Untuk bermigrasi ke Microsoft.Skills.Text.V3.SentimentSkill, buat satu atau beberapa perubahan berikut pada definisi keterampilan Anda. Anda dapat memperbarui definisi keterampilan menggunakan API Update Skillset.

Catatan

Hasil keterampilan untuk Sentiment Skill V3 tidak kompatibel dengan definisi indeks berdasarkan Sentiment Skill. Anda harus membuat perubahan pada definisi indeks, set keterampilan (nantinya input keterampilan dan/atau proyeksi penyimpanan pengetahuan) dan pemetaan bidang output pengindeks untuk mengganti keterampilan sentimen dengan versi baru.

(Diperlukan) Ubah @odata.type dari "#Microsoft.Skills.Text.SentimentSkill" ke "#Microsoft.Skills.Text.V3.SentimentSkill".
(Diperlukan) Keterampilan Sentimen V3 memberikan skor positive, neutral, dan negative untuk keseluruhan teks dan skor yang sama untuk setiap kalimat dalam keseluruhan teks. Sementara itu, SentimentSkill sebelumnya hanya menyediakan ganda tunggal yang berkisar dari 0.0 (negatif) hingga 1.0 (positif) untuk keseluruhan teks. Anda harus memperbarui definisi indeks untuk menerima tiga nilai ganda sebagai pengganti skor tunggal, dan memastikan semua input keterampilan hilir, proyeksi penyimpanan pengetahuan, dan pemetaan bidang output konsisten dengan perubahan penamaan.

Disarankan untuk mengganti SentimentSkill lama dengan SentimentSkill V3 sepenuhnya, memperbarui input keterampilan hilir Anda, proyeksi penyimpanan pengetahuan, pemetaan bidang output pengindeks, dan definisi indeks agar sesuai dengan format output baru, dan mengatur ulang pengindeks Anda sehingga semua dokumen Anda memiliki hasil sentimen yang konsisten ke depannya.

Catatan

Jika Anda memerlukan bantuan lagi untuk memperbarui alur pengayaan Anda untuk menggunakan versi terbaru keterampilan sentimen atau jika mengatur ulang pengindeks Anda bukan pilihan untuk Anda, buka permintaan dukungan baru di mana kami dapat bekerja dengan Anda secara langsung.

Microsoft.Skills.Text.NamedEntityRecognitionSkill

Versi API terakhir yang tersedia

Pratinjau-2017-11-11

Akhir dukungan

Sabtu, 31 Agustus 2024

Rekomendasi

Gunakan Microsoft.Skills.Text.V3.EntityRecognitionSkill sebagai gantinya. Ini menyediakan sebagian besar fungsi dari NamedEntityRecognitionSkill dengan kualitas lebih tinggi. Ini juga memiliki informasi yang lebih banyak di bidang output yang kompleks.

(Diperlukan) Ubah @odata.type dari "#Microsoft.Skills.Text.NamedEntityRecognitionSkill" ke "#Microsoft.Skills.Text.V3.EntityRecognitionSkill".

(Opsional) Jika Anda menggunakan entities output, gunakan namedEntities output koleksi kompleks dari sebagai gantinya EntityRecognitionSkill V3 . Ada beberapa perubahan kecil pada nama properti dari output kompleks namedEntities yang baru:

value berganti nama menjadi text
confidence berganti nama menjadi confidenceScore

{
    "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
    "name": "NamedEntitiesShaper",
    "description": "NamedEntitiesShaper",
    "context": "/document/namedEntities",
    "inputs": [
        {
            "name": "old_format",
            "sourceContext": "/document/namedEntities/*",
            "inputs": [
                {
                    "name": "value",
                    "source": "/document/namedEntities/*/text"
                },
                {
                    "name": "offset",
                    "source": "/document/namedEntities/*/offset"
                },
                {
                    "name": "category",
                    "source": "/document/namedEntities/*/category"
                },
                {
                    "name": "confidence",
                    "source": "/document/namedEntities/*/confidenceScore"
                }
            ]
        }
    ],
    "outputs": [
        {
            "name": "output",
            "targetName": "entities"
        }
    ]
}

(Opsional) Jika Anda tidak secara eksplisit menentukan categories, dapat EntityRecognitionSkill V3 mengembalikan jenis kategori yang berbeda selain yang didukung oleh NamedEntityRecognitionSkill. Jika perilaku ini tidak diinginkan, pastikan untuk secara eksplisit mengatur parameter categories ke ["Person", "Location", "Organization"].

Contoh Definisi Migrasi

Migrasi sederhana

(Sebelum) Definisi keterampilan NamedEntityRecognition

{
    "@odata.type": "#Microsoft.Skills.Text.NamedEntityRecognitionSkill",
    "categories": [ "Person" ],
    "defaultLanguageCode": "en",
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        }
    ]
}

(Setelah) definisi keterampilan EntityRecognition V3

{
    "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
    "categories": [ "Person" ],
    "defaultLanguageCode": "en",
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        }
    ]
}

Migrasi yang sedikit rumit

(Sebelum) Definisi keterampilan NamedEntityRecognition

{
    "@odata.type": "#Microsoft.Skills.Text.NamedEntityRecognitionSkill",
    "defaultLanguageCode": "en",
    "minimumPrecision": 0.1,
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        },
        {
            "name": "entities"
        }
    ]
}

(Setelah) definisi keterampilan EntityRecognition V3

{
    "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
    "categories": [ "Person", "Location", "Organization" ],
    "defaultLanguageCode": "en",
    "minimumPrecision": 0.1,
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        },
        {
            "name": "namedEntities"
        }
    ]
},
{
    "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
    "name": "NamedEntitiesShaper",
    "description": "NamedEntitiesShaper",
    "context": "/document/namedEntities",
    "inputs": [
        {
            "name": "old_format",
            "sourceContext": "/document/namedEntities/*",
            "inputs": [
                {
                    "name": "value",
                    "source": "/document/namedEntities/*/text"
                },
                {
                    "name": "offset",
                    "source": "/document/namedEntities/*/offset"
                },
                {
                    "name": "category",
                    "source": "/document/namedEntities/*/category"
                },
                {
                    "name": "confidence",
                    "source": "/document/namedEntities/*/confidenceScore"
                }
            ]
        }
    ],
    "outputs": [
        {
            "name": "output",
            "targetName": "entities"
        }
    ]
}

Lihat juga

Saran dan Komentar

Apakah halaman ini membantu?

Terakhir diperbarui pada 2026-01-07

Keterampilan Kognitif yang Tidak Digunakan Lagi dalam Pencarian Azure AI

Microsoft.Skills.Text.EntityRecognitionSkill

Versi API terakhir yang tersedia

Akhir dukungan

Rekomendasi

Microsoft.Skills.Text.SentimentSkill

Versi API terakhir yang tersedia

Akhir dukungan

Rekomendasi

Microsoft.Skills.Text.NamedEntityRecognitionSkill

Versi API terakhir yang tersedia

Akhir dukungan

Rekomendasi

Lihat juga

Saran dan Komentar

Sumber Daya Tambahan: