Partage via

Migrer à partir de la préversion publique d’Azure AI Sécurité du Contenu vers la GA

  • Article

Ce guide vous explique comment mettre à niveau votre code existant à partir de la préversion publique d’Azure AI Sécurité du contenu vers la version en GA.

Appels de l’API REST

Dans tous les appels d’API, veillez à modifier le paramètre api-version dans votre code :

old new
api-version=2023-04-30-preview api-version=2023-10-01

Notez que le nom du point de terminaison REST suivant change :

Terme de la préversion publique Terme de la GA
addBlockItems addOrUpdateBlocklistItems
blockItems blocklistItems
removeBlockItems removeBlocklistItems

Champs JSON

Les champs JSON suivants ont été renommés. Veillez à les modifier lorsque vous envoyez des données à un appel REST :

Terme de la préversion publique Terme de la GA
blockItems blocklistItems
BlockItemId blocklistItemId
blockItemIds blocklistItemIds
blocklistMatchResults blocklistsMatch
breakByBlocklists haltOnBlocklistHit

Formats de retour

Certains formats de retour JSON ont changé. Consultez les exemples de retour JSON mis à jour suivants.

L’appel d’API text:analyze avec une analyse de la catégorie :

{
  "categoriesAnalysis": [
    {
      "category": "Hate",
      "severity": 2
    },
    {
      "category": "SelfHarm",
      "severity": 0
    },
    {
      "category": "Sexual",
      "severity": 0
    },
    {
      "category": "Violence",
      "severity": 0
    }
 ]
}

L’appel d’API text:analyze avec une liste de blocage :

{
  "blocklistsMatch": [
    {
      "blocklistName": "string",
      "blocklistItemId": "string",
      "blocklistItemText": "bleed"
    }
  ],
  "categoriesAnalysis": [
    {
      "category": "Hate",
      "severity": 0
    }
  ]
}

L’appel d’API addOrUpdateBlocklistItems :

{
  "blocklistItems:"[
    {
      "blocklistItemId": "string",
      "description": "string",
      "text": "bleed"
    }
  ]
}

L’appel d’API blocklistItems (lister tous les éléments de la liste de blocage) :

{
  "values": [
    {
      "blocklistItemId": "string",
      "description": "string",
      "text": "bleed",
    }
  ]
}

L’appel d’API blocklistItems avec un ID d’élément (récupérer un seul élément) :

{
  "blocklistItemId": "string",
  "description": "string",
  "text": "string"
}

Étapes suivantes