Hızlı Başlangıç: Korumalı malzemeleri algılama (önizleme)

Makale
03/12/2024

Korumalı malzeme metni bilinen metin içeriğiyle eşleşen dili açıklar (örneğin, şarkı sözleri, makaleler, tarifler, seçili web içeriği). Bu özellik, bilinen metin içeriğinin dil modeli çıkışında görüntülenmesini (yalnızca İngilizce içerik) tanımlamak ve engellemek için kullanılabilir.

Önkoşullar

Azure aboneliği - Ücretsiz bir abonelik oluşturun
Azure aboneliğinizi aldıktan sonra anahtarınızı ve uç noktanızı almak için Azure portalında bir content Kasa ty kaynağı oluşturun. Kaynağınız için benzersiz bir ad girin, aboneliğinizi seçin ve bir kaynak grubu, desteklenen bölge (Doğu ABD veya Batı Avrupa) ve desteklenen fiyatlandırma katmanını seçin. Daha sonra, Oluştur'u seçin.
- Kaynağın dağıtılması birkaç dakika sürer. Tamamlandıktan sonra Kaynağa git'i seçin. Sol bölmedeki Kaynak Yönetimi'nin altında Abonelik Anahtarı ve Uç Nokta'yı seçin. Uç nokta ve anahtarlardan biri API'leri çağırmak için kullanılır.
cURL yüklü

Korumalı malzeme algılama için metni analiz etme

Aşağıdaki bölümde cURL ile örnek bir istekte yol gösterir. Aşağıdaki komutu bir metin düzenleyicisine yapıştırın ve aşağıdaki değişiklikleri yapın.

değerini kaynağınızla ilişkilendirilmiş uç nokta URL'si ile değiştirin <endpoint> .
değerini kaynağınızla birlikte gelen anahtarlardan biriyle değiştirin <your_subscription_key> .
İsteğe bağlı olarak, gövdedeki "text" alanı analiz etmek istediğiniz kendi metninizle değiştirin.

İpucu

Metin boyutu ve ayrıntı düzeyi

Metin gönderimleri için varsayılan uzunluk üst sınırı 1K karakterdir. En düşük uzunluk 111 karakterdir. Korumalı malzeme algılama, kullanıcı istemlerinde değil LLM tamamlamalarında çalıştırılacaktır.

curl --location --request POST '<endpoint>/contentsafety/text:detectProtectedMaterial?api-version=2023-10-15-preview' \
--header 'Ocp-Apim-Subscription-Key: <your_subscription_key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "text": "to everyone, the best things in life are free. the stars belong to everyone, they gleam there for you and me. the flowers in spring, the robins that sing, the sunbeams that shine, they\'re yours, they\'re mine. and love can come to everyone, the best things in life are"
}'

Url'ye aşağıdaki alanlar eklenmelidir:

Veri Akışı Adı	Zorunlu	Açıklama	Tür
API Sürümü	Zorunlu	Bu, denetlenecek API sürümüdür. Geçerli sürüm: api-version=2023-10-15-preview. Örnek: `<endpoint>/contentsafety/text:detectProtectedMaterial?api-version=2023-10-15-preview`	String

İstek gövdesindeki parametreler şu tabloda tanımlanmıştır:

Veri Akışı Adı	Zorunlu	Açıklama	Tür
text	Zorunlu	Bu, denetlenecek ham metindir. Diğer ascii olmayan karakterler eklenebilir.	String

Aşağıdaki örnek istek gövdesine bakın:

{
  "text": "string"
}

Bir komut istemi penceresi açın ve cURL komutunu çalıştırın.

API yanıtını yorumlama

Korumalı malzeme algılama sonuçlarının konsol çıkışında JSON verileri olarak görüntülendiğini görmeniz gerekir. Örneğin:

{
  "protectedMaterialAnalysis": {
    "detected": true
  }
}

Çıktıdaki JSON alanları burada tanımlanır:

Veri Akışı Adı	Açıklama	Tür
protectedMaterialAnalysis	API'nin tahmin yaptığı her çıkış sınıfı.	String
Algılandı	Korumalı malzemenin algılanıp algılanmadığı.	Boolean

Kaynakları temizleme

Azure AI hizmetleri aboneliğini temizlemek ve kaldırmak istiyorsanız, kaynağı veya kaynak grubunu silebilirsiniz. Kaynak grubunun silinmesi, kaynak grubuyla ilişkili diğer tüm kaynakları da siler.

Sonraki adımlar

Content Kasa ty Studio kullanarak her kategori için filtreleri yapılandırın ve veri kümelerinde test edin, kodu dışarı aktarın ve dağıtın.

content Kasa ty Studio hızlı başlangıcı

Share via