다음을 통해 공유


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"
}

다음 단계