Update Skillset (API REST ricerca intelligenza artificiale di Azure)
È 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
- Panoramica dell'arricchimento dell'intelligenza artificiale
- Esercitazione: Indicizzazione arricchita con intelligenza artificiale
- Come definire un set di competenze
- Come eseguire il mapping dei campi
- How to define a custom interface (Come definire un'interfaccia personalizzata)
- Competenze predefinite