Moderowanie tekstu z konsoli interfejsu API

  • Artykuł

Interfejs API moderowania tekstu w usłudze Azure Content Moderator umożliwia skanowanie zawartości tekstowej pod kątem wulgaryzmów i porównywanie ich z listami niestandardowymi i udostępnionymi.

Uzyskiwanie klucza interfejsu API

Aby można było przetestować interfejs API w konsoli online, potrzebny jest klucz subskrypcji. Znajduje się on na karcie Ustawienia w polu Ocp-Apim-Subscription-Key. Aby uzyskać więcej informacji, zobacz Omówienie.

Przejdź do dokumentacji interfejsu API moderowania tekstu.

Zostanie otwarta strona Tekst — ekran .

Otwieranie konsoli interfejsu API

W obszarze Otwórz konsolę testowania interfejsu API wybierz region, który najlepiej opisuje twoją lokalizację.

Text - Screen page region selection

Zostanie otwarta konsola interfejsu API tekstu — ekran .

Wybieranie danych wejściowych

Parametry

Wybierz parametry zapytania, których chcesz użyć na ekranie tekstowym. W tym przykładzie użyj wartości domyślnej języka. Możesz również pozostawić ją pustą, ponieważ operacja automatycznie wykryje prawdopodobny język w ramach jego wykonywania.

Uwaga

W przypadku parametru języka przypisz eng lub pozostaw go pusty, aby wyświetlić odpowiedź klasyfikacji wspomaganej przez maszynę (funkcja w wersji zapoznawczej). Ta funkcja obsługuje tylko język angielski.

W przypadku wykrywania terminów wulgaryzmów użyj kodu ISO 639-3 obsługiwanych języków wymienionych w tym artykule lub pozostaw go pusty.

W przypadku autokorekty, danych PII i klasyfikowania (wersja zapoznawcza) wybierz wartość true. Pozostaw puste pole ListId .

Text - Screen console query parameters

Typ zawartości

W polu Content-Type (Typ zawartości) wybierz typ zawartości, którą chcesz ekranować. W tym przykładzie użyj domyślnego typu zawartości text/plain . W polu Ocp-Apim-Subscription-Key wprowadź klucz subskrypcji.

Przykładowy tekst do skanowania

W polu Treść żądania wprowadź tekst. W poniższym przykładzie pokazano celowe literówki w tekście.

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

Analizowanie odpowiedzi

Poniższa odpowiedź przedstawia różne szczegółowe informacje z interfejsu API. Zawiera ona potencjalne wulgaryzmy, dane osobowe, klasyfikację (wersja zapoznawcza) i wersję poprawną automatycznie.

Uwaga

Funkcja "Klasyfikacja" wspomagana przez maszynę jest dostępna w wersji zapoznawczej i obsługuje tylko język angielski.

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

Aby uzyskać szczegółowe wyjaśnienie wszystkich sekcji w odpowiedzi JSON, zapoznaj się z przewodnikiem koncepcyjnym Moderowanie tekstu.

Następne kroki

Użyj interfejsu API REST w kodzie lub postępuj zgodnie z przewodnikiem Szybki start zestawu .NET SDK, aby zintegrować się z aplikacją.