Beceri Kümesini Güncelleştirme (Azure AI Arama REST API'si)

Makale
07/12/2023

İstek URI'sinde güncelleştirilecek beceri kümesinin adını belirterek http PUT kullanarak mevcut beceri kümesini ve bilgi depolarını güncelleştirebilirsiniz.

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

Not

Beceri kümeleri, Azure AI Search'te yapay zeka zenginleştirmesinin temelini oluşturur. Sınırlı işlem için ücretsiz bir kaynak kullanılabilir, ancak daha büyük ve daha sık iş yükleri için faturalanabilir bir Bilişsel Hizmetler kaynağı gerekir. Daha fazla bilgi için bkz. Azure AI Arama beceri kümesine Bilişsel Hizmetler kaynağı ekleme.

URI Parametreleri

Parametre	Açıklama
hizmet adı	Gereklidir. Bunu arama hizmetinizin benzersiz, kullanıcı tanımlı adı olarak ayarlayın.
beceri kümesi adı	Gereklidir. İstek URI'si güncelleştirilecek beceri kümesinin adını belirtir.
api-sürümü	Gereklidir. Geçerli kararlı sürüm şudur: `api-version=2020-06-30`. Daha fazla sürüm için bkz. API sürümleri.
disableCacheReprocessingChangeDetection	İsteğe bağlı. Artımlı zenginleştirme (`false` varsayılan olarak) için kullanılır. Geçerli eyleme `true` dayalı olarak var olan belgelerde güncelleştirme yapılmasını önlemek için olarak ayarlayın. Daha fazla bilgi için bkz. önbellek yönetimi.

İstek Üst Bilgileri

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadır.

Alanlar Description

İçerik Türü Gereklidir. Bunu olarak ayarlayın application/json

api-key İsteğe bağlı olarak, Azure rollerini kullanıyorsanız ve istekte taşıyıcı belirteç sağlanırsa, aksi takdirde bir anahtar gereklidir. Api anahtarı, arama hizmetinizde isteğin kimliğini doğrulayan, sistem tarafından oluşturulan benzersiz bir dizedir. Güncelleştirme istekleri, yönetici anahtarınıza ayarlanmış bir api-key üst bilgi içermelidir (sorgu anahtarının aksine). Ayrıntılar için bkz. Anahtar kimlik doğrulamasını kullanarak Azure AI Search'e bağlanma .

Alanlar	Description
İçerik Türü	Gereklidir. Bunu olarak ayarlayın `application/json`
api-key	İsteğe bağlı olarak, Azure rollerini kullanıyorsanız ve istekte taşıyıcı belirteç sağlanırsa, aksi takdirde bir anahtar gereklidir. Api anahtarı, arama hizmetinizde isteğin kimliğini doğrulayan, sistem tarafından oluşturulan benzersiz bir dizedir. Güncelleştirme istekleri, yönetici anahtarınıza ayarlanmış bir `api-key` üst bilgi içermelidir (sorgu anahtarının aksine). Ayrıntılar için bkz. Anahtar kimlik doğrulamasını kullanarak Azure AI Search'e bağlanma .

İstek Gövdesi

İstek gövdesi söz dizimi , Beceri Kümesi Oluştur ile aynıdır.

Mevcut beceri kümesini güncelleştirirken, tanımın tamamı istek gövdesinin içeriğiyle değiştirilir. Genel olarak, güncelleştirmeler için kullanılacak en iyi desen get ile beceri kümesi tanımını almak, değiştirmek ve put ile güncelleştirmektir.

Yanıt

Başarılı bir istek için "201 Oluşturuldu" durum kodunu görmeniz gerekir.

Varsayılan olarak, yanıt gövdesi oluşturulan beceri kümesi tanımının JSON'unu içerir. Ancak, tercih isteği üst bilgisi return=minimal olarak ayarlanırsa yanıt gövdesi boş olur ve başarı durum kodu "201 Oluşturuldu" yerine "204 İçerik Yok" olur. Beceri kümesini oluşturmak için PUT veya POST kullanılıp kullanılmadığına bakılmaksızın bu durum geçerlidir.

Örnekler

Örnek: Beceri kümesini güncelleştirme

Aşağıdaki örnek, finansal belge koleksiyonunu zenginleştirmek için kullanılan beceri kümesini güncelleştirir.

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

İsteğin gövdesi bir JSON belgesidir. Bu özel beceri kümesi, maddesini /document/content iki farklı dönüşüm olarak bağımsız olarak işleyen iki beceriyi zaman uyumsuz olarak kullanır. Alternatif olarak, bir dönüştürmenin çıkışını başka bir dönüşümün girişi olacak şekilde yönlendirebilirsiniz. Daha fazla bilgi için bkz. Beceri kümesi tanımlama.

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

Örnek: Bilişsel Hizmetler anahtarını kaldırma

Mevcut bir beceri kümesini güncelleştirmek ve buna bağlı Bilişsel hizmetler anahtarını kaldırmak istiyorsanız, öğesini olarak ayarlayarak @odata.type#Microsoft.Azure.Search.DefaultCognitiveServicesbölümünü değiştirincognitiveServices.

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

Aracılığıyla paylaş