Eseguire la migrazione dall'anteprima pubblica di Sicurezza dei contenuti di Azure AI alla disponibilità generale
Questa guida illustra come aggiornare il codice esistente dalla versione di anteprima pubblica di Sicurezza dei contenuti di Azure AI alla versione disponibile a livello generale.
Chiamate API REST
In tutte le chiamate API assicurarsi di modificare il parametro api-version nel codice:
| vecchia | Nuovo… |
|---|---|
api-version=2023-04-30-preview |
api-version=2023-10-01 (o versione successiva) |
Si noti che il nome dell'endpoint REST seguente cambia dall'API di anteprima:
| Termine di anteprima pubblica | Termine di disponibilità generale |
|---|---|
| addBlockItems | addOrUpdateBlocklistItems |
| blockItems | blocklistItems |
| removeBlockItems | removeBlocklistItems |
Campi JSON
I campi JSON seguenti sono stati rinominati. Assicurarsi di modificarli quando si inviano dati a una chiamata REST:
| Termine di anteprima pubblica | Termine di disponibilità generale |
|---|---|
blockItems |
blocklistItems |
BlockItemId |
blocklistItemId |
blockItemIds |
blocklistItemIds |
blocklistMatchResults |
blocklistsMatch |
breakByBlocklists |
haltOnBlocklistHit |
Formati di risposta
Alcuni formati JSON restituiti sono stati modificati. Vedere gli esempi seguenti di restituzione JSON aggiornati.
Chiamata API text:analyze con l'analisi delle categorie:
{
"categoriesAnalysis": [
{
"category": "Hate",
"severity": 2
},
{
"category": "SelfHarm",
"severity": 0
},
{
"category": "Sexual",
"severity": 0
},
{
"category": "Violence",
"severity": 0
}
]
}
Chiamata API text:analyze con un elenco di elementi bloccati:
{
"blocklistsMatch": [
{
"blocklistName": "string",
"blocklistItemId": "string",
"blocklistItemText": "bleed"
}
],
"categoriesAnalysis": [
{
"category": "Hate",
"severity": 0
}
]
}
Chiamata API addOrUpdateBlocklistItems:
{
"blocklistItems:"[
{
"blocklistItemId": "string",
"description": "string",
"text": "bleed"
}
]
}
Chiamata API blocklistItems (elencare tutti gli elementi dell'elenco di elementi bloccati):
{
"values": [
{
"blocklistItemId": "string",
"description": "string",
"text": "bleed",
}
]
}
Chiamata API blocklistItems con un ID elemento (recuperare un singolo elemento):
{
"blocklistItemId": "string",
"description": "string",
"text": "string"
}