Moderieren von Text über die API-Konsole

Verwenden Sie die Textmoderations-API in Azure Content Moderator, um Ihren Textinhalt auf Obszönitäten zu überprüfen und ihn mit benutzerdefinierten und geteilten Listen abzugleichen.

Abrufen Ihres API-Schlüssels

Bevor Sie die API in der Onlinekonsole testen können, benötigen Sie Ihren Abonnementschlüssel. Dieser befindet sich auf der Registerkarte Einstellungen im Feld Ocp-Apim-Subscription-Key. Weitere Informationen finden Sie in der Übersicht.

Navigieren zur API-Referenz

Greifen Sie auf die Referenz zur Textmoderations-API zu.

Die Seite Text – Screen (Text – Überprüfen) wird geöffnet.

Öffnen der API-Konsole

Wählen Sie für API-Testkonsole öffnen die Region aus, die Ihrem Standort am ehesten nahekommt.

Die API-Konsole Text – Screen (Text – Überprüfen) wird geöffnet.

Auswählen der Eingaben

Parameter

Wählen Sie die Abfrageparameter aus, die Sie für Ihre Textüberprüfung verwenden möchten. Verwenden Sie beispielsweise den Standardwert für language. Sie können das Feld auch leer lassen, da der Vorgang die zutreffende Sprache im Rahmen der Ausführung automatisch erkennt.

Hinweis

Weisen Sie für den Parameter language entweder eng zu, oder lassen Sie ihn leer, um die computergestützte Klassifizierungsantwort (Vorschaufeature) zu erhalten. Dieses Feature wird nur für Englisch unterstützt.

Verwenden Sie für die Erkennung anstößiger Begriffe den ISO 639-3-Code der unterstützten Sprachen aus diesem Artikel, oder lassen Sie ihn leer.

Wählen Sie für autocorrect, PII und classify (preview) die Option true. Lassen Sie das Feld ListId leer.

Inhaltstyp

Wählen Sie für Content-Type den Inhaltstyp aus, den Sie überprüfen möchten. Verwenden Sie für dieses Beispiel den Standardinhaltstyp text/plain. Geben Sie in das Feld Ocp-Apim-Subscription-Key Ihren Abonnementschlüssel ein.

Beispieltext für Scan

Geben Sie im Feld Anforderungstext Text ein. Das folgende Beispiel enthält im Text einen absichtlichen Rechtschreibfehler.

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

Analysieren der Antwort

In der folgenden Antwort sind die verschiedenen Erkenntnisse dargestellt, die über die API gewonnen werden können. Diese umfassen potenzielle Obszönitäten, personenbezogene Daten, Klassifizierungen (Vorschauversion) und die automatisch korrigierte Version.

Hinweis

Das computergestützte Feature „Klassifizierung“ befindet sich in der Vorschauphase und unterstützt nur Englisch.

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

Eine ausführliche Erläuterung aller Abschnitte in der JSON-Antwort finden Sie im Konzeptleitfaden Lernen von Textmoderationskonzepten.

Nächste Schritte

Verwenden Sie die REST-API im Code, oder befolgen Sie die Anweisungen im .NET SDK-Schnellstart für die Integration mit Ihrer Anwendung.