Memperbarui Skillset (Azure AI Search REST API)

  • Artikel

Anda dapat memperbarui set keterampilan dan penyimpanan pengetahuan yang ada menggunakan HTTP PUT, menentukan nama set keterampilan yang akan diperbarui pada URI permintaan.

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=[api-version]
  Content-Type: application/json
  api-key: [admin key]

Catatan

Skillsets adalah dasar pengayaan AI di Azure AI Search. Sumber daya gratis tersedia untuk pemrosesan terbatas, tetapi untuk beban kerja yang lebih besar dan lebih sering, sumber daya Cognitive Services yang dapat ditagih diperlukan. Untuk informasi selengkapnya, lihat Melampirkan sumber daya Cognitive Services ke skillset Azure AI Search.

Parameter URI

Parameter Deskripsi
nama layanan Wajib diisi. Atur ini ke nama unik yang ditentukan pengguna dari layanan pencarian Anda.
nama skillset Wajib diisi. URI permintaan menentukan nama set keterampilan yang akan diperbarui.
versi-api Wajib diisi. Versi stabil saat ini adalah api-version=2020-06-30. Lihat versi API untuk versi lainnya.
disableCacheReprocessingChangeDetection Opsional. Digunakan untuk pengayaan inkremental (false secara default). Atur ke true untuk mencegah pembaruan pada dokumen yang ada berdasarkan tindakan saat ini. Untuk informasi selengkapnya, lihat manajemen cache.

Judul Permintaan

Tabel berikut ini menjelaskan header permintaan yang diperlukan dan opsional.

Bidang Deskripsi
Jenis-Konten Wajib diisi. Atur titik akhir ini ke application/json
api-key Opsional jika Anda menggunakan peran Azure dan token pembawa disediakan berdasarkan permintaan, jika tidak, kunci diperlukan. Kunci api adalah string unik yang dihasilkan sistem yang mengautentikasi permintaan ke layanan pencarian Anda. Permintaan pembaruan harus menyertakan header yang api-key diatur ke kunci admin Anda (dibandingkan dengan kunci kueri). Lihat Menyambungkan ke Pencarian Azure AI menggunakan autentikasi kunci untuk detailnya.

Isi Permintaan

Sintaks isi permintaan sama dengan untuk Buat Skillset.

Saat memperbarui set keterampilan yang ada, seluruh definisi diganti dengan konten isi permintaan. Secara umum, pola terbaik yang digunakan untuk pembaruan adalah mengambil definisi set keterampilan dengan GET, memodifikasinya, lalu memperbaruinya dengan PUT.

Respons

Untuk permintaan yang berhasil, Anda akan melihat kode status "201 Dibuat".

Secara default, isi respons akan berisi JSON untuk definisi set keterampilan yang dibuat. Namun, jika header Permintaan pilihan diatur ke return=minimal, isi respons akan kosong, dan kode status keberhasilan akan menjadi "204 Tidak Ada Konten" alih-alih "201 Dibuat". Hal ini berlaku terlepas dari apakah PUT atau POST digunakan untuk membuat skillset.

Contoh

Contoh: Memperbarui set keterampilan

Contoh berikut memperbarui set keterampilan yang digunakan untuk memperkaya koleksi dokumen keuangan.

PUT https://[servicename].search.windows.net/skillsets/financedocenricher?api-version=2020-06-30
api-key: [admin key]
Content-Type: application/json

Isi permintaan adalah dokumen JSON. Set keterampilan khusus ini menggunakan dua keterampilan secara asinkron, secara independen memproses substansi /document/content sebagai dua transformasi yang berbeda. Atau, Anda dapat mengarahkan output dari satu transformasi untuk menjadi input orang lain. Untuk informasi selengkapnya, lihat Cara menentukan set keterampilan.

{
  "name": "financedocenricher",
  "description": 
  "An updated version of a skillset used to extract sentiment from financial records, extract company names, and then find additional information about each company mentioned. This version changes the target names.",
  "skills":
  [
    {
      "@odata.type": "#Microsoft.Skills.Text.EntityRecognitionSkill",
      "categories": [ "Organization" ],
      "defaultLanguageCode": "en",
      "inputs": [
        {
          "name": "text",
          "source": "/document/content"
        }
      ],
      "outputs": [
        {
          "name": "organizations",
          "targetName": "companies"
        }
      ]
    },
    {
      "@odata.type": "#Microsoft.Skills.Text.SentimentSkill",
      "inputs": [
        {
          "name": "text",
          "source": "/document/content"
        }
      ],
      "outputs": [
        {
          "name": "score",
          "targetName": "positivityscore"
        }
      ]
    },
  ],
  "cognitiveServices": 
  {
  "@odata.type": "#Microsoft.Azure.Search.CognitiveServicesByKey",
  "description": "mycogsvcs resource in West US 2",
  "key": "<your key goes here>"
  }
}

Contoh: Menghapus kunci Cognitive Services

Jika Anda ingin memperbarui set keterampilan yang ada dan menghapus kunci Cognitive services yang terpasang padanya, maka ubah bagian cognitiveServices dengan mengatur ke @odata.type#Microsoft.Azure.Search.DefaultCognitiveServices.

{
  "name": "financedocenricher"
  "skills":
  [
    {
      "@odata.type": "#Microsoft.Skills.Text.EntityRecognitionSkill",
      "categories": [ "Organization" ],
      "defaultLanguageCode": "en",
      "inputs": [
        {
          "name": "text",
          "source": "/document/content"
        }
      ],
      "outputs": [
        {
          "name": "organizations",
          "targetName": "companies"
        }
      ]
    },
  ],
  "cognitiveServices": 
  {
  "@odata.type": "#Microsoft.Azure.Search.DefaultCognitiveServices"
  }
}

Lihat juga