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 반환 예제를 참조하세요.
범주 분석을 사용한 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",
}
]
}
항목 ID를 사용한 blocklistItems API 호출(단일 항목 검색):
{
"blocklistItemId": "string",
"description": "string",
"text": "string"
}