Migración de la versión preliminar pública de Seguridad del contenido de Azure AI a disponibilidad general

  • Artículo

Esta guía muestra cómo actualizar el código existente de la versión preliminar pública de Seguridad del contenido de Azure AI a la versión disponibilidad general.

Llamadas a la API de REST

En todas las llamadas API, asegúrese de cambiar el parámetro api-version en el código:

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

Tenga en cuenta los siguientes cambios en los nombres de los puntos de conexión de REST:

Término de versión preliminar pública Término de disponibilidad general
addBlockItems addOrUpdateBlocklistItems
blockItems blocklistItems
removeBlockItems removeBlocklistItems

Campos JSON

Se ha cambiado el nombre de los siguientes campos JSON. Asegúrese de cambiarlos al enviar datos a una llamada de REST:

Término de versión preliminar pública Término de disponibilidad general
blockItems blocklistItems
BlockItemId blocklistItemId
blockItemIds blocklistItemIds
blocklistMatchResults blocklistsMatch
breakByBlocklists haltOnBlocklistHit

Formatos de devolución

Algunos de los formatos de devolución JSON han cambiado. Vea los siguientes ejemplos de devolución JSON actualizados.

La llamada a la API text:analyze con el análisis de categorías:

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

La llamada a la API text:analyze con una lista de bloqueos:

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

La llamada a la API addOrUpdateBlocklistItems:

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

La llamada a la API blocklistItems (enumerar todos los elementos de la lista de bloqueos):

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

La llamada a la API blocklistItems con un identificador de elemento (recupere un solo elemento):

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

Pasos siguientes