Képességcsoport frissítése (Azure AI Search REST API)

  • Cikk

Egy meglévő képességcsoportot és tudástárat egy HTTP PUT használatával frissíthet, megadva annak a képességcsoportnak a nevét, amely frissíthető a kérelem URI-ján.

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

Megjegyzés

A képességcsoportok az AI-bővítés alapjai az Azure AI Searchben. A korlátozott feldolgozáshoz ingyenes erőforrás érhető el, de a nagyobb és gyakoribb számítási feladatokhoz számlázható Cognitive Services-erőforrásra van szükség. További információ: Cognitive Services-erőforrás csatolása Azure AI Search-képességcsoporthoz.

URI-paraméterek

Paraméter Leírás
szolgáltatásnév Kötelező. Állítsa be ezt a keresési szolgáltatás egyedi, felhasználó által megadott nevére.
képességcsoport neve Kötelező. A kérelem URI-ja adja meg a frissíteni kívánt képességcsoport nevét.
api-verzió Kötelező. A jelenlegi stabil verzió a következő api-version=2020-06-30: . További verziókért lásd: API-verziók .
disableCacheReprocessingChangeDetection Választható. Növekményes bővítéshez használatos (false alapértelmezés szerint). Állítsa be úgy, true hogy megakadályozza a meglévő dokumentumok frissítését az aktuális művelet alapján. További információ: Gyorsítótár-kezelés.

Kérelemfejlécek

Az alábbi táblázat a szükséges és nem kötelező kérelemfejléceket ismerteti.

Mezők Description
Content-Type Kötelező. Állítsa ezt a következőre: application/json
api-key Nem kötelező , ha Azure-szerepköröket használ, és egy tulajdonosi jogkivonatot ad meg a kéréshez, ellenkező esetben kulcsra van szükség. Az API-kulcs egy egyedi, rendszer által létrehozott sztring, amely hitelesíti a keresési szolgáltatásnak küldött kérést. A frissítési kérelmeknek tartalmazniuk kell a api-key rendszergazdai kulcsra beállított fejlécet (nem pedig lekérdezési kulcsot). A részletekért lásd: Csatlakozás az Azure AI Searchhöz kulcshitelesítés használatával .

Kérelem törzse

A kérelemtörzs szintaxisa megegyezik a Képességcsoport létrehozása szintaxisával.

Meglévő képességcsoport frissítésekor a rendszer a teljes definíciót a kérelemtörzs tartalmára cseréli. A frissítésekhez általában az a legjobb minta, ha lekéri a képességcsoport definícióját egy GET paranccsal, módosítja, majd a PUT paranccsal frissíti.

Reagálás

Sikeres kérés esetén a "201 Létrehozva" állapotkódnak kell megjelennie.

Alapértelmezés szerint a választörzs tartalmazza a létrehozott képességcsoport-definíció JSON-ját. Ha azonban a Kérés előnyben részesítése fejléc a return=minimal értékre van állítva, a válasz törzse üres lesz, a sikerességi állapotkód pedig "204 Nincs tartalom" lesz a "201 Létrehozva" helyett. Ez attól függetlenül igaz, hogy a PUT vagy a POST használatával hozza létre a képességcsoportot.

Példák

Példa: Képességcsoport frissítése

Az alábbi példa frissíti a pénzügyi dokumentumok gyűjteményének bővítéséhez használt képességcsoportot.

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

A kérelemtörzs egy JSON-dokumentum. Ez az adott képességcsoport két készséget használ aszinkron módon, és egymástól függetlenül két különböző átalakításként dolgozza fel az anyagát /document/content . Másik lehetőségként az egyik átalakítás kimenetét egy másik bemenetére is irányíthatja. További információ: Képességcsoport meghatározása.

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

Példa: Cognitive Services-kulcs eltávolítása

Ha frissíteni szeretne egy meglévő képességcsoportot, és el szeretné távolítani a hozzá csatolt Cognitive Services-kulcsot, módosítsa a cognitiveServices szakaszt a @odata.type értékre #Microsoft.Azure.Search.DefaultCognitiveServicesállításával.

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

Lásd még