Mulai cepat: Deteksi bahan yang dilindungi untuk teks
Fitur Protected Material for Text menyediakan solusi komprehensif untuk mengelola risiko yang terkait dengan konten yang dihasilkan AI (hanya konten bahasa Inggris). Dengan mendeteksi dan mencegah tampilan materi yang dilindungi, organisasi dapat memastikan kepatuhan terhadap undang-undang kekayaan intelektual, mempertahankan orisinalitas konten, dan melindungi reputasi mereka. Materi yang dilindungi mengacu pada konten yang cocok dengan teks yang diketahui dari sumber berhak cipta, seperti lirik lagu, artikel, resep, atau konten web lain yang dipilih.
Tujuan utama fitur Deteksi Bahan Terproteksi untuk Teks untuk konten yang dihasilkan AI adalah:
- Untuk mendeteksi dan mencegah tampilan konten yang dilindungi yang dihasilkan oleh model AI.
- Untuk memungkinkan organisasi mengelola risiko yang terkait dengan konten yang dihasilkan AI.
- Untuk memastikan bahwa konten yang dihasilkan AI mematuhi pedoman kebijakan hukum, etika, dan konten.
Untuk informasi selengkapnya tentang deteksi bahan yang dilindungi, lihat halaman Konsep deteksi material yang dilindungi. Untuk batas input API, lihat bagian Persyaratan input dari Gambaran Umum.
Prasyarat
- Langganan Azure - buat langganan gratis
- Setelah Anda memiliki langganan Azure, buat sumber daya Content Safety di portal Azure untuk mendapatkan kunci dan titik akhir Anda. Masukkan nama unik untuk sumber daya Anda, pilih langganan Anda, dan pilih grup sumber daya, wilayah yang didukung (lihat Ketersediaan wilayah), dan tingkat harga yang didukung. Lalu pilih Buat.
- Sumber daya membutuhkan waktu beberapa menit untuk disebarkan. Setelah selesai, Pilih buka sumber daya. Di panel kiri, di bawah Manajemen Sumber Daya, pilih Kunci Langganan dan Titik Akhir. Titik akhir dan salah satu kunci digunakan untuk memanggil API.
- cURL terpasang
Menganalisis teks untuk deteksi bahan yang dilindungi
Bagian berikut memancang permintaan sampel dengan cURL. Tempelkan perintah di bawah ini ke editor teks, dan buat perubahan berikut.
- Ganti
<endpoint>
dengan URL titik akhir yang terkait dengan sumber daya Anda. - Ganti
<your_subscription_key>
dengan salah satu kunci yang disertakan dengan sumber daya Anda. - Secara opsional, ganti
"text"
bidang dalam isi dengan teks Anda sendiri yang ingin Anda analisis.Tip
Lihat Persyaratan input untuk batasan panjang teks maksimum. Deteksi material yang dilindungi dimaksudkan untuk dijalankan pada penyelesaian LLM, bukan permintaan pengguna.
curl --location --request POST '<endpoint>/contentsafety/text:detectProtectedMaterial?api-version=2024-09-01' \
--header 'Ocp-Apim-Subscription-Key: <your_subscription_key>' \
--header 'Content-Type: application/json' \
--data-raw '{
"text": "Kiss me out of the bearded barley Nightly beside the green, green grass Swing, swing, swing the spinning step You wear those shoes and I will wear that dress Oh, kiss me beneath the milky twilight Lead me out on the moonlit floor Lift your open hand Strike up the band and make the fireflies dance Silver moon's sparkling So, kiss me Kiss me down by the broken tree house Swing me upon its hanging tire Bring, bring, bring your flowered hat We'll take the trail marked on your father's map."
}'
Bidang di bawah ini harus disertakan dalam url:
Nama | Wajib diisi? | Deskripsi | Jenis |
---|---|---|---|
Versi API | Wajib | Ini adalah versi API yang akan diperiksa. Versi saat ini adalah: api-version=2024-09-01. Contoh: <endpoint>/contentsafety/text:detectProtectedMaterial?api-version=2024-09-01 |
String |
Parameter dalam isi permintaan ditentukan dalam tabel ini:
Nama | Wajib diisi? | Deskripsi | Jenis |
---|---|---|---|
text | Wajib | Ini adalah teks mentah yang akan diperiksa. Karakter non-ascii lainnya dapat disertakan. | String |
Lihat contoh isi permintaan berikut:
{
"text": "string"
}
Buka jendela prompt perintah dan jalankan perintah cURL.
Menginterpretasikan respons API
Anda akan melihat hasil deteksi material yang dilindungi ditampilkan sebagai data JSON dalam output konsol. Contohnya:
{
"protectedMaterialAnalysis": {
"detected": true
}
}
Bidang JSON dalam output ditentukan di sini:
Nama | Deskripsi | Jenis |
---|---|---|
protectedMaterialAnalysis | Setiap kelas output yang diprediksi API. | String |
Terdeteksi | Apakah bahan yang dilindungi terdeteksi atau tidak. | Boolean |
Membersihkan sumber daya
Jika Anda ingin membersihkan dan menghapus langganan layanan Azure AI, Anda dapat menghapus sumber daya atau grup sumber daya. Menghapus grup sumber daya juga menghapus sumber daya apa pun yang terkait dengannya.
Konten terkait
- Konsep deteksi material yang dilindungi
- Konfigurasikan filter untuk setiap kategori dan uji pada himpunan data menggunakan Content Safety Studio, ekspor kode dan sebarkan.