Partilhar via


Migrar da pré-visualização pública do Azure AI Content Safety para o GA

Este guia mostra como atualizar seu código existente da versão de visualização pública do Azure AI Content Safety para a versão GA.

Chamadas à API REST

Em todas as chamadas de API, certifique-se de alterar o parâmetro api-version em seu código:

antigo novo
api-version=2023-04-30-preview api-version=2023-10-01

Observe as seguintes alterações no nome do ponto de extremidade REST:

Termo de pré-visualização pública Termo da AG
addBlockItems addOrUpdateBlocklistItems
blockItems blocklistItems
removeBlockItems removeBlocklistItems

Campos JSON

Os seguintes campos JSON foram renomeados. Certifique-se de alterá-los quando enviar dados para uma chamada REST:

Termo de pré-visualização pública Termo da AG
blockItems blocklistItems
BlockItemId blocklistItemId
blockItemIds blocklistItemIds
blocklistMatchResults blocklistsMatch
breakByBlocklists haltOnBlocklistHit

Formatos de retorno

Alguns dos formatos de retorno JSON foram alterados. Consulte os seguintes exemplos de retorno JSON atualizados.

O texto:analisar chamada de API com análise de categoria:

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

O texto:analisar chamada de API com uma lista de bloqueio:

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

A chamada da API addOrUpdateBlocklistItems :

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

A chamada da API blocklistItems (liste todos os itens da lista de bloqueios):

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

A chamada da API blocklistItems com um ID de item (recuperar um único item):

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

Próximos passos