Поделиться через

Миграция из общедоступной предварительной версии содержимого ИИ Azure Сейф ty в общедоступную предварительную версию

  • Статья

В этом руководстве показано, как обновить существующий код с общедоступной предварительной версии содержимого ИИ Azure Сейф ty до общедоступной версии.

Вызовы REST API

Во всех вызовах API обязательно измените параметр версии API в коде:

old Создать...
api-version=2023-04-30-preview api-version=2023-10-01

Обратите внимание на следующие изменения имени конечной точки REST:

Термин общедоступной предварительной версии Термин общедоступной доступности
addBlockItems addOrUpdateBlocklistItems
blockItems blocklistItems
removeBlockItems removeBlocklistItems

Поля JSON

Были переименованы следующие поля JSON. Не забудьте изменить их при отправке данных в вызов REST:

Термин общедоступной предварительной версии Термин общедоступной доступности
blockItems blocklistItems
BlockItemId blocklistItemId
blockItemIds blocklistItemIds
blocklistMatchResults blocklistsMatch
breakByBlocklists haltOnBlocklistHit

Форматы возврата

Некоторые форматы возвращаемых данных JSON изменились. См. следующие обновленные примеры возврата JSON.

Вызов API text:analysis с анализом категорий:

{
  "categoriesAnalysis": [
    {
      "category": "Hate",
      "severity": 2
    },
    {
      "category": "SelfHarm",
      "severity": 0
    },
    {
      "category": "Sexual",
      "severity": 0
    },
    {
      "category": "Violence",
      "severity": 0
    }
 ]
}

Вызов API text:analyze с блок-списком:

{
  "blocklistsMatch": [
    {
      "blocklistName": "string",
      "blocklistItemId": "string",
      "blocklistItemText": "bleed"
    }
  ],
  "categoriesAnalysis": [
    {
      "category": "Hate",
      "severity": 0
    }
  ]
}

Вызов API addOrUpdateBlocklistItems :

{
  "blocklistItems:"[
    {
      "blocklistItemId": "string",
      "description": "string",
      "text": "bleed"
    }
  ]
}

Вызов API blocklistItems (список всех элементов списка блокировок):

{
  "values": [
    {
      "blocklistItemId": "string",
      "description": "string",
      "text": "bleed",
    }
  ]
}

Вызов API blocklistItems с идентификатором элемента (получение одного элемента):

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

Следующие шаги