Tekst beheren vanuit de API-console

Gebruik de Text Moderation-API in Azure Content Moderator om uw tekstinhoud te scannen op grof taalgebruik en deze te vergelijken met aangepaste en gedeelde lijsten.

Uw API-sleutel ophalen

Voordat u de API in de onlineconsole kunt testen, hebt u uw abonnementssleutel nodig. Dit bevindt zich op het tabblad Instellingen in het vak Ocp-Apim-Subscription-Key. Zie Overzicht voor meer informatie.

Navigeer naar de API-verwijzing

Ga naar de naslaginformatie over de Text Moderation-API.

De pagina Tekst - Scherm wordt geopend.

De API-console openen

Selecteer voor de Open API-testconsole de regio die uw locatie het meest beschrijft.

De console Text - Screen API wordt geopend.

De invoer selecteren

Parameters

Selecteer de queryparameters die u wilt gebruiken in het tekstscherm. Gebruik voor dit voorbeeld de standaardwaarde voor taal. U kunt deze ook leeg laten omdat de bewerking automatisch de waarschijnlijke taal detecteert als onderdeel van de uitvoering.

Notitie

Voor de taalparameter wijst u deze toe eng of laat u deze leeg om het antwoord op de door de machine ondersteunde classificatie (preview-functie) te zien. Deze functie ondersteunt alleen Engels.

Voor de detectie van grof taalgebruik gebruikt u de ISO 639-3-code van de ondersteunde talen die in dit artikel worden vermeld of laat u deze leeg.

Voor autocorrectie, PII en classificeren (preview), selecteert u waar. Laat het veld ListId leeg.

Content type

Selecteer voor Inhoudstype het type inhoud dat u wilt weergeven. Gebruik voor dit voorbeeld het standaardtekst -/inhoudstype zonder opmaak . Voer uw abonnementssleutel in het vak Ocp-Apim-Subscription-Key in.

Voorbeeldtekst die moet worden gescand

Voer in het vak Hoofdtekst van de aanvraag tekst in. In het volgende voorbeeld ziet u een opzettelijke typfout in de tekst.

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

Het antwoord analyseren

In het volgende antwoord ziet u de verschillende inzichten van de API. Het bevat mogelijke grof taalgebruik, persoonlijke gegevens, classificatie (preview) en de automatisch gecorrigeerde versie.

Notitie

De functie Classificatie die door de machine wordt ondersteund, is in preview en biedt alleen ondersteuning voor Engels.

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

Raadpleeg de conceptuele handleiding tekstbeheer voor een gedetailleerde uitleg van alle secties in het JSON-antwoord.

Volgende stappen

Gebruik de REST API in uw code of volg de quickstart voor de .NET SDK om te integreren met uw toepassing.