Migración de la versión preliminar pública de Seguridad del contenido de Azure AI a disponibilidad general
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"
}