Migrieren von der Public Preview von Azure KI Inhaltssicherheit zur öffentlich verfügbaren Version
Dieser Artikel zeigt Ihnen, wie Sie ein Upgrade für Ihren vorhandenen Code aus der öffentlichen Vorschauversion von Azure KI Inhaltssicherheit auf die allgemein verfügbare Version durchführen.
REST-API-Aufrufe
Achten Sie bei allen API-Aufrufen darauf, den Parameter api-version in Ihrem Code zu ändern:
old | neu |
---|---|
api-version=2023-04-30-preview |
api-version=2023-10-01 |
Beachten Sie die folgenden Änderungen des REST-Endpunktnamens:
Benennung in der öffentlichen Vorschauversion | Benennung in der allgemein verfügbaren Version |
---|---|
addBlockItems | addOrUpdateBlocklistItems |
blockItems | blocklistItems |
removeBlockItems | removeBlocklistItems |
JSON-Felder
Die folgenden JSON-Felder wurden umbenannt. Achten Sie darauf, diese zu ändern, wenn Sie Daten an einen REST-Aufruf senden:
Benennung in der öffentlichen Vorschauversion | Benennung in der allgemein verfügbaren Version |
---|---|
blockItems |
blocklistItems |
BlockItemId |
blocklistItemId |
blockItemIds |
blocklistItemIds |
blocklistMatchResults |
blocklistsMatch |
breakByBlocklists |
haltOnBlocklistHit |
Rückgabeformat
Einige JSON-Rückgabeformate wurden geändert. Sehen Sie sich die folgenden aktualisierten JSON-Rückgabebeispiele an.
Den API-Aufruf text:analyze mit einer Kategorieanalyse:
{
"categoriesAnalysis": [
{
"category": "Hate",
"severity": 2
},
{
"category": "SelfHarm",
"severity": 0
},
{
"category": "Sexual",
"severity": 0
},
{
"category": "Violence",
"severity": 0
}
]
}
Den API-Aufruf text:analyze mit einer Blockliste:
{
"blocklistsMatch": [
{
"blocklistName": "string",
"blocklistItemId": "string",
"blocklistItemText": "bleed"
}
],
"categoriesAnalysis": [
{
"category": "Hate",
"severity": 0
}
]
}
Den API-Aufruf addOrUpdateBlocklistItems:
{
"blocklistItems:"[
{
"blocklistItemId": "string",
"description": "string",
"text": "bleed"
}
]
}
Den API-Aufruf blocklistItems (Auflisten aller Blocklistenelemente):
{
"values": [
{
"blocklistItemId": "string",
"description": "string",
"text": "bleed",
}
]
}
Den API-Aufruf blocklistItems mit einer Element-ID (Abrufen eines einzelnen Elements):
{
"blocklistItemId": "string",
"description": "string",
"text": "string"
}