Dil hizmeti özelliklerini zaman uyumsuz olarak kullanma

  • Makale

Dil hizmeti, REST API'yi veya istemci kitaplığını kullanarak API isteklerini zaman uyumsuz olarak göndermenizi sağlar. Ayrıca, verileriniz üzerinde aynı anda gerçekleştirilecek birden çok farklı Dil hizmeti özelliğini de isteğinize ekleyebilirsiniz.

Şu anda aşağıdaki özellikler zaman uyumsuz olarak kullanılabilir:

  • Varlık bağlama
  • Belge özetleme
  • Konuşma özeti
  • Anahtar ifade ayıklama
  • Dil algılama
  • Adlandırılmış Varlık Tanıma (NER)
  • Müşteri içerik algılama
  • Yaklaşım analizi ve fikir madenciliği
  • Sistem durumu için Metin Analizi
  • Kişisel Bilgiler (PII)

Zaman uyumsuz istekler gönderdiğinizde, her özellik kullanımı için isteğinize eklediğiniz metin kaydı sayısına göre ücretlendirilirsiniz. Örneğin, yaklaşım analizi ve NER için bir metin kaydı gönderirseniz, bu kayıt iki metin kaydı gönderme olarak sayılır ve her ikisi için de fiyatlandırma katmanınıza göre ücretlendirilirsiniz.

REST API kullanarak zaman uyumsuz bir iş gönderme

Zaman uyumsuz bir iş göndermek için, isteğinizde göndereceğimiz JSON gövdesinin başvuru belgelerini gözden geçirin.

  1. Belgelerinizi nesneye analysisInput ekleyin.
  2. nesnesine tasks , verilerinizde gerçekleştirilmesini istediğiniz işlemleri ekleyin. Örneğin, yaklaşım analizi gerçekleştirmek istiyorsanız nesnesini dahil SentimentAnalysisLROTask edebilirsiniz.
  3. İsteğe bağlı olarak:
    1. Verilerinizde kullanılan modelin belirli bir sürümünü seçin.
    2. Verileriniz üzerinde aynı anda gerçekleştirilecek ek Dil hizmeti özelliklerini tasks nesnesine ekleyin.

İsteğiniz için JSON gövdesini oluşturduktan sonra anahtarınızı üst bilgisine Ocp-Apim-Subscription-Key ekleyin. Ardından API isteğinizi iş oluşturma uç noktasına gönderin. Örneğin:

POST https://your-endpoint.cognitiveservices.azure.com/language/analyze-text/jobs?api-version=2022-05-01

Başarılı bir çağrı bir 202 yanıt kodu döndürür. operation-location Yanıt üst bilgisindeki, API sonuçlarını almak için kullanacağınız URL olacaktır. Değer aşağıdaki URL'ye benzer olacaktır:

GET {Endpoint}/language/analyze-text/jobs/12345678-1234-1234-1234-12345678?api-version=2022-05-01

Durumu almak ve isteğin sonuçlarını almak için, önceki API yanıtından üst bilgide aldığınız URL'ye operation-location bir GET isteği gönderin. anahtarınızı bölümüne Ocp-Apim-Subscription-Keyeklemeyi unutmayın. Yanıt, API çağrınızın sonuçlarını içerir.

İstemci kitaplığını kullanarak zaman uyumsuz API istekleri gönderme

İlk olarak, tercih ettiğiniz dil için istemci kitaplığının yüklü olduğundan emin olun. İstemci kitaplığını yükleme adımları için, kullanmak istediğiniz özelliğin hızlı başlangıç makalesine bakın.

Daha sonra, API'ye zaman uyumsuz çağrılar göndermek için istemci nesnesini kullanın. Kullanılacak yöntem çağrıları dilinize bağlı olarak değişir. Kullanmaya başlamanıza yardımcı olması için kullanılabilir örnekleri ve başvuru belgelerini kullanın.

Sonuç kullanılabilirliği

Bu özelliği zaman uyumsuz olarak kullanırken, API sonuçları isteğin alındığı zamandan itibaren 24 saat boyunca kullanılabilir ve yanıtta belirtilir. Bu zaman aralığından sonra sonuçlar temizlenir ve artık alınamayacaktır.

Otomatik dil algılama

REST API sürümünden 2022-07-01-preview başlayarak, belgelerinizde otomatik dil algılama isteğinde bulunabilirsiniz. parametresi autoolarak language ayarlanarak, metnin algılanan dil kodu yanıtta bir dil değeri olarak döndürülür. Bu dil algılama, Dil kaynağınıza ek ücret uygulanmaz.

Veri sınırları

Not

  • Sınırın izin verdiğinden daha büyük belgeleri analiz etmeniz gerekiyorsa, api'ye göndermeden önce metni daha küçük metin öbeklerine bölebilirsiniz.
  • Belge, tek bir metin karakteri dizesidir.

StringInfo.LengthInTextElements tarafından ölçülen zaman uyumsuz istekte yer alan tüm belgelere en fazla 125.000 karakter gönderebilirsiniz. Bu karakter sınırı, daha yüksek aktarım hızı sağlamak için zaman uyumlu istek sınırından daha yüksektir.

Belge karakter sınırını aşarsa, API isteğin tamamını reddeder ve içindeki herhangi bir belge boyut üst sınırını aşarsa hata 400 bad request döndürür.

Ayrıca bkz.