Moderar texto no console da API

Use a API de Moderação de Texto no Azure Content Moderator para verificar o conteúdo do texto quanto à linguagem imprópria e compare-a com listas personalizadas e compartilhadas.

Obter sua chave de API

Antes de testar a API no console online, você precisa da chave de assinatura. Ela está localizada na guia Configurações, na caixa Ocp-Apim-Subscription-Key. Para obter mais informações, consulte Visão Geral.

Navegar até a referência da API

Vá para a referência da API de Moderação de Texto.

A página Texto - Tela será aberta.

Abrir o console da API

Para Abrir o console de teste da API, selecione a região que melhor descreve seu local.

O console da API de Texto - Tela será aberto.

Selecionar entradas

Parâmetros

Selecione os parâmetros de consulta que você deseja usar em sua tela de texto. Para este exemplo, use o valor padrão para idioma. Você também pode deixar em branco porque a operação detectará automaticamente o idioma provável como parte de sua execução.

Observação

Para o parâmetro language, atribua eng ou deixe vazio para ver a resposta de classificação assistida por computador (recurso de visualização). Esse recurso dá suporte ao inglês apenas.

Para a detecção de termos obscenos, use o código ISO 639-3 dos idiomas com suporte listados neste artigo ou deixe vazio.

Para a correção automática, PII e classificar (visualização), selecione true. Deixe o campo ListId vazio.

Tipo de conteúdo

Para Content-Type, selecione o tipo de conteúdo que você deseja na tela. Para este exemplo, use o tipo de conteúdo texto/simples padrão. Na caixa Ocp-Apim-Subscription-Key, insira sua chave de assinatura.

Texto de exemplo para examinar

Na caixa Corpo da solicitação, digite algum texto. O exemplo a seguir mostra um erro de digitação intencional no texto.

Is this a grabage or <offensive word> email abcdef@abcd.com, phone: 4255550111, IP: 
255.255.255.255, 1234 Main Boulevard, Panapolis WA 96555.

Analisar a resposta

A resposta a seguir mostra as várias informações da API. Contém possível linguagem imprópria, dados pessoais, classificação (versão prévia) e a versão corrigida automaticamente.

Observação

O recurso “Classificação” assistido por computador está na visualização e suporta apenas o inglês.

{
   "original_text":"Is this a grabage or <offensive word> email abcdef@abcd.com, phone: 
   6657789887, IP: 255.255.255.255, 1 Microsoft Way, Redmond, WA 98052.",
   "normalized_text":"   grabage  <offensive word> email abcdef@abcd.com, phone: 
   6657789887, IP: 255.255.255.255, 1 Microsoft Way, Redmond, WA 98052.",
   "auto_corrected_text":"Is this a garbage or <offensive word> email abcdef@abcd.com, phone: 
   6657789887, IP: 255.255.255.255, 1 Microsoft Way, Redmond, WA 98052.",
   "status":{
      "code":3000,
      "description":"OK"
   },
   "pii":{
      "email":[
         {
            "detected":"abcdef@abcd.com",
            "sub_type":"Regular",
            "text":"abcdef@abcd.com",
            "index":32
         }
      ],
      "ssn":[

      ],
      "ipa":[
         {
            "sub_type":"IPV4",
            "text":"255.255.255.255",
            "index":72
         }
      ],
      "phone":[
         {
            "country_code":"US",
            "text":"6657789887",
            "index":56
         }
      ],
      "address":[
         {
            "text":"1 Microsoft Way, Redmond, WA 98052",
            "index":89
         }
      ]
   },
   "language":"eng",
   "terms":[
      {
         "index":12,
         "original_index":21,
         "list_id":0,
         "term":"<offensive word>"
      }
   ],
   "tracking_id":"WU_ibiza_65a1016d-0f67-45d2-b838-b8f373d6d52e_ContentModerator.
   F0_fe000d38-8ecd-47b5-a8b0-4764df00e3b5"
}

Para obter uma explicação detalhada de todas as seções na resposta JSON, consulte o guia conceitual da Moderação de texto.

Próximas etapas

Use a API REST em seu código ou siga o Guia de início rápido do SDK .NET para integrar o aplicativo.