Dil hizmeti özelliklerini zaman uyumsuz olarak kullanma

  • Makale

Dil hizmeti, REST API 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 dil hizmeti özelliğini isteğinize ekleyebilirsiniz.

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

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

Zaman uyumsuz istekler gönderdiğinizde, her özellik kullanımı için isteğinize eklediğiniz metin kayıtlarının sayısına göre ücretlendirilirsiniz. Örneğin, yaklaşım analizi ve NER için bir metin kaydı gönderirseniz, bu iki metin kaydı gönderme olarak sayılır ve fiyatlandırma katmanınıza göre her ikisi için de ü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 , verileriniz üzerinde 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 URL, 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ı öğesine 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ığı andan itibaren 24 saat boyunca kullanılabilir ve yanıtta belirtilir. Bu sürenin sonunda 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 ayarlanaraklanguage, 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çüldükçe, 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 isteklerin 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 maksimum boyutu aşarsa hata 400 bad request döndürür.

Ayrıca bkz.