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

Passaggio successivo

Istruzioni di avvio rapido: analizzare il contenuto di testo