Moderar texto do console da API

Use a API de Moderação de Texto no Azure Content Moderator para verificar seu conteúdo de texto em busca de palavrões e compará-lo com listas personalizadas e compartilhadas.

Obtenha sua chave de API

Antes de poder testar a API no console online, você precisa da sua chave de assinatura. Isso está localizado na guia Configurações, na caixa Ocp-Apim-Subscription-Key. Para obter mais informações, veja Descrição geral.

Navegue até a referência da API

Vá para a referência da API de moderação de texto.

A página Texto - Tela é aberta.

Abra o console da API

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

O console da API Text - Screen é aberto.

Selecione as entradas

Parâmetros

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

Nota

Para o parâmetro language, atribua-o eng ou deixe-o vazio para ver a resposta de classificação assistida por máquina (recurso de visualização). Esta funcionalidade suporta apenas inglês.

Para deteção de termos de palavrões, use o código ISO 639-3 dos idiomas suportados listados neste artigo ou deixe-o vazio.

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

Tipo de conteúdo

Em Content-Type, selecione o tipo de conteúdo que deseja exibir. Para este exemplo, use o tipo de conteúdo text/plain padrão. Na caixa Ocp-Apim-Subscription-Key, introduza a sua chave de subscrição.

Texto de exemplo a ser escaneado

Na caixa Corpo da solicitação , insira 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.

Analise a resposta

A resposta a seguir mostra os vários insights da API. Contém potenciais palavrões, dados pessoais, classificação (pré-visualização) e a versão corrigida automaticamente.

Nota

A funcionalidade 'Classificação' assistida por máquina está em pré-visualização e suporta apenas 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 de moderação de texto.

Próximos passos

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