Menentukan dan menggunakan pekerjaan moderasi (konsol API)

Perhatian

Alat Ulasan Moderator Konten kini sudah tidak digunakan lagi dan akan dihentikan pada 31/12/2021.

Pekerjaan moderasi berfungsi sebagai semacam pembungkus untuk fungsionalitas moderasi konten, alur kerja, dan tinjauan. Panduan ini menunjukkan cara menggunakan REST API pekerjaan untuk memulai dan memeriksa pekerjaan moderasi konten. Setelah memahami struktur API, Anda dapat dengan mudah mentransfer panggilan ini ke platform yang kompatibel dengan REST mana pun.

Prasyarat

Membuat pekerjaan

Untuk membuat pekerjaan moderasi, buka halaman referensi API Pekerjaan - Buat dan pilih tombol untuk wilayah langganan Anda. Anda dapat menemukan wilayah di URL Titik Akhir pada halaman Info masuk dari Alat Peninjauan. Hal ini memulai konsol API, tempat Anda dapat dengan mudah membuat dan menjalankan panggilan REST API.

Pekerjaan - Membuat pilihan wilayah halaman

Memasukkan parameter panggilan REST

Masukkan nilai berikut untuk membuat panggilan REST:

  • teamName: ID tim yang Anda buat saat menyiapkan akun Alat Peninjauan (dapat ditemukan di bidang Id pada layar Info Masuk alat Peninjauan Anda).
  • ContentType: Ini bisa berupa "Gambar", "Teks", atau "Video".
  • ContentId: String pengidentifikasi kustom. String ini diteruskan ke API dan dikembalikan melalui panggilan balik. Hal ini berguna untuk mengaitkan pengidentifikasi internal atau metadata dengan hasil pekerjaan moderasi.
  • Workflowname: Nama alur kerja yang Anda buat sebelumnya (atau "default" untuk alur kerja default).
  • CallbackEndpoint: (Opsional) URL untuk menerima informasi panggilan balik saat peninjauan selesai.
  • Ocp-Apim-Subscription-Key: Kunci Moderator Konten Anda. Anda dapat menemukan kunci ini di tab Pengaturan pada Alat Peninjauan.

Isi badan permintaan

Isi panggilan REST Anda berisi satu bidang, ContentValue. Tempelkan konten teks mentah jika Anda memoderasi teks, atau masukkan URL gambar atau video jika memoderasi gambar atau video. Anda dapat menggunakan URL gambar sampel berikut: https://moderatorsampleimages.blob.core.windows.net/samples/sample2.jpg

Pekerjaan - Membuat parameter kueri konsol, header, dan kotak isi Permintaan

Kirim permintaan Anda

Pilih Kirim. Jika operasi berhasil, Status respons adalah 200 OK, dan kotak Konten respons menampilkan ID untuk pekerjaan tersebut. Salin ID ini untuk digunakan dalam langkah-langkah berikut.

Peninjauan - Membuat konsol, Kotak konten respons yang menampilkan ID peninjauan

Mendapatkan status pekerjaan

Untuk mendapatkan status dan detail pekerjaan yang sedang berjalan atau selesai, buka halaman referensi API Pekerjaan - Mendapatkan dan pilih tombol untuk wilayah Anda (wilayah tempat kunci Anda diberikan).

Pekerjaan - Mendapatkan pilihan wilayah

Masukkan parameter panggilan REST seperti pada bagian di atas. Untuk langkah ini, JobId adalah string ID unik yang Anda terima saat membuat pekerjaan. Pilih Kirim. Jika operasi berhasil, Status respons adalah 200 OK, dan kotak Konten respons menampilkan pekerjaan dalam format JSON, seperti berikut:

{  
  "Id":"2018014caceddebfe9446fab29056fd8d31ffe",
  "TeamName":"some team name",
  "Status":"Complete",
  "WorkflowId":"OCR",
  "Type":"Image",
  "CallBackEndpoint":"",
  "ReviewId":"201801i28fc0f7cbf424447846e509af853ea54",
  "ResultMetaData":[  
    {  
      "Key":"hasText",
      "Value":"True"
    },
    {  
      "Key":"ocrText",
      "Value":"IF WE DID \r\nALL \r\nTHE THINGS \r\nWE ARE \r\nCAPABLE \r\nOF DOING, \r\nWE WOULD \r\nLITERALLY \r\nASTOUND \r\nOURSELVE \r\n"
    }
  ],
  "JobExecutionReport":[  
    {  
      "Ts":"2018-01-07T00:38:29.3238715",
      "Msg":"Posted results to the Callbackendpoint: https://requestb.in/vxke1mvx"
    },
    {  
      "Ts":"2018-01-07T00:38:29.2928416",
      "Msg":"Job marked completed and job content has been removed"
    },
    {  
      "Ts":"2018-01-07T00:38:29.0856472",
      "Msg":"Execution Complete"
    },
    {  
      "Ts":"2018-01-07T00:38:26.7714671",
      "Msg":"Successfully got hasText response from Moderator"
    },
    {  
      "Ts":"2018-01-07T00:38:26.4181346",
      "Msg":"Getting hasText from Moderator"
    },
    {  
      "Ts":"2018-01-07T00:38:25.5122828",
      "Msg":"Starting Execution - Try 1"
    }
  ]
}

Pekerjaan - Mendapatkan respons panggilan REST

Periksa tinjauan baru

Jika pekerjaan konten menghasilkan pembuatan tinjauan, Anda dapat melihatnya di Alat Peninjauan. Pilih Tinjau > Gambar/Teks/Video (bergantung pada konten yang Anda gunakan). Konten akan muncul, siap untuk ditinjau oleh manusia. Setelah moderator manusia meninjau tag dan data prediksi yang ditetapkan secara otomatis dan mengirimkan keputusan moderasi akhir, API pekerjaan mengirimkan semua informasi ini ke titik akhir panggilan balik yang ditentukan.

Langkah berikutnya

Dalam panduan ini, Anda mempelajari cara membuat dan mengkueri pekerjaan moderasi konten menggunakan REST API. Selanjutnya, integrasikan pekerjaan ke dalam skenario moderasi ujung ke ujung, seperti tutorial Moderasi e-niaga.