Update Skillset (API REST ricerca intelligenza artificiale di Azure)

  • Articolo

È possibile aggiornare un set di competenze e un archivio conoscenze esistenti usando un PUT HTTP, specificando il nome del set di competenze da aggiornare nell'URI della richiesta.

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

Nota

I set di competenze sono la base dell'arricchimento dell'intelligenza artificiale in Ricerca intelligenza artificiale di Azure. Una risorsa gratuita è disponibile per l'elaborazione limitata, ma per carichi di lavoro più grandi e più frequenti, è necessaria una risorsa servizi cognitivi fatturabili. Per altre informazioni, vedere Collegare una risorsa servizi cognitivi a un set di competenze di Ricerca intelligenza artificiale di Azure.

Parametri dell'URI

Parametro Descrizione
nome servizio Obbligatorio. Impostare questo valore sul nome univoco definito dall'utente del servizio di ricerca.
nome del set di competenze Obbligatorio. L'URI della richiesta specifica il nome del set di competenze da aggiornare.
api-version Obbligatorio. La versione stabile corrente è api-version=2020-06-30. Per altre versioni, vedere Versioni API .
disableCacheReprocessingChangeDetection facoltativo. Usato per l'arricchimento incrementale (false per impostazione predefinita). Impostare su per true impedire gli aggiornamenti ai documenti esistenti in base all'azione corrente. Per altre informazioni, vedere Gestione della cache.

Intestazioni richiesta

La tabella seguente descrive le intestazioni della richiesta obbligatorie e facoltative.

Campi Descrizione
Content-Type Obbligatorio. Impostare il valore su application/json
api-key Facoltativo se si usano ruoli di Azure e viene fornito un token di connessione nella richiesta, altrimenti è necessaria una chiave. Una chiave API è una stringa univoca generata dal sistema che autentica la richiesta al servizio di ricerca. Le richieste di aggiornamento devono includere un'intestazione api-key impostata sulla chiave di amministrazione anziché su una chiave di query. Per informazioni dettagliate, vedere Connettersi a Ricerca intelligenza artificiale di Azure usando l'autenticazione delle chiavi .

Corpo della richiesta

La sintassi del corpo della richiesta è uguale a per Create Skillset.

Quando si aggiorna un set di competenze esistente, l'intera definizione viene sostituita con il contenuto del corpo della richiesta. In generale, il modello migliore da usare per gli aggiornamenti consiste nel recuperare la definizione del set di competenze con un get, modificarlo e quindi aggiornarlo con PUT.

Risposta

In caso di richiesta eseguita correttamente, viene visualizzato il codice di stato "201 - Creato".

Per impostazione predefinita, il corpo della risposta contiene il codice JSON per la definizione del set di competenze creata. Se tuttavia l'intestazione della richiesta Prefer è impostata su return=minimal, il corpo della risposta sarà vuoto e il codice di stato per l'esito positivo sarà "204 - Nessun contenuto" invece di "201 - Creato". Questo vale indipendentemente dall'uso del metodo PUT o POST per creare il set di competenze.

Esempio

Esempio: Aggiornare un set di competenze

Nell'esempio seguente viene aggiornato un set di competenze usato per arricchire una raccolta di documenti finanziari.

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

Il corpo della richiesta è un documento JSON. Questo set di competenze specifico usa due competenze in modo asincrono, elaborando in modo indipendente la sostanza di /document/content come due trasformazioni diverse. In alternativa, è possibile indirizzare l'output di una trasformazione in modo che diventi l'input di un'altra. Per alte informazioni, vedere Come definire un set di competenze.

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

Esempio: Rimuovere la chiave servizi cognitivi

Se si vuole aggiornare un set di competenze esistente e rimuovere la chiave dei servizi cognitivi collegata, modificare la cognitiveServices sezione impostando su @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"
  }
}

Vedi anche