Keterampilan Kognitif yang Tidak Digunakan Lagi dalam Pencarian Azure AI

  • Artikel

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

  • Nama Keterampilan: Nama keterampilan yang tidak akan digunakan lagi; ia melakukan pemetaan ke atribut @odata.type.
  • Versi api terakhir yang tersedia: Versi terakhir Azure AI Search 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 diteruskan 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.

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

  2. (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.

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

    1. value berganti nama menjadi text
    2. 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"
        }
    ]
}

  4. (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.

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

    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": "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"
        }
    ]
}

  5. (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

Output keterampilan untuk Keterampilan Sentimen V3 tidak sesuai dengan definisi indeks berdasarkan SentimentSkill. Anda harus membuat perubahan pada definisi indeks, kumpulan keterampilan (input keterampilan selanjutnya dan/atau proyeksi penyimpanan pengetahuan) dan pemetaan bidang keluaran pengindeks untuk mengganti keterampilan sentimen dengan versi baru.

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

  2. (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 perlu memperbarui definisi indeks Anda untuk menerima tiga nilai ganda sebagai pengganti skor tunggal, dan memastikan semua input keterampilan hilir Anda, 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 tambahan untuk memperbarui alur pengayaan Anda agar menggunakan versi terbaru dari keterampilan sentimen atau jika menyetel ulang pengindeks bukanlah pilihan bagi Anda, silakan buka permintaan dukungan baru agar kami dapat bekerja sama 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.

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.

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

  2. (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:

    1. value berganti nama menjadi text
    2. 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/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"
        }
    ]
}

  3. (Opsional) Jika Anda tidak secara eksplisit menentukan categories, EntityRecognitionSkill V3 dapat 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"
        }
    ]
}

Baca juga