Azure AI Content Safety パブリック プレビューから GA に移行する
このガイドでは、既存のコードを Azure AI Content Safety のパブリック プレビュー バージョンから 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 の戻り値の例を参照してください。
text: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 呼び出し (項目 ID を使用) (単一項目を取得):
{
"blocklistItemId": "string",
"description": "string",
"text": "string"
}