從 Azure AI 內容 保管庫 公開預覽移轉至 GA

本指南說明如何將現有的程式代碼從公開預覽版本的 Azure AI 內容 保管庫 ty 升級至 GA 版本。

REST API 呼叫

在所有 API 呼叫中，請務必變更 程式代碼中的 api-version 參數：

老	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 呼叫（擷取單一專案）：

{
  "blocklistItemId": "string",
  "description": "string",
  "text": "string"
}

下一步

• 快速入門：分析文字內容