Migrar da versão prévia pública da Segurança de Conteúdo da IA do Azure para o GA
Essa guia mostra como atualizar o código existente da versão prévia pública do Azure AI Content Safety para a versão em disponibilidade geral.
Chamadas API REST
Em todas as chamadas à API, certifique-se de alterar o parâmetro api-version em seu código:
| old | new |
|---|---|
api-version=2023-04-30-preview |
api-version=2023-10-01 (ou versão posterior) |
Observe as seguintes alterações no nome do ponto de extremidade REST da API de versão prévia:
| Termo da versão prévia pública | Termo de disponibilidade geral |
|---|---|
| addBlockItems | addOrUpdateBlocklistItems |
| blockItems | blocklistItems |
| removeBlockItems | removeBlocklistItems |
Campos JSON
Os campos JSON a seguir foram renomeados. Certifique-se de alterá-los ao enviar dados para uma chamada REST:
| Termo da versão prévia pública | Termo da disponibilidade geral |
|---|---|
blockItems |
blocklistItems |
BlockItemId |
blocklistItemId |
blockItemIds |
blocklistItemIds |
blocklistMatchResults |
blocklistsMatch |
breakByBlocklists |
haltOnBlocklistHit |
Formatos de retorno
Alguns dos formatos de retorno JSON foram alterados. Veja os exemplos de retorno JSON atualizados a seguir.
A chamada à API text:analyze com a análise de categoria:
{
"categoriesAnalysis": [
{
"category": "Hate",
"severity": 2
},
{
"category": "SelfHarm",
"severity": 0
},
{
"category": "Sexual",
"severity": 0
},
{
"category": "Violence",
"severity": 0
}
]
}
A chamada à API text:analyze com uma lista de bloqueios:
{
"blocklistsMatch": [
{
"blocklistName": "string",
"blocklistItemId": "string",
"blocklistItemText": "bleed"
}
],
"categoriesAnalysis": [
{
"category": "Hate",
"severity": 0
}
]
}
A chamada à API addOrUpdateBlocklistItems :
{
"blocklistItems:"[
{
"blocklistItemId": "string",
"description": "string",
"text": "bleed"
}
]
}
A chamada à API blocklistItems (listar todos os itens da lista de bloqueio):
{
"values": [
{
"blocklistItemId": "string",
"description": "string",
"text": "bleed",
}
]
}
A chamada à API blocklistItems com uma ID de item (recuperar um único item):
{
"blocklistItemId": "string",
"description": "string",
"text": "string"
}