Moderera text från API-konsolen

  • Artikel
  • 2 minuter för att läsa

Använd API:et textmoderering i Azure Content Moderator söka igenom ditt textinnehåll efter svordomar och jämföra det med anpassade och delade listor.

Hämta din API-nyckel

Innan du kan provköra API:et i onlinekonsolen behöver du din prenumerationsnyckel. Den finns på fliken Inställningar i rutan Ocp-Apim-Subscription-Key. Mer information finns i Översikt.

Gå till API-referensen textmoderering.

Sidan Text – Skärm öppnas.

Öppna API-konsolen

För Open API-testkonsolen väljer du den region som bäst beskriver din plats.

Text – Val av skärmsida

Konsolen Text – Skärm-API öppnas.

Välj indata

Parametrar

Välj de frågeparametrar som du vill använda på textskärmen. I det här exemplet använder du standardvärdet för språket. Du kan också lämna det tomt eftersom åtgärden automatiskt identifierar det sannolika språket som en del av körningen.

Anteckning

För språkparametern tilldelar eller eng lämnar du den tom för att se det maskinassisterade klassificeringssvaret (förhandsgranskningsfunktionen). Den här funktionen stöder endast engelska.

För identifiering av olämpliga språk använder du ISO 639-3-koden för de språk som stöds i den här artikeln eller lämnar den tom.

För autokorrigering, PII och klassificera (förhandsversion) väljer du true. Lämna fältet ListId tomt.

Text – Frågeparametrar för skärmkonsolen

Innehållstyp

För Innehållstyp väljer du den typ av innehåll som du vill visa. I det här exemplet använder du standardinnehållstypen text/oformaterad. I rutan Ocp-Apim-Subscription-Key anger du din prenumerationsnyckel.

Exempeltext som ska genomsöks

I rutan Begärandetext anger du lite text. I följande exempel visas ett avsiktligt skrivfel i texten.

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

Analysera svaret

Följande svar visar de olika insikterna från API:et. Den innehåller potentiella svordomar, personliga data, klassificering (förhandsversion) och den automatiskt korrigerade versionen.

Anteckning

Funktionen för maskinassisterad klassificering är i förhandsversion och stöder endast engelska.

{
   "original_text":"Is this a grabage or crap email abcdef@abcd.com, phone: 
   6657789887, IP: 255.255.255.255, 1 Microsoft Way, Redmond, WA 98052.",
   "normalized_text":"   grabage  crap 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 crap 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":"crap"
      }
   ],
   "tracking_id":"WU_ibiza_65a1016d-0f67-45d2-b838-b8f373d6d52e_ContentModerator.
   F0_fe000d38-8ecd-47b5-a8b0-4764df00e3b5"
}

En detaljerad förklaring av alla avsnitt i JSON-svaret finns i den konceptuella guiden Textmoderering.

Nästa steg

Använd koden REST API eller följ snabbstarten för .NET SDK för att integrera med ditt program.