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.
Navegar hasta la referencia de API
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.
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.
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.