Migrowanie z publicznej wersji zapoznawczej usługi Azure AI Content Safety do ogólnie dostępnej wersji zapoznawczej
W tym przewodniku pokazano, jak uaktualnić istniejący kod z publicznej wersji zapoznawczej bezpieczeństwa zawartości usługi Azure AI do wersji ogólnodostępnej.
Wywołania interfejsu API REST
We wszystkich wywołaniach interfejsu API pamiętaj, aby zmienić parametr api-version w kodzie:
stary | nowe |
---|---|
api-version=2023-04-30-preview |
api-version=2023-10-01 |
Zwróć uwagę na następujące zmiany nazwy punktu końcowego REST:
Termin publicznej wersji zapoznawczej | Termin ogólnie dostępnej dostępności |
---|---|
addBlockItems | addOrUpdateBlocklistItems |
blockItems | blocklistItems |
removeBlockItems | removeBlocklistItems |
Pola JSON
Zmieniono nazwy następujących pól JSON. Pamiętaj, aby je zmienić podczas wysyłania danych do wywołania REST:
Termin publicznej wersji zapoznawczej | Termin ogólnie dostępny |
---|---|
blockItems |
blocklistItems |
BlockItemId |
blocklistItemId |
blockItemIds |
blocklistItemIds |
blocklistMatchResults |
blocklistsMatch |
breakByBlocklists |
haltOnBlocklistHit |
Formaty zwrotne
Niektóre formaty zwracane w formacie JSON uległy zmianie. Zobacz następujące zaktualizowane przykłady zwracanych danych JSON.
Wywołanie interfejsu API text:analyze z analizą kategorii:
{
"categoriesAnalysis": [
{
"category": "Hate",
"severity": 2
},
{
"category": "SelfHarm",
"severity": 0
},
{
"category": "Sexual",
"severity": 0
},
{
"category": "Violence",
"severity": 0
}
]
}
Wywołanie interfejsu API text:analyze z listą bloków:
{
"blocklistsMatch": [
{
"blocklistName": "string",
"blocklistItemId": "string",
"blocklistItemText": "bleed"
}
],
"categoriesAnalysis": [
{
"category": "Hate",
"severity": 0
}
]
}
Wywołanie interfejsu API addOrUpdateBlocklistItems :
{
"blocklistItems:"[
{
"blocklistItemId": "string",
"description": "string",
"text": "bleed"
}
]
}
Wywołanie interfejsu API blocklistItems (lista wszystkich elementów listy zablokowanych):
{
"values": [
{
"blocklistItemId": "string",
"description": "string",
"text": "bleed",
}
]
}
Wywołanie interfejsu API blocklistItems z identyfikatorem elementu (pobieranie pojedynczego elementu):
{
"blocklistItemId": "string",
"description": "string",
"text": "string"
}