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