Moderación de texto desde la consola de API

Use la API de moderación de texto de Azure Content Moderator para examinar el texto, detectar las blasfemias y compararlo con listas personalizadas y compartidas.

Obtener la clave de API

Antes de probar la API en la consola en línea, necesita la clave de suscripción. Se encuentra en la pestaña Configuración, en el cuadro Ocp-Apim-Subscription-Key. Para más información, consulte Información general.

Vaya a la referencia de Text Moderation API.

Se abre la página Text - Screen (Texto: filtrar).

Abrir la consola de API

En Open API testing console (Abrir consola de pruebas de API), seleccione la región que mejor describa su ubicación.

Text - Screen page region selection

Se abre la consola de API de Text - Screen (Texto: filtrar).

Seleccionar las entradas

Parámetros

Seleccione los parámetros de consulta que quiere usar en la pantalla de texto. En este ejemplo, utilice el valor predeterminado de language (idioma). También puede dejarlo en blanco, ya que la operación detectará automáticamente el idioma probable como parte de su ejecución.

Nota

Para el parámetro language (idioma), asigne eng o déjelo en blanco para ver la respuesta classification (clasificación) asistida por máquina. Esta característica solo admite inglés.

Para la detección de palabras soeces, use el código ISO 639-3 de los idiomas admitidos que se enumeran en este artículo, o deje el campo en blanco.

Para autocorrect (autocorrección), PII (DCP) y classify (preview) [clasificar (versión preliminar)], seleccione true. Deje el campo ListId vacío.

Text - Screen console query parameters

Tipo de contenido

Para Content-Type, seleccione el tipo de contenido que quiera filtrar. Para este ejemplo, use el tipo predeterminado text/plain (texto/sin formato). En el cuadro Ocp-Apim-Subscription-Key, especifique la clave de suscripción.

Texto de ejemplo que se va a examinar

En el cuadro Request body (Cuerpo de la solicitud), escriba algo de texto. En el ejemplo siguiente se muestra un error intencionado en el 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.

Análisis de la respuesta

La respuesta siguiente muestra las distintas conclusiones desde la API. Contiene posibles palabras soeces, datos personales, clasificación (versión preliminar) y la versión corregida automáticamente.

Nota

La característica "Classification" (Clasificación) asistida por máquina está en versión preliminar y solo admite 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 una explicación detallada de todas las secciones de la respuesta JSON, consulte la guía conceptual de moderación de texto.

Pasos siguientes

Use la API REST del código o siga el inicio rápido del SDK de .NET para realizar la integración con la aplicación.