從 Azure AI 內容安全公開預覽版移轉至 GA
本指南說明如何將現有的程式碼從 Azure AI 內容安全的公開預覽版本升級為 GA 版本。
REST API 呼叫
在所有 API 呼叫中，務必變更程式碼中的 api-version 參數：
| old | new |
|---|---|
api-version=2023-04-30-preview |
api-version=2023-10-01 |
請注意下列 REST 端點名稱變更：
| 公開預覽詞彙 | GA 詞彙 |
|---|---|
| addBlockItems | addOrUpdateBlocklistItems |
| blockItems | blocklistItems |
| removeBlockItems | removeBlocklistItems |
JSON 欄位
下列 JSON 欄位已重新命名。 當您將資料傳送至 REST 呼叫時，務必加以變更：
| 公開預覽詞彙 | GA 詞彙 |
|---|---|
blockItems |
blocklistItems |
BlockItemId |
blocklistItemId |
blockItemIds |
blocklistItemIds |
blocklistMatchResults |
blocklistsMatch |
breakByBlocklists |
haltOnBlocklistHit |
傳回格式
部分 JSON 傳回格式已變更。 請參閱下列更新的 JSON 傳回範例。
包含類別分析的 ext:analyze API 呼叫：
{
"categoriesAnalysis": [
{
"category": "Hate",
"severity": 2
},
{
"category": "SelfHarm",
"severity": 0
},
{
"category": "Sexual",
"severity": 0
},
{
"category": "Violence",
"severity": 0
}
]
}
包含封鎖清單的 text:analyze API 呼叫：
{
"blocklistsMatch": [
{
"blocklistName": "string",
"blocklistItemId": "string",
"blocklistItemText": "bleed"
}
],
"categoriesAnalysis": [
{
"category": "Hate",
"severity": 0
}
]
}
addOrUpdateBlocklistItems API 呼叫：
{
"blocklistItems:"[
{
"blocklistItemId": "string",
"description": "string",
"text": "bleed"
}
]
}
blocklistItems API 呼叫 (列出所有封鎖清單項目)：
{
"values": [
{
"blocklistItemId": "string",
"description": "string",
"text": "bleed",
}
]
}
包含項目識別碼的 blocklistItems API 呼叫 (擷取單一項目)：
{
"blocklistItemId": "string",
"description": "string",
"text": "string"
}