Memoderasi teks dari konsol API

Gunakan Text Moderation API di Azure Content Moderator untuk memindai konten teks Anda untuk kata-kata kotor dan membandingkannya dengan daftar kustom dan bersama.

Mendapatkan kunci API Anda

Sebelum dapat melakukan uji coba API di konsol online, Anda memerlukan kunci langganan. Ini terletak pada tab Pengaturan, dalam kotak Ocp-Apim-Subscription-Key. Untuk mengetahui informasi selengkapnya, lihat Gambaran Umum.

Menavigasi ke referensi API

Buka referensi Text Moderation API.

Halaman Teks - Layar terbuka.

Membuka konsol API

Untuk konsol pengujian Open API, pilih wilayah yang paling menjelaskan lokasi Anda.

Konsol API Teks - Layar terbuka.

Memilih input

Parameter

Pilih parameter kueri yang ingin Anda gunakan di layar teks Anda. Untuk contoh ini, gunakan nilai default untuk bahasa. Anda juga dapat membiarkannya kosong karena operasi akan otomatis mendeteksi bahasa yang mungkin sebagai bagian dari eksekusinya.

Catatan

Untuk parameter language, tetapkan eng atau biarkan kosong untuk melihat respons klasifikasi yang dibantu mesin (fitur pratinjau). Fitur ini hanya mendukung bahasa Inggris.

Untuk deteksi istilah kata-kata kotor, gunakan kode ISO 639-3 dari bahasa yang didukung yang tercantum dalam artikel ini, atau biarkan kosong.

Untuk koreksi otomatis, PII, dan mengklasifikasikan (pratinjau) , pilih true. Biarkan bidang ListId kosong.

Jenis konten

Untuk Konten-Jenis, pilih jenis konten yang ingin Anda saring. Untuk contoh ini, gunakan jenis konten teks/biasa default. Dalam kotak Ocp-Apim-Subscription-Key, masukkan kunci langganan Anda.

Sampel teks yang akan dipindai

Dalam kotak Isi permintaan, masukkan beberapa teks. Contoh berikut menunjukkan kesalahan ketik yang disengaja dalam teks.

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

Menganalisis respons

Respons berikut menunjukkan berbagai wawasan dari API. Ini berisi potensi kata-kata kotor, data pribadi, klasifikasi (pratinjau), dan versi yang dikoreksi otomatis.

Catatan

Fitur 'Klasifikasi' yang dibantu mesin berada dalam pratinjau dan hanya mendukung bahasa Inggris.

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

Untuk penjelasan terperinci tentang semua bagian dalam respons JSON, lihat panduan konseptual Moderasi teks.

Langkah berikutnya

Gunakan REST API dalam kode Anda, atau ikuti mulai cepat .NET SDK untuk berintegrasi dengan aplikasi Anda.